Pomladni zagon – prilagodite stran z napako Whitelabel
Če v ekosistemu Spring Boot ni strani z napako po meri za obravnavo določene napake, Spring Boot privzeto obravnava napako s pomočjo Stran z napako Whitelabel.
To je privzeta stran z napako Whitelabel. To stran z napako bele oznake lahko tudi prilagodimo. V tem članku bomo razpravljali o nekaterih pristopih za prilagoditev te strani z napako Whitelabel.
Opomba: Stran z napako Whitelabel lahko onemogočimo tako, da lastnost server.error.whitelabel.enabled nastavimo na false.
server.error.whitelabel.enabled=false
Nastavitev IDE za projekt
Nastavimo naš IDE tako, da ustvarimo projekt Spring Boot. Če želite ustvariti spomladanski zagonski projekt, se pomaknite do Meni Datoteka > Novo > drugi > Pomladni začetni projekt
Konfigurirajte projekt glede na vaše zahteve.
Opomba: Tukaj je Java različica 8, orodje za upravljanje gradnje Maven in Eclipse IDE, ki se uporabljata za Java in spletne razvijalce 2023-06
Naslednje odvisnosti lahko dodamo tudi z enim klikom med nastavljanjem projekta.
Zahtevane odvisnosti
Spring Boot DevTools Thymeleaf Spring Web Services
In ko dodate te odvisnosti, kliknite » končati ' projekt bo ustvarjen.
Nastavitev projekta za aplikacijo
1. korak: Dodajanje odvisnosti
Ko je projekt ustvarjen, konfigurirajmo našo datoteko pom.xml (če uporabljate Maven) z dodajanjem zahtevanih odvisnosti.
spring-boot-starter-web-storitve : Za obdelavo metod in končnih točk HTTP
org.springframework.boot spring-boot-starter-web-services
spring-boot-starter-thymeleaf: Thymeleaf je mehanizem predlog in ponuja bolj strukturiran format za predloge.
org.springframework.boot spring-boot-starter-thymeleaf
spring-boot-devtools: Je izbirna odvisnost, vendar ponuja številna razvojna orodja in funkcije za izdelavo aplikacij.
org.springframework.boot spring-boot-devtools runtime true
2. korak: Ustvarjanje virov
Ko je datoteka pom.xml konfigurirana, ustvarimo vire.
- Pomaknite se do ` src/main/resources ` v strukturi projekta. Znotraj tega ustvarite mapo z imenom ` predloge ` za shranjevanje predlog HTML. Zdaj ustvarite stran z napako po meri z ` .html ` razširitev. Na primer, predlogo HTML sem poimenoval kot ` napaka_stran `.html.
- Zdaj napišite svojo prilagojeno logiko, s katero želite preglasiti privzeto stran z napako belih oznak.
error_page.html:
HTML
> <> html> >> <> head> >> > <> title> >Napaka> glava> |
3. korak: preglasitev privzetih lastnosti
- Spring Boot privzeto uporablja ` aplikacija.lastnosti ` ali ` aplikacija.yml ` za nastavitev lastnosti aplikacije. Če želite preglasiti katero koli privzeto vedenje aplikacije Spring Boot, lahko dodamo in konfiguriramo lastnosti v teh datotekah glede na vaše orodje za upravljanje gradnje. Spring Boot privzeto uporablja stran z napako Whitelabel. Če želite preglasiti to vedenje, konfigurirajte nekaj lastnosti.
- Kopirajte in prilepite naslednje lastnosti v ` aplikacija.lastnosti ` (če uporabljate Maven)
//Ta lastnost se uporablja za označevanje poti naše predloge
spring.mvc.view.prefix=/templates///Ta lastnost se uporablja za označevanje razširitve ali vrste predlog
spring.mvc.view.suffix=.html//Ta lastnost, nastavljena na false, pomeni, da ne želimo uporabiti privzete strani z napako belih oznak server.error.whitelabel.enabled=false
//Ta lastnost se uporablja za določanje poti naše strani z napako
server.error.path=/napaka
4. korak: Ustvarjanje razreda krmilnika
Ustvarimo razred krmilnika našega projekta. Če želite to narediti, se pomaknite do privzetega paketa našega projekta. Ustvarite podpaket z imenom ` krmilnik ` in znotraj paketa krmilnika ustvarite razred krmilnika. Na primer, razred krmilnika sem poimenoval kot ` ControllerClass.java `.
Java
package> com.example.demo.controller;> > import> org.springframework.boot.web.servlet.error.ErrorController;> import> org.springframework.stereotype.Controller;> import> org.springframework.web.bind.annotation.GetMapping;> > @Controller> public> class> ControllerClass> implements> ErrorController {> > > @GetMapping> (> '/error'> )> > public> String handleError() {> > return> 'error_page'> ;> > }> > }> |
Razlaga za ustvarjanje razreda krmilnika:
V zgornji kodi naš ControllerClass implementira ` ErrorController ` za prikaz napak. V razredu smo definirali ` handleError ` metoda, ki je označena z ` @GetMapping ` določen s končno točko ` /napaka ` in vračanje predloge ` napaka_stran `.
Struktura projekta
Prepričajte se, da je vaš projekt v naslednji strukturi projekta.
Koraki za zagon aplikacije
Če želite zagnati aplikacijo, desni klik na projekt > Teci kot > Aplikacija Spring Boot.
Izpis strani z napakami po meri:
Poskusite dati katero koli pot, ki je ne obravnava razred krmilnika. Prikazala se bo stran z napako po meri.