streamalism.org

1. Oversikt

Spring Boot-webapplikasjoner inkluderer som standard en forhåndskonfigurert, innebygd webserver. I noen situasjoner vil vi imidlertid endre standardkonfigurasjonen for å oppfylle tilpassede krav.

I denne opplæringen vil vi se på noen vanlige brukssaker for å konfigurere den innebygde Tomcat-serveren gjennom application.properties fil.

2. Vanlige innebygde Tomcat-konfigurasjoner

2.1. Serveradresse og port

Den vanligste konfigurasjonen vi kan ønske å endre er portnummeret:

server.port = 80

Hvis vi ikke gir server.port parameteren den er satt til 8080 som standard.

I noen tilfeller kan det være lurt å angi en nettverksadresse som serveren skal binde til. Med andre ord definerer vi en IP-adresse der serveren vår vil lytte:

server.address = my_custom_ip

Som standard er verdien satt til 0.0.0.0 som tillater tilkobling via alle IPv4-adresser. Angi en annen verdi, for eksempel localhost - 127.0.0.1 - vil gjøre serveren mer selektiv.

2.2. Feilhåndtering

Som standard har Spring Boot en standard feilwebside. Denne siden kalles Hvit etikett. Den er aktivert som standard, men hvis vi ikke vil vise noen feilinformasjon, kan vi deaktivere den:

server.error.whitelabel.enabled = false

Standard banen til a Hvit etikett er /feil. Vi kan tilpasse det ved å stille inn server.error.path parameter:

server.error.path = / brukerfeil

Vi kan også angi egenskaper som vil bestemme hvilken informasjon om feilen som presenteres. For eksempel kan vi inkludere feilmeldingen og stabelsporingen:

server.error.include-exception = true server.error.include-stacktrace = alltid

Våre opplæringsprogrammer Unntak meldingshåndtering for REST og tilpass Whitelabel Error Page forklarer mer om håndteringsfeil i Spring Boot.

2.3. Serverforbindelser

Når vi kjører på en container med lite ressurs, vil vi kanskje reduser CPU- og minnebelastningen. En måte å gjøre det på er å begrense antall samtidige forespørsler som kan håndteres av søknaden vår. Omvendt kan vi øke denne verdien for å bruke mer tilgjengelige ressurser for å få bedre ytelse.

I Spring Boot kan vi definere maksimalt antall Tomcat-arbeidstråder:

server.tomcat.max-threads = 200

Når du konfigurerer en webserver, kan det også være nyttig å angi tidsavbrudd for serverforbindelsen. Dette representerer den maksimale tiden serveren vil vente på at klienten skal komme med forespørselen etter tilkobling før tilkoblingen er avsluttet:

server.connection-timeout = 5s

Vi kan også definere den maksimale størrelsen på en forespørselstittel:

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

Maksimal størrelse på et forespørselsorgan:

server.tomcat.max-svelge-størrelse = 2 MB

Eller en maksimal størrelse på hele innleggsforespørselen:

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

2.4. SSL

For å aktivere SSL-støtte i vår Boot Boot-applikasjon må vi stille inn server.ssl.enabled eiendom til ekte og definere en SSL-protokoll:

server.ssl.enabled = true server.ssl.protocol = TLS

Vi bør også konfigurere passord, type og sti til nøkkelbutikken som inneholder sertifikatet:

server.ssl.key-store-password = my_password server.ssl.key-store-type = keystore_type server.ssl.key-store = keystore-path

Og vi må også definere aliaset som identifiserer nøkkelen vår i nøkkelbutikken:

server.ssl.key-alias = tomcat

For mer informasjon om SSL-konfigurasjon, besøk vår HTTPS ved hjelp av selvsignert sertifikat i Spring Boot-artikkelen.

2.5. Tomcat Server Access Logs

Tomcat-tilgangslogger er veldig nyttige når du prøver å måle antall treff på sider, brukerøkteaktivitet og så videre.

For å aktivere tilgangslogger, bare sett:

server.tomcat.accesslog.enabled = true

Vi bør også konfigurere andre parametere som katalognavn, prefiks, suffiks og datoformat som er lagt til loggfiler:

server.tomcat.accesslog.directory = logger server.tomcat.accesslog.file-date-format = åååå-MM-dd server.tomcat.accesslog.prefix = access_log server.tomcat.accesslog.suffix = .log

3. Konklusjon

I denne opplæringen har vi lært noen vanlige Tomcat innebygde serverkonfigurasjoner. Hvis du vil se flere mulige konfigurasjoner, kan du gå til den offisielle dokumentsiden for Spring Boot-applikasjonsegenskaper.

Som alltid er kildekoden for disse eksemplene tilgjengelig på GitHub.