logo

TechCodeview

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.

Whitelabel_Error_Page



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



springboot_starter_project_creation

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



spring_starter_project_window

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.

dodajanje_odvisnosti_in_spring_starter_project

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.

package_explorer

  • 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>

Stran z napakami po merih1>

Nekaj ​​je šlo narobe. Poskusite znova pozneje.p> body> html>>

 

>

>

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.

struktura_projekta

mreženje in vrste

Koraki za zagon aplikacije

Če želite zagnati aplikacijo, desni klik na projekt > Teci kot > Aplikacija Spring Boot.

springboot_application_run

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.

custom_error_page