streamalism.org

1. Prehľad

Webové aplikácie Spring Boot obsahujú predvolene predkonfigurovaný zabudovaný webový server. V niektorých situáciách by sme však chceli upraviť predvolenú konfiguráciu na splnenie vlastných požiadaviek.

V tomto výučbe sa pozrieme na niekoľko bežných prípadov použitia na konfiguráciu zabudovaného servera Tomcat prostredníctvom servera application.properties spis.

2. Bežné vstavané konfigurácie Tomcat

2.1. Adresa a port servera

Najbežnejšia konfigurácia možno budeme chcieť zmeniť číslo portu:

server.port = 80

Ak neposkytneme Port servera parameter, na ktorý je nastavený 8080 predvolene.

V niektorých prípadoch môžeme chcieť nastaviť sieťovú adresu, na ktorú by sa mal server viazať. Inými slovami, definujeme IP adresa, na ktorej bude náš server počúvať:

server.adresa = moj_custom_ip

Predvolene je nastavená hodnota 0.0.0.0 ktorá umožňuje pripojenie cez všetky adresy IPv4. Nastavenie inej hodnoty, napríklad localhost - 127.0.0.1 - spôsobí, že server bude selektívnejší.

2.2. Spracovanie chyby

V predvolenom nastavení poskytuje Spring Boot štandardnú webovú stránku s chybou. Táto stránka sa nazýva Biely štítok. Je predvolene povolený, ale ak nechceme zobrazovať žiadne informácie o chybách, môžeme ich deaktivovať:

server.error.whitelabel.enabled = false

Predvolená cesta k a Biely štítok je /chyba. Môžeme to prispôsobiť nastavením server.error.path parameter:

server.error.path = / user-error

Môžeme tiež nastaviť vlastnosti, ktoré určia, ktoré informácie o chybe sa zobrazia. Napríklad môžeme zahrnúť chybové hlásenie a sledovanie zásobníka:

server.error.include-exception = true server.error.include-stacktrace = vždy

Naše výukové programy Spracovanie správ o výnimkách pre REST a prispôsobenie chybovej stránky prispôsobenia bielej značky vysvetľujú viac o spracovaní chýb v Spring Boot.

2.3. Pripojenia k serveru

Keď pracujeme na nízkozdrojovom kontajneri, mohlo by sa nám hodiť znížiť zaťaženie procesora a pamäte. Jedným zo spôsobov, ako to dosiahnuť, je obmedziť počet súčasných požiadaviek, ktoré môže naša aplikácia vybaviť. Naopak, túto hodnotu môžeme zvýšiť, aby sme využili viac dostupných zdrojov na dosiahnutie lepšieho výkonu.

V Spring Boot môžeme definovať maximálne množstvo pracovných vlákien Tomcat:

server.tomcat.max-threads = 200

Pri konfigurácii webového servera by to mohlo byť tiež užitočné nastaviť časový limit pripojenia k serveru. To predstavuje maximálnu dobu, po ktorú bude server čakať na vykonanie požiadavky klientom po pripojení pred jeho ukončením:

server.connection-timeout = 5 s

Môžeme tiež definovať maximálnu veľkosť hlavičky požiadavky:

server.max-http-header-size = 8 kB

Maximálna veľkosť tela žiadosti:

server.tomcat.max -allow-size = 2 MB

Alebo maximálna veľkosť celej žiadosti o príspevok:

server.tomcat.max-http-post-size = 2 MB

2.4. SSL

Povolenie podpory SSL v našej aplikácii Spring Boot musíme nastaviť server.ssl.povolené majetok do pravda a definujte protokol SSL:

server.ssl.enabled = skutočný server.ssl.protocol = TLS

Mali by sme tiež nakonfigurovať heslo, typ a cestu do skladu kľúčov, ktorý obsahuje certifikát:

server.ssl.key-store-password = moje_heslo server.ssl.key-store-type = typ_ úložiska kľúčov server.ssl.key-store = cesta-úložiska kľúčov

Musíme tiež definovať alias, ktorý identifikuje náš kľúč v úložisku kľúčov:

server.ssl.key-alias = kocúr

Ďalšie informácie o konfigurácii SSL nájdete v našom protokole HTTPS s použitím certifikátu s vlastným podpisom v článku Spring Boot.

2.5. Denník prístupu k serveru Tomcat

Protokoly prístupu Tomcat sú veľmi užitočné pri pokuse o meranie počtu prístupov na stránku, aktivity relácie používateľa atď.

Ak chcete povoliť protokoly prístupu, jednoducho nastaviť:

server.tomcat.accesslog.enabled = true

Mali by sme tiež nakonfigurovať ďalšie parametre, ako napríklad názov adresára, predponu, príponu a formát dátumu, ktoré sú pripojené k súborom denníka:

server.tomcat.accesslog.directory = prihlási server.tomcat.accesslog.file-date-format = rrrr-MM-dd server.tomcat.accesslog.prefix = access_log server.tomcat.accesslog.suffix = .log

3. Záver

V tomto tutoriáli sme sa naučili niekoľko bežných vecí Tomcat konfigurácie zabudovaného servera. Ak chcete zobraziť viac možných konfigurácií, navštívte oficiálnu stránku dokumentov vlastností aplikácie Spring Boot.

Zdrojový kód pre tieto príklady je ako vždy k dispozícii na stránkach GitHub.