Host wirtualny udostępnia grupę logiczną na potrzeby konfigurowania konkretnej nazwy hosta w aplikacjach WWW. W większości prostych konfiguracji odpowiednim ustawieniem jest domyślny host wirtualny (default_host).
Name | Type | Default | Description |
---|---|---|---|
id | łańcuch | Unikalny identyfikator konfiguracji. | |
enabled | boolean | true | Włącz ten host wirtualny. |
allowFromEndpointRef | Lista odwołań do elementów httpEndpoint najwyższego poziomu (łańcuch rozdzielany przecinkami). | Określ identyfikator jednego lub więcej punktów końcowych HTTP, aby ograniczyć ruch przychodzący tego hosta wirtualnego do określonych punktów końcowych. |
Powiąż host i port z tym hostem wirtualnym, używając składni host:port. Host może być określony jako adres IP, nazwa hosta serwera nazw domen (DNS) z przyrostkiem nazwy domeny, sama nazwa hosta serwera DNS lub jako znak wieloznaczny * umożliwiający dopasowanie wszystkich nazw hostów. Adresy IPv6 muszą być ujęte w nawiasy [].
Określ identyfikator jednego lub więcej punktów końcowych HTTP, aby ograniczyć ruch przychodzący tego hosta wirtualnego do określonych punktów końcowych.
Name | Type | Default | Description |
---|---|---|---|
id | łańcuch | Unikalny identyfikator konfiguracji. | |
onError |
| WARN | Działanie wykonywane po nieudanym uruchomieniu punktu końcowego. IGNORE Serwer nie będzie wysyłał żadnych ostrzeżeń ani komunikatów o błędach, gdy znajdzie błąd konfiguracji. WARN Serwer wyśle ostrzeżenie i komunikaty o błędach, gdy znajdzie błąd konfiguracji. FAIL Serwer wyśle ostrzeżenie lub komunikaty o błędach po pierwszym wystąpieniu błędu, a następnie serwer zostanie zatrzymany. |
enabled | boolean | true | Przełącz dostępność danego punktu końcowego. Wartość true oznacza, że dany punkt końcowy będzie aktywowany przez program rozsyłający do obsługi żądań HTTP. |
host | string | localhost | Adres IP, nazwa hosta serwera nazw domen (DNS) z przyrostkiem nazwy domeny lub po prostu nazwa hosta systemu DNS używana przez klient w żądaniach dotyczących zasobów. Użyj znaku gwiazdki (*) dla określenia wszystkich dostępnych interfejsów sieciowych. |
httpPort | int Min: -1 Max: 65535 | Port używany na potrzeby żądań HTTP klientów. Ustawienie wartości -1 umożliwia wyłączenie portu. | |
httpsPort | int Min: -1 Max: 65535 | Port używany na potrzeby żądań HTTP klientów zabezpieczonych przy użyciu protokołu SSL (HTTPS). Ustawienie wartości -1 umożliwia wyłączenie portu. | |
httpOptionsRef | Odwołanie do elementu httpOptions najwyższego poziomu (łańcuch). | defaultHttpOptions | Opcje protokołu HTTP dla tego punktu końcowego. |
sslOptionsRef | Odwołanie do elementu sslOptions najwyższego poziomu (łańcuch). | Opcje protokołu SSL dla tego punktu końcowego. | |
tcpOptionsRef | Odwołanie do elementu tcpOptions najwyższego poziomu (łańcuch). | defaultTCPOptions | Opcje protokołu TCP dla tego punktu końcowego. |
accessLoggingRef | Odwołanie do elementu httpAccessLogging najwyższego poziomu (łańcuch). | Konfiguracja rejestrowania dostępu HTTP dla punktu końcowego. |
allowFromEndpoint > httpOptions
Opcje protokołu HTTP dla tego punktu końcowego.
Name | Type | Default | Description |
---|---|---|---|
keepAliveEnabled | boolean | 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. |
maxKeepAliveRequests | int Min: -1 | 100 | 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ę. |
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. |
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. |
removeServerHeader | boolean | false | Usuwa informacje o implementacji serwera z nagłówków HTTP oraz wyłącza domyślną stronę powitania profilu Liberty. |
NoCacheCookiesControl | boolean | 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. |
AutoDecompression | boolean | true | Wskazuje, czy kanał HTTP automatycznie dekompresuje dane treści żądania przychodzącego. |
allowFromEndpoint > sslOptions
Opcje protokołu SSL dla tego punktu końcowego.
Name | Type | Default | Description |
---|---|---|---|
sessionTimeout | Okres z dokładnością do sekundy | 1d | Czas oczekiwania na zakończenie żądania odczytu lub zapisu w gnieździe. Ta wartość jest przesłaniana przez limity czasu specyficzne dla protokołu. 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. |
suppressHandshakeErrors | boolean | false | Wyłącz rejestrowanie błędów uzgadniania SSL. Błędy uzgadniania SSL mogą występować w czasie normalnego działania, jednak komunikaty mogą być pomocne, jeśli protokół SSL zachowuje się w sposób nieoczekiwany. |
sslRef | Odwołanie do elementu ssl najwyższego poziomu (łańcuch). | Domyślny repertuar konfiguracji SSL. Wartość domyślna to defaultSSLSettings. | |
sslSessionTimeout | Okres z dokładnością do milisekundy | 8640ms | Limit czasu sesji SSL, która jest nawiązana przez kanał SSL. 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. |
allowFromEndpoint > tcpOptions
Opcje protokołu TCP dla tego punktu końcowego.
Name | Type | Default | Description |
---|---|---|---|
inactivityTimeout | Okres z dokładnością do milisekundy | 60s | Czas oczekiwania na zakończenie żądania odczytu lub zapisu w gnieździe. Ta wartość jest przesłaniana przez limity czasu specyficzne dla protokołu. 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. |
soReuseAddr | boolean | true | Włącza natychmiastowe ponowne powiązanie z portem bez aktywnego programu nasłuchującego. |
addressIncludeList | string | Rozdzielana przecinkami lista adresów, które mogą nawiązywać połączenia przychodzące w tym punkcie końcowym. Można podać adres IPv4 lub IPv6. Wszystkie wartości w adresach typu IPv4 lub IPv6 muszą być reprezentowane przez liczbę lub znak wieloznaczny w postaci gwiazdki. | |
addressExcludeList | string | Rozdzielana przecinkami lista adresów, które nie mogą nawiązywać połączeń przychodzących w tym punkcie końcowym. Można podać adres IPv4 lub IPv6. Wszystkie wartości w adresach typu IPv4 lub IPv6 muszą być reprezentowane przez liczbę lub znak wieloznaczny w postaci gwiazdki. | |
hostNameIncludeList | string | Rozdzielana przecinkami lista nazw hostów, które mogą nawiązywać połączenia przychodzące w tym punkcie końcowym. Nazwy hostów mogą zaczynać się od gwiazdki (używanej jako znak wieloznaczny) i nie jest w nich rozróżniana wielkość liter. Jednak gwiazdki nie mogą występować w dowolnym miejscu nazwy hosta. Na przykład nazwa *.abc.com jest poprawna, ale nazwa *.abc.* jest niepoprawna. | |
hostNameExcludeList | string | Rozdzielana przecinkami lista nazw hostów, które nie mogą nawiązywać połączeń przychodzących w tym punkcie końcowym. Nazwy hostów mogą zaczynać się od gwiazdki (używanej jako znak wieloznaczny) i nie jest w nich rozróżniana wielkość liter. Jednak gwiazdki nie mogą występować w dowolnym miejscu nazwy hosta. Na przykład nazwa *.abc.com jest poprawna, ale nazwa *.abc.* jest niepoprawna. |
allowFromEndpoint > accessLogging
Konfiguracja rejestrowania dostępu HTTP dla punktu końcowego.
Name | Type | Default | Description |
---|---|---|---|
enabled | boolean | true | Włącza rejestrowanie dostępu. |
filePath | Ścieżka do pliku | ${server.output.dir}/logs/http_access.log | Ścieżka do katalogu i nazwa pliku dziennika dostępu. Określając ścieżkę do katalogu, można stosować standardowe podstawianie zmiennych, na przykład ${katalog.wyjściowy.serwera}. |
logFormat | string | %h %u %{t}W "%r" %s %b | Określa format dziennika stosowany przy rejestrowaniu informacji o dostępie klientów. |
maxFileSize | int Min: 0 | 20 | Maksymalna wielkość (w megabajtach) pliku dziennika przed jego zastąpieniem. Wartość 0 oznacza brak limitu. |
maxFiles | int Min: 0 | 2 | Maksymalna liczba przechowywanych plików dziennika, zanim najstarszy plik zostaje usunięty. Wartość 0 oznacza brak limitu. |