Opcje protokołu HTTP (httpOptions)

Konfiguracja protokołu HTTP.

Nazwa	Typ	Wartość domyślna	Opis
AutoDecompression	wartość boolowska	true	Wskazuje, czy kanał HTTP automatycznie dekompresuje dane treści żądania przychodzącego.
DoNotAllowDuplicateSetCookies	string	false	Zapobiega wysłaniu przez kanał HTTP wielu nagłówków Set-Cookie o takiej samej nazwie.
MessageSizeLimit	long	-1	Ogranicza dopuszczalną wielkość komunikatu przychodzącego. Jeśli nadejdzie komunikat o wielkości przekraczającej tę wartość, do klienta zdalnego zostanie zwrócony błąd.
NoCacheCookiesControl	wartość boolowska	true	Umożliwia użytkownikowi wskazywanie, czy obecność nagłówka Set-Cookie powinna powodować aktualizowanie nagłówka Cache-Control przy użyciu wartości no-cache. To powoduje także dodanie nagłówka Expires.
ThrowIOEForInboundConnections	wartość boolowska		Decyduje o tym, czy kanał HTTP tworzy wyjątek we/wy, gdy połączenie przychodzące zostanie zamknięte, a jest nadal używane przez serwlet. Wartość domyślna jest ustawiana zgodnie ze skonfigurowanym składnikiem serwletu. W wersjach składnika Servlet wcześniejszych niż 4.0 wartością domyślną jest false. Począwszy od wersji Servlet 4.0 wartością domyślną jest true.
connectionWindowSize	int Minimum: 65535 Maksimum: 2147483647	65535	Określa wielkość okna w oktetach dla sterowania przepływem na poziomie połączenia HTTP/2. Tę wartość można skonfigurować do dowolnej wielkości w zakresie od 65535 do 2.147.483.647 oktetów włącznie. Jeśli nie zostanie podana żadna wartość, wartością domyślną jest 65535 oktetów.
decompressionRatioLimit	int Minimum: 1	200	Maksymalny stosunek objętości zdekompresowanego ładunku treści żądania do objętości ładunku skompresowanego. Kanał HTTP odczytuje treść żądania i weryfikuje stosunek podczas dekompresowania treści. Kanał przerywa dekompresję treści żądania, gdy współczynnik dekompresji utrzymuje się powyżej skonfigurowanej wartości i zostanie osiągnięta wartość decompressionTolerance.
decompressionTolerance	int Minimum: 0	3	Określa, ile razy kanał HTTP będzie tolerował współczynnik dekompresji przekraczający skonfigurowaną wartość, odzwierciedloną przez atrybut httpOption decompressionRatioLimit. Gdy ta liczba zostanie osiągnięta, a w następnym cyklu dekompresji współczynnik dekompresji nadal przekracza limit, kanał HTTP przestanie dekompresować treść żądania.
http2ConnectionIdleTimeout	Okres z dokładnością do sekundy	0	Określa czas (w sekundach), przez jaki połączenie HTTP/2 może pozostawać bezczynne między operacjami we/wy gniazda. Jeśli wartość nie zostanie określona lub zostanie ustawiona na 0, oznacza to, że nie ustawiono limitu czasu połączenia. Określ dodatnią liczbę całkowitą, po której następuje jednostka czasu, taka jak godziny (h), minuty (m) lub sekundy (s). Na przykład określ 30 sekund jako 30s. W pojedynczej pozycji można zawrzeć wiele wartości. Na przykład 1m30s oznacza 90 sekund.
id	string		Unikalny identyfikator konfiguracji.
ignoreWriteAfterCommit	wartość boolowska	false	Gdy ten atrybut ma wartość true, kanał HTTP ignoruje próby zapisu, jeśli wiadomość została już zatwierdzona. Jeśli jest ustawiona na false, co jest wartością domyślną, każda próba zapisu po zatwierdzeniu komunikatu skutkuje wyjątkiem MessageSentException.
incomingBodyBufferSize	int Minimum: 1024 Maksimum: 1048576	32768	Określa wielkość każdego buforu używanego przy odczytywaniu treści przychodzącego komunikatu protokołu HTTP.
keepAliveEnabled	wartość boolowska	true	Włącza połączenia trwałe (utrzymywanie aktywności połączenia HTTP). Wartość true oznacza, że utrzymywana jest aktywność połączeń na potrzeby ponownego wykorzystania przez wiele sekwencyjnych żądań i odpowiedzi. Wartość false oznacza, że połączenia są zamykane po wysłaniu odpowiedzi.
limitFieldSize	int Minimum: 50 Maksimum: 2147483647	32768	Wymuszenie ograniczenia wielkości w różnych polach HTTP, takich jak adresy URL żądań czy pojedyncze nazwy nagłówków lub wartości. Wymuszenie ograniczeń wielkości tych pól chroni przed możliwymi atakami polegającymi na spowodowaniu odmowy usługi (Denial of Service). Jeśli pole przekracza dozwoloną wielkość, do zdalnego klienta jest zwracany błąd.
limitNumHeaders	int Minimum: 50 Maksimum: 500	500	Ogranicza liczbę nagłówków HTTP, które mogą istnieć w komunikacie przychodzącym. Po przekroczeniu tego limitu do zdalnego klienta zwracany jest błąd.
limitWindowUpdateFrames	wartość boolowska	false	Określa, czy serwer oczekuje na wyczerpanie połowy okien na poziomie połączenia HTTP/2 i na poziomie strumienia, zanim wyśle ramki WINDOW_UPDATE. Poprawne wartości to true (prawda) lub false (fałsz). Jeśli nie zostanie podana żadna wartość, wartością domyślną jest false.
maxConcurrentStreams	int	100	Określa maksymalną liczbę strumieni, które mogą być aktywne w połączeniu HTTP/2 w danym momencie. Otwarcie strumieni przekraczających limit spowoduje zgłoszenie błędu REFUSED_STREAM (0x7). Jeśli nie zostanie określona, domyślna wartość współbieżnych strumieni zostanie ustawiona na 100.
maxFrameSize	int Minimum: 16384 Maksimum: 16777215	57344	Określa maksymalną dozwoloną wielkość ładunku ramki, która będzie ogłaszana przez serwer w ramce ustawień SETTINGS_MAX_FRAME_SIZE HTTP/2. Można skonfigurować dowolną wielkość w zakresie od 16 384 do 16 777 215 bajtów włącznie. Jeśli wartość nie zostanie określona, domyślnie zostanie ustawiona wartość 57 344 bajtów.
maxHeaderBlockSize	long Minimum: 0	512000	Określa maksymalną wielkość (w bajtach) bloku nagłówka pojedynczych strumieni HTTP2 . Jeśli ta wartość zostanie przekroczona, połączenie zostanie zamknięte z błędem. Ustaw ten parametr na 0, aby wyłączyć sprawdzanie.
maxKeepAliveRequests	int Minimum: -1	-1	Maksymalna liczba trwałych żądań dozwolonych w ramach jednego połączenia HTTP, gdy włączone są połączenia trwałe. Wartość -1 oznacza nieograniczoną liczbę. Ta opcja jest odpowiednia dla aplikacji wymagających niskich opóźnień i wysokiej przepustowości oraz połączeń SSL w sytuacjach, gdy nawiązanie nowego połączenia może być kosztowne.
maxResetFrames	int Minimum: 0	100	Określa maksymalną liczbę ramek resetowania na połączenie, które są dozwolone w oknie resetowania ramki. Jeśli ta wartość zostanie przekroczona, połączenie zostanie zamknięte. Ustaw ten parametr na 0, aby wyłączyć sprawdzanie.
maxStreamsRefused	int Minimum: 0	100	Określa maksymalną liczbę strumieni, które są odrzucane po osiągnięciu maksymalnego limitu współbieżnych strumieni. Jeśli ta wartość zostanie przekroczona, połączenie zostanie zamknięte. Ustaw ten parametr na 0, aby wyłączyć sprawdzanie.
persistTimeout	Okres z dokładnością do sekundy	30s	Czas, przez który gniazdo może pozostać bezczynne między żądaniami. To ustawienie obowiązuje jedynie w przypadku włączenia połączeń trwałych. Określ dodatnią liczbę całkowitą, po której następuje jednostka czasu, taka jak godziny (h), minuty (m) lub sekundy (s). Na przykład określ 30 sekund jako 30s. W pojedynczej pozycji można zawrzeć wiele wartości. Na przykład 1m30s oznacza 90 sekund.
readTimeout	Okres z dokładnością do sekundy	60s	Czas oczekiwania na zakończenie żądania odczytu w gnieździe po wystąpieniu pierwszego odczytu. Określ dodatnią liczbę całkowitą, po której następuje jednostka czasu, taka jak godziny (h), minuty (m) lub sekundy (s). Na przykład określ 30 sekund jako 30s. W pojedynczej pozycji można zawrzeć wiele wartości. Na przykład 1m30s oznacza 90 sekund.
removeServerHeader	wartość boolowska	false	Usuwa informacje o implementacji serwera z nagłówków HTTP.
resetFramesWindow	Okres z dokładnością do milisekundy	30s	Określa okno czasowe, podczas którego zerowane ramki są zliczane dla każdego połączenia. Ustaw ten parametr na 0 dla nieograniczonego okna czasowego. Określ dodatnią liczbę całkowitą, po której następuje jednostka czasu, taka jak godziny (h), minuty (m), sekundy (s) lub milisekundy (ms). Na przykład określ 500 milisekund jako 500ms. W pojedynczej pozycji można zawrzeć wiele wartości. Na przykład 1s500ms oznacza 1,5 sekundy.
settingsInitialWindowSize	int Minimum: 1 Maksimum: 2147483647	65535	Określa początkową wielkość okna w oktetach dla sterowania przepływem na poziomie strumienia HTTP/2. Tę wartość można skonfigurować do dowolnej wielkości w zakresie od 1 do 2.147.483.647 oktetów włącznie. Jeśli nie zostanie podana żadna wartość, wartością domyślną jest 65535 oktetów.
writeTimeout	Okres z dokładnością do sekundy	60s	Czas oczekiwania w gnieździe na przesłanie poszczególnych porcji danych odpowiedzi. Określ dodatnią liczbę całkowitą, po której następuje jednostka czasu, taka jak godziny (h), minuty (m) lub sekundy (s). Na przykład określ 30 sekund jako 30s. W pojedynczej pozycji można zawrzeć wiele wartości. Na przykład 1m30s oznacza 90 sekund.

Nazwa

Typ

Wartość domyślna

Opis

AutoDecompression

wartość boolowska

true

Wskazuje, czy kanał HTTP automatycznie dekompresuje dane treści żądania przychodzącego.

DoNotAllowDuplicateSetCookies

string

false

Zapobiega wysłaniu przez kanał HTTP wielu nagłówków Set-Cookie o takiej samej nazwie.

MessageSizeLimit

long

-1

Ogranicza dopuszczalną wielkość komunikatu przychodzącego. Jeśli nadejdzie komunikat o wielkości przekraczającej tę wartość, do klienta zdalnego zostanie zwrócony błąd.

NoCacheCookiesControl

wartość boolowska

true

Umożliwia użytkownikowi wskazywanie, czy obecność nagłówka Set-Cookie powinna powodować aktualizowanie nagłówka Cache-Control przy użyciu wartości no-cache. To powoduje także dodanie nagłówka Expires.

ThrowIOEForInboundConnections

wartość boolowska

Decyduje o tym, czy kanał HTTP tworzy wyjątek we/wy, gdy połączenie przychodzące zostanie zamknięte, a jest nadal używane przez serwlet. Wartość domyślna jest ustawiana zgodnie ze skonfigurowanym składnikiem serwletu. W wersjach składnika Servlet wcześniejszych niż 4.0 wartością domyślną jest false. Począwszy od wersji Servlet 4.0 wartością domyślną jest true.

connectionWindowSize

int
Minimum: 65535
Maksimum: 2147483647

65535

Określa wielkość okna w oktetach dla sterowania przepływem na poziomie połączenia HTTP/2. Tę wartość można skonfigurować do dowolnej wielkości w zakresie od 65535 do 2.147.483.647 oktetów włącznie. Jeśli nie zostanie podana żadna wartość, wartością domyślną jest 65535 oktetów.

decompressionRatioLimit

int
Minimum: 1

200

Maksymalny stosunek objętości zdekompresowanego ładunku treści żądania do objętości ładunku skompresowanego. Kanał HTTP odczytuje treść żądania i weryfikuje stosunek podczas dekompresowania treści. Kanał przerywa dekompresję treści żądania, gdy współczynnik dekompresji utrzymuje się powyżej skonfigurowanej wartości i zostanie osiągnięta wartość decompressionTolerance.

decompressionTolerance

int
Minimum: 0

Określa, ile razy kanał HTTP będzie tolerował współczynnik dekompresji przekraczający skonfigurowaną wartość, odzwierciedloną przez atrybut httpOption decompressionRatioLimit. Gdy ta liczba zostanie osiągnięta, a w następnym cyklu dekompresji współczynnik dekompresji nadal przekracza limit, kanał HTTP przestanie dekompresować treść żądania.

http2ConnectionIdleTimeout

Okres z dokładnością do sekundy

Określa czas (w sekundach), przez jaki połączenie HTTP/2 może pozostawać bezczynne między operacjami we/wy gniazda. Jeśli wartość nie zostanie określona lub zostanie ustawiona na 0, oznacza to, że nie ustawiono limitu czasu połączenia. Określ dodatnią liczbę całkowitą, po której następuje jednostka czasu, taka jak godziny (h), minuty (m) lub sekundy (s). Na przykład określ 30 sekund jako 30s. W pojedynczej pozycji można zawrzeć wiele wartości. Na przykład 1m30s oznacza 90 sekund.

string

Unikalny identyfikator konfiguracji.

ignoreWriteAfterCommit

wartość boolowska

false

Gdy ten atrybut ma wartość true, kanał HTTP ignoruje próby zapisu, jeśli wiadomość została już zatwierdzona. Jeśli jest ustawiona na false, co jest wartością domyślną, każda próba zapisu po zatwierdzeniu komunikatu skutkuje wyjątkiem MessageSentException.

incomingBodyBufferSize

int
Minimum: 1024
Maksimum: 1048576

32768

Określa wielkość każdego buforu używanego przy odczytywaniu treści przychodzącego komunikatu protokołu HTTP.

keepAliveEnabled

wartość boolowska

true

Włącza połączenia trwałe (utrzymywanie aktywności połączenia HTTP). Wartość true oznacza, że utrzymywana jest aktywność połączeń na potrzeby ponownego wykorzystania przez wiele sekwencyjnych żądań i odpowiedzi. Wartość false oznacza, że połączenia są zamykane po wysłaniu odpowiedzi.

limitFieldSize

int
Minimum: 50
Maksimum: 2147483647

32768

Wymuszenie ograniczenia wielkości w różnych polach HTTP, takich jak adresy URL żądań czy pojedyncze nazwy nagłówków lub wartości. Wymuszenie ograniczeń wielkości tych pól chroni przed możliwymi atakami polegającymi na spowodowaniu odmowy usługi (Denial of Service). Jeśli pole przekracza dozwoloną wielkość, do zdalnego klienta jest zwracany błąd.

limitNumHeaders

int
Minimum: 50
Maksimum: 500

500

Ogranicza liczbę nagłówków HTTP, które mogą istnieć w komunikacie przychodzącym. Po przekroczeniu tego limitu do zdalnego klienta zwracany jest błąd.

limitWindowUpdateFrames

wartość boolowska

false

Określa, czy serwer oczekuje na wyczerpanie połowy okien na poziomie połączenia HTTP/2 i na poziomie strumienia, zanim wyśle ramki WINDOW_UPDATE. Poprawne wartości to true (prawda) lub false (fałsz). Jeśli nie zostanie podana żadna wartość, wartością domyślną jest false.

maxConcurrentStreams

int

100

Określa maksymalną liczbę strumieni, które mogą być aktywne w połączeniu HTTP/2 w danym momencie. Otwarcie strumieni przekraczających limit spowoduje zgłoszenie błędu REFUSED_STREAM (0x7). Jeśli nie zostanie określona, domyślna wartość współbieżnych strumieni zostanie ustawiona na 100.

maxFrameSize

int
Minimum: 16384
Maksimum: 16777215

57344

Określa maksymalną dozwoloną wielkość ładunku ramki, która będzie ogłaszana przez serwer w ramce ustawień SETTINGS_MAX_FRAME_SIZE HTTP/2. Można skonfigurować dowolną wielkość w zakresie od 16 384 do 16 777 215 bajtów włącznie. Jeśli wartość nie zostanie określona, domyślnie zostanie ustawiona wartość 57 344 bajtów.

maxHeaderBlockSize

long
Minimum: 0

512000

Określa maksymalną wielkość (w bajtach) bloku nagłówka pojedynczych strumieni HTTP2 . Jeśli ta wartość zostanie przekroczona, połączenie zostanie zamknięte z błędem. Ustaw ten parametr na 0, aby wyłączyć sprawdzanie.

maxKeepAliveRequests

int
Minimum: -1

-1

Maksymalna liczba trwałych żądań dozwolonych w ramach jednego połączenia HTTP, gdy włączone są połączenia trwałe. Wartość -1 oznacza nieograniczoną liczbę. Ta opcja jest odpowiednia dla aplikacji wymagających niskich opóźnień i wysokiej przepustowości oraz połączeń SSL w sytuacjach, gdy nawiązanie nowego połączenia może być kosztowne.

maxResetFrames

int
Minimum: 0

100

Określa maksymalną liczbę ramek resetowania na połączenie, które są dozwolone w oknie resetowania ramki. Jeśli ta wartość zostanie przekroczona, połączenie zostanie zamknięte. Ustaw ten parametr na 0, aby wyłączyć sprawdzanie.

maxStreamsRefused

int
Minimum: 0

100

Określa maksymalną liczbę strumieni, które są odrzucane po osiągnięciu maksymalnego limitu współbieżnych strumieni. Jeśli ta wartość zostanie przekroczona, połączenie zostanie zamknięte. Ustaw ten parametr na 0, aby wyłączyć sprawdzanie.

persistTimeout

Okres z dokładnością do sekundy

30s

Czas, przez który gniazdo może pozostać bezczynne między żądaniami. To ustawienie obowiązuje jedynie w przypadku włączenia połączeń trwałych. Określ dodatnią liczbę całkowitą, po której następuje jednostka czasu, taka jak godziny (h), minuty (m) lub sekundy (s). Na przykład określ 30 sekund jako 30s. W pojedynczej pozycji można zawrzeć wiele wartości. Na przykład 1m30s oznacza 90 sekund.

readTimeout

Okres z dokładnością do sekundy

60s

Czas oczekiwania na zakończenie żądania odczytu w gnieździe po wystąpieniu pierwszego odczytu. Określ dodatnią liczbę całkowitą, po której następuje jednostka czasu, taka jak godziny (h), minuty (m) lub sekundy (s). Na przykład określ 30 sekund jako 30s. W pojedynczej pozycji można zawrzeć wiele wartości. Na przykład 1m30s oznacza 90 sekund.

removeServerHeader

wartość boolowska

false

Usuwa informacje o implementacji serwera z nagłówków HTTP.

resetFramesWindow

Okres z dokładnością do milisekundy

30s

Określa okno czasowe, podczas którego zerowane ramki są zliczane dla każdego połączenia. Ustaw ten parametr na 0 dla nieograniczonego okna czasowego. Określ dodatnią liczbę całkowitą, po której następuje jednostka czasu, taka jak godziny (h), minuty (m), sekundy (s) lub milisekundy (ms). Na przykład określ 500 milisekund jako 500ms. W pojedynczej pozycji można zawrzeć wiele wartości. Na przykład 1s500ms oznacza 1,5 sekundy.

settingsInitialWindowSize

int
Minimum: 1
Maksimum: 2147483647

65535

Określa początkową wielkość okna w oktetach dla sterowania przepływem na poziomie strumienia HTTP/2. Tę wartość można skonfigurować do dowolnej wielkości w zakresie od 1 do 2.147.483.647 oktetów włącznie. Jeśli nie zostanie podana żadna wartość, wartością domyślną jest 65535 oktetów.

writeTimeout

Okres z dokładnością do sekundy

60s

Czas oczekiwania w gnieździe na przesłanie poszczególnych porcji danych odpowiedzi. Określ dodatnią liczbę całkowitą, po której następuje jednostka czasu, taka jak godziny (h), minuty (m) lub sekundy (s). Na przykład określ 30 sekund jako 30s. W pojedynczej pozycji można zawrzeć wiele wartości. Na przykład 1m30s oznacza 90 sekund.