Opciones HTTP (httpOptions)

Configuración de protocolo HTTP.

Nombre	Tipo	Por omisión	Descripción
AutoDecompression	boolean	true	Especifica si el canal HTTP descomprime automáticamente los datos del cuerpo de solicitud entrantes.
DoNotAllowDuplicateSetCookies	string	false	Impide que el canal HTTP envíe varias cabeceras Set-Cookie con el mismo nombre.
MessageSizeLimit	long	-1	Limita el tamaño aceptable de un mensaje entrante. Si el mensaje llega con un tamaño mayor que este valor, se devuelve un mensaje al cliente remoto.
NoCacheCookiesControl	boolean	true	Permite al usuario controlar cuando se debe modificar la presencia de una cabecera Set-Cookie con un valor de no-cache coincidente. También se añade la cabecera Expires.
ThrowIOEForInboundConnections	boolean		Especifica si el canal HTTP crea una excepción de E/S cuando se cierra una conexión de entrada mientras el servlet todavía la está utilizando. El valor predeterminado se establece en función de la característica de servlet configurada. Antes de Servlet 4.0, el valor predeterminado es false; a partir de Servlet 4.0, el valor predeterminado es true.
connectionWindowSize	int Mín: 65535 Máx: 2147483647	65535	Especifica el tamaño de ventana en octetos para el control de flujo de nivel de conexión HTTP/2. Este valor se puede configurar en cualquier tamaño dentro del rango de 65.535 a 2.147.483.647 octetos, ambos incluidos. Si no se especifica ningún valor, el valor predeterminado es de 65.535 octetos.
decompressionRatioLimit	int Mín: 1	200	Especifica la proporción máxima de carga útil de cuerpo de solicitud descomprimido a comprimido. El canal HTTP lee el cuerpo de solicitud y verifica la proporción a medida que el cuerpo se descomprime. El canal detiene la descompresión del cuerpo de solicitud si la proporción de descompresión permanece por encima del valor configurado y se alcanza la tolerancia de descompresión.
decompressionTolerance	int Mín: 0	3	Especifica el número máximo de veces que el canal HTTP tolera una proporción de descompresión por encima de la proporción configurada, indicada por el atributo decompressionRatioLimit de httpOption. Si se alcanza este número y el siguiente ciclo de descompresión aún contiene una proporción de descompresión por encima del límite de proporción, el canal HTTP deja de descomprimir el cuerpo de solicitud.
http2ConnectionIdleTimeout	Un período de tiempo con precisión de segundos	0	Especifica la cantidad de tiempo, en segundos, que se permitirá que una conexión HTTP/2 permanezca inactiva entre operaciones de E/S de socket. Si no se especifica, o se establece en un valor de 0, no hay ningún tiempo de espera de conexión establecido. Especifica un entero positivo seguido de una unidad de tiempo, que puede ser horas (h), minutos (m) o segundos (s). Por ejemplo, especifique 30 segundos como 30s. Puede incluir varios valores en una sola entrada. Por ejemplo, 1m30s es equivalente a 90 segundos.
id	string		Un ID de configuración exclusivo.
incomingBodyBufferSize	int Mín: 1024 Máx: 1048576	32768	Especifica el tamaño de cada almacenamiento intermedio utilizado al leer el cuerpo de un mensaje HTTP entrante.
keepAliveEnabled	boolean	true	Habilita las conexiones persistentes (estado activo HTTP). Si tienen el valor true, las conexiones se mantendrán activas para ser reutilizadas por varias solicitudes y respuestas secuenciales. Si tienen el valor false, las conexiones se cierran después de enviarse la respuesta.
limitFieldSize	int Mín: 50 Máx: 2147483647	32768	Impone los límites de tamaño en diversos campos HTTP, como los URL de solicitud o nombres o valores de cabeceras individuales. Aplicar los límites de tamaño de estos campos impide posibles ataques de denegación de servicio. Se devuelve un error al cliente remoto, si un campo excede el tamaño permitido.
limitNumHeaders	int Mín: 50 Máx: 500	500	Limita el número de cabeceras HTTP que pueden existir en un mensaje entrante. Si se supera este límite, se devuelve un error al cliente remoto.
limitWindowUpdateFrames	boolean	false	Especifica si el servidor espera hasta agotar la mitad de las ventanas de nivel de conexión HTTP/2 y de nivel de secuencia antes de enviar tramas WINDOW_UPDATE. Los valores válidos son true o false. Si no se especifica ningún valor, el valor predeterminado es false.
maxConcurrentStreams	int	100	Especifica el número máximo de corrientes que una conexión HTTP/2 puede tener activas en cualquier punto determinado. La apertura de corrientes por encima del límite producirá un REFUSED_STREAM (0x7). Si no se especifica, el valor predeterminado de corrientes simultáneas se establecerá en 200.
maxFrameSize	int Mín: 16384 Máx: 16777215	57344	Especifica el tamaño máximo permitido de una carga útil de trama que el servidor anunciará en el trama de valores SETTINGS_MAX_FRAME_SIZE HTTP/2. Esto se puede configurar en cualquier tamaño dentro del rango de 16.384 a 16.777.215 bytes, inclusive. Si no se especifica, el valor predeterminado se establece en 57.344 bytes.
maxHeaderBlockSize	long Mín: 0	512000	Especifica el tamaño máximo en bytes para el bloque de cabecera de corrientes HTTP2 individuales. Si se supera este valor, la conexión se cierra con un error. Establezca este parámetro en 0 para inhabilitar la comprobación.
maxKeepAliveRequests	int Mín: -1	-1	Número máximo de solicitudes persistentes que se permiten en una única conexión HTTP si están habilitadas las conexiones persistentes. El valor -1 indica ilimitado. Esta opción admite aplicaciones de alto rendimiento o baja latencia y conexiones SSL para utilizarlas en situaciones donde la creación de una nueva conexión puede ser muy costosa.
maxResetFrames	int Mín: 0	100	Especifica el número máximo de marcos de restablecimiento por conexión que se permiten durante la ventana de marco de restablecimiento. Si se supera este valor, se cierra la conexión. Establezca este parámetro en 0 para inhabilitar la comprobación.
maxStreamsRefused	int Mín: 0	100	Especifica el número máximo de corrientes que se rechazan después de que se alcance el límite máximo de corrientes simultáneas. Si se supera este valor, se cierra la conexión. Establezca este parámetro en 0 para inhabilitar la comprobación.
persistTimeout	Un período de tiempo con precisión de segundos	30s	Cantidad de tiempo que un socket puede permanecer desocupado entre solicitudes. Este valor sólo se aplica si están habilitadas las conexiones persistentes. Especifica un entero positivo seguido de una unidad de tiempo, que puede ser horas (h), minutos (m) o segundos (s). Por ejemplo, especifique 30 segundos como 30s. Puede incluir varios valores en una sola entrada. Por ejemplo, 1m30s es equivalente a 90 segundos.
readTimeout	Un período de tiempo con precisión de segundos	60s	Cantidad de tiempo que se debe esperar en un socket hasta que se complete una solicitud de lectura después de la primera lectura. Especifica un entero positivo seguido de una unidad de tiempo, que puede ser horas (h), minutos (m) o segundos (s). Por ejemplo, especifique 30 segundos como 30s. Puede incluir varios valores en una sola entrada. Por ejemplo, 1m30s es equivalente a 90 segundos.
removeServerHeader	boolean	false	Elimina información de implementación del servidor de las cabeceras HTTP.
resetFramesWindow	Un período de tiempo con precisión de milisegundos	30s	Especifica la ventana de tiempo durante la cual se cuentan los marcos de restablecimiento en cada conexión. Establezca este parámetro en 0 para una ventana de tiempo ilimitada. Especifica un entero positivo seguido de una unidad de tiempo, que puede ser horas (h), minutos (m), segundos (s) o milisegundos (ms). Por ejemplo, especifique 500 milisegundos como 500ms. Puede incluir varios valores en una sola entrada. Por ejemplo, 1s500ms es equivalente a 1,5 segundos.
settingsInitialWindowSize	int Mín: 1 Máx: 2147483647	65535	Especifica el tamaño de ventana inicial en octetos para el control de flujo de nivel de secuencia HTTP/2. Este valor se puede configurar en cualquier tamaño dentro del rango de 1 a 2.147.483.647 octetos, ambos inclusive. Si no se especifica ningún valor, el valor predeterminado es de 65.535 octetos.
writeTimeout	Un período de tiempo con precisión de segundos	60s	Cantidad de tiempo que se debe esperar en un socket hasta que se transmita cada parte de los datos de respuesta. Especifica un entero positivo seguido de una unidad de tiempo, que puede ser horas (h), minutos (m) o segundos (s). Por ejemplo, especifique 30 segundos como 30s. Puede incluir varios valores en una sola entrada. Por ejemplo, 1m30s es equivalente a 90 segundos.

Nombre

Tipo

Por omisión

Descripción

AutoDecompression

boolean

true

Especifica si el canal HTTP descomprime automáticamente los datos del cuerpo de solicitud entrantes.

DoNotAllowDuplicateSetCookies

string

false

Impide que el canal HTTP envíe varias cabeceras Set-Cookie con el mismo nombre.

MessageSizeLimit

long

-1

Limita el tamaño aceptable de un mensaje entrante. Si el mensaje llega con un tamaño mayor que este valor, se devuelve un mensaje al cliente remoto.

NoCacheCookiesControl

boolean

true

Permite al usuario controlar cuando se debe modificar la presencia de una cabecera Set-Cookie con un valor de no-cache coincidente. También se añade la cabecera Expires.

ThrowIOEForInboundConnections

boolean

Especifica si el canal HTTP crea una excepción de E/S cuando se cierra una conexión de entrada mientras el servlet todavía la está utilizando. El valor predeterminado se establece en función de la característica de servlet configurada. Antes de Servlet 4.0, el valor predeterminado es false; a partir de Servlet 4.0, el valor predeterminado es true.

connectionWindowSize

int
Mín: 65535
Máx: 2147483647

65535

Especifica el tamaño de ventana en octetos para el control de flujo de nivel de conexión HTTP/2. Este valor se puede configurar en cualquier tamaño dentro del rango de 65.535 a 2.147.483.647 octetos, ambos incluidos. Si no se especifica ningún valor, el valor predeterminado es de 65.535 octetos.

decompressionRatioLimit

int
Mín: 1

200

Especifica la proporción máxima de carga útil de cuerpo de solicitud descomprimido a comprimido. El canal HTTP lee el cuerpo de solicitud y verifica la proporción a medida que el cuerpo se descomprime. El canal detiene la descompresión del cuerpo de solicitud si la proporción de descompresión permanece por encima del valor configurado y se alcanza la tolerancia de descompresión.

decompressionTolerance

int
Mín: 0

Especifica el número máximo de veces que el canal HTTP tolera una proporción de descompresión por encima de la proporción configurada, indicada por el atributo decompressionRatioLimit de httpOption. Si se alcanza este número y el siguiente ciclo de descompresión aún contiene una proporción de descompresión por encima del límite de proporción, el canal HTTP deja de descomprimir el cuerpo de solicitud.

http2ConnectionIdleTimeout

Un período de tiempo con precisión de segundos

Especifica la cantidad de tiempo, en segundos, que se permitirá que una conexión HTTP/2 permanezca inactiva entre operaciones de E/S de socket. Si no se especifica, o se establece en un valor de 0, no hay ningún tiempo de espera de conexión establecido. Especifica un entero positivo seguido de una unidad de tiempo, que puede ser horas (h), minutos (m) o segundos (s). Por ejemplo, especifique 30 segundos como 30s. Puede incluir varios valores en una sola entrada. Por ejemplo, 1m30s es equivalente a 90 segundos.

string

Un ID de configuración exclusivo.

incomingBodyBufferSize

int
Mín: 1024
Máx: 1048576

32768

Especifica el tamaño de cada almacenamiento intermedio utilizado al leer el cuerpo de un mensaje HTTP entrante.

keepAliveEnabled

boolean

true

Habilita las conexiones persistentes (estado activo HTTP). Si tienen el valor true, las conexiones se mantendrán activas para ser reutilizadas por varias solicitudes y respuestas secuenciales. Si tienen el valor false, las conexiones se cierran después de enviarse la respuesta.

limitFieldSize

int
Mín: 50
Máx: 2147483647

32768

Impone los límites de tamaño en diversos campos HTTP, como los URL de solicitud o nombres o valores de cabeceras individuales. Aplicar los límites de tamaño de estos campos impide posibles ataques de denegación de servicio. Se devuelve un error al cliente remoto, si un campo excede el tamaño permitido.

limitNumHeaders

int
Mín: 50
Máx: 500

500

Limita el número de cabeceras HTTP que pueden existir en un mensaje entrante. Si se supera este límite, se devuelve un error al cliente remoto.

limitWindowUpdateFrames

boolean

false

Especifica si el servidor espera hasta agotar la mitad de las ventanas de nivel de conexión HTTP/2 y de nivel de secuencia antes de enviar tramas WINDOW_UPDATE. Los valores válidos son true o false. Si no se especifica ningún valor, el valor predeterminado es false.

maxConcurrentStreams

int

100

Especifica el número máximo de corrientes que una conexión HTTP/2 puede tener activas en cualquier punto determinado. La apertura de corrientes por encima del límite producirá un REFUSED_STREAM (0x7). Si no se especifica, el valor predeterminado de corrientes simultáneas se establecerá en 200.

maxFrameSize

int
Mín: 16384
Máx: 16777215

57344

Especifica el tamaño máximo permitido de una carga útil de trama que el servidor anunciará en el trama de valores SETTINGS_MAX_FRAME_SIZE HTTP/2. Esto se puede configurar en cualquier tamaño dentro del rango de 16.384 a 16.777.215 bytes, inclusive. Si no se especifica, el valor predeterminado se establece en 57.344 bytes.

maxHeaderBlockSize

long
Mín: 0

512000

Especifica el tamaño máximo en bytes para el bloque de cabecera de corrientes HTTP2 individuales. Si se supera este valor, la conexión se cierra con un error. Establezca este parámetro en 0 para inhabilitar la comprobación.

maxKeepAliveRequests

int
Mín: -1

-1

Número máximo de solicitudes persistentes que se permiten en una única conexión HTTP si están habilitadas las conexiones persistentes. El valor -1 indica ilimitado. Esta opción admite aplicaciones de alto rendimiento o baja latencia y conexiones SSL para utilizarlas en situaciones donde la creación de una nueva conexión puede ser muy costosa.

maxResetFrames

int
Mín: 0

100

Especifica el número máximo de marcos de restablecimiento por conexión que se permiten durante la ventana de marco de restablecimiento. Si se supera este valor, se cierra la conexión. Establezca este parámetro en 0 para inhabilitar la comprobación.

maxStreamsRefused

int
Mín: 0

100

Especifica el número máximo de corrientes que se rechazan después de que se alcance el límite máximo de corrientes simultáneas. Si se supera este valor, se cierra la conexión. Establezca este parámetro en 0 para inhabilitar la comprobación.

persistTimeout

Un período de tiempo con precisión de segundos

30s

Cantidad de tiempo que un socket puede permanecer desocupado entre solicitudes. Este valor sólo se aplica si están habilitadas las conexiones persistentes. Especifica un entero positivo seguido de una unidad de tiempo, que puede ser horas (h), minutos (m) o segundos (s). Por ejemplo, especifique 30 segundos como 30s. Puede incluir varios valores en una sola entrada. Por ejemplo, 1m30s es equivalente a 90 segundos.

readTimeout

Un período de tiempo con precisión de segundos

60s

Cantidad de tiempo que se debe esperar en un socket hasta que se complete una solicitud de lectura después de la primera lectura. Especifica un entero positivo seguido de una unidad de tiempo, que puede ser horas (h), minutos (m) o segundos (s). Por ejemplo, especifique 30 segundos como 30s. Puede incluir varios valores en una sola entrada. Por ejemplo, 1m30s es equivalente a 90 segundos.

removeServerHeader

boolean

false

Elimina información de implementación del servidor de las cabeceras HTTP.

resetFramesWindow

Un período de tiempo con precisión de milisegundos

30s

Especifica la ventana de tiempo durante la cual se cuentan los marcos de restablecimiento en cada conexión. Establezca este parámetro en 0 para una ventana de tiempo ilimitada. Especifica un entero positivo seguido de una unidad de tiempo, que puede ser horas (h), minutos (m), segundos (s) o milisegundos (ms). Por ejemplo, especifique 500 milisegundos como 500ms. Puede incluir varios valores en una sola entrada. Por ejemplo, 1s500ms es equivalente a 1,5 segundos.

settingsInitialWindowSize

int
Mín: 1
Máx: 2147483647

65535

Especifica el tamaño de ventana inicial en octetos para el control de flujo de nivel de secuencia HTTP/2. Este valor se puede configurar en cualquier tamaño dentro del rango de 1 a 2.147.483.647 octetos, ambos inclusive. Si no se especifica ningún valor, el valor predeterminado es de 65.535 octetos.

writeTimeout

Un período de tiempo con precisión de segundos

60s

Cantidad de tiempo que se debe esperar en un socket hasta que se transmita cada parte de los datos de respuesta. Especifica un entero positivo seguido de una unidad de tiempo, que puede ser horas (h), minutos (m) o segundos (s). Por ejemplo, especifique 30 segundos como 30s. Puede incluir varios valores en una sola entrada. Por ejemplo, 1m30s es equivalente a 90 segundos.