logo

TechCodeview

Spring Boot – Personalizați pagina de eroare etichetă albă

În ecosistemul Spring Boot, când nu există o pagină de eroare personalizată care să gestioneze o anumită eroare, Spring Boot tratează implicit eroarea cu ajutorul Pagina de eroare etichetă albă.

Whitelabel_Error_Page



Aceasta este pagina implicită de eroare Whitelabel. De asemenea, putem personaliza această pagină de eroare cu etichetă albă. În acest articol, permiteți-ne să discutăm câteva abordări pentru a personaliza această pagină de eroare Whitelabel.

descărca video youtube vlc

Notă: Putem dezactiva pagina de eroare Whitelabel setând proprietatea server.error.whitelabel.enabled la false.
server.error.whitelabel.enabled=fals

Configurare IDE pentru proiect

Să ne instalăm IDE-ul creând proiectul Spring Boot. Pentru a crea un proiect Spring Boot, navigați la meniul Fișier > Nou > Alții > Proiect de primăvară



springboot_starter_project_creation

Configurați proiectul în funcție de cerințele dvs.

Notă: Aici, versiunea Java 8, instrumentul de gestionare a construcției Maven și IDE-ul Eclipse utilizate pentru Java și dezvoltatorii web 2023-06



spring_starter_project_window

Putem adăuga, de asemenea, următoarele dependențe într-un clic în timp ce configurați proiectul.

Dependențe necesare 

Spring Boot DevTools Thymeleaf Spring Web Services>

Și odată ce ați adăugat aceste dependențe, faceți clic pe „ finalizarea „proiectul va fi creat.

adding_dependencies_in_spring_starter_project

Configurarea proiectului pentru aplicație

Pasul 1: Adăugarea dependențelor

Odată ce proiectul este creat, permiteți-ne să configuram fișierul nostru pom.xml (dacă utilizați Maven) adăugând dependențele necesare.

Spring-boot-starter-servicii-web : Pentru a gestiona metodele HTTP și punctele finale

  org.springframework.boot  spring-boot-starter-web-services>

Spring-boot-starter-thymeleaf: Thymeleaf este un motor de șabloane și oferă un format mai structurat pentru șabloane.

  org.springframework.boot  spring-boot-starter-thymeleaf>

Spring-boot-devtools: Este o dependență opțională, dar oferă multe instrumente de dezvoltare și caracteristici pentru a construi aplicații.

  org.springframework.boot  spring-boot-devtools  runtime  true>

Pasul 2: Crearea resurselor

Odată ce fișierul pom.xml este configurat, să creăm resursele.

  • Navigați la ` src/main/resources ` folder în structura proiectului. În interiorul acestuia, creați un folder numit ` șabloane ` pentru a stoca șabloanele HTML. Acum, creați o pagină de eroare personalizată cu un ` .html ` extensie. De exemplu, am numit șablonul HTML ca ` eroare_page `.html.

pachet_explorator

  • Acum, scrieți logica personalizată cu care doriți să înlocuiți pagina de eroare implicită de etichetă albă.

error_page.html:

HTML




> <>html>>>>> head>>>>> <>title>>Titlu eroare> cap>

Pagina de eroare personalizatăh1>

Ceva n-a mers bine. Vă rugăm să încercați din nou mai târziu.p> body> html>>>

 

>

>

Pasul 3: Suprascrierea proprietăților implicite

  • În mod implicit, Spring Boot folosește ` aplicaţie.proprietăţi ` sau ` aplicație.yml ` pentru a seta proprietățile unei aplicații. Pentru a suprascrie orice comportament implicit al aplicației Spring Boot, putem adăuga și configura proprietățile din aceste fișiere în funcție de instrumentul dvs. de gestionare a versiunii. În mod implicit, Spring Boot utilizează pagina de eroare Whitelabel. Pentru a suprascrie acest comportament, permiteți-ne să configuram unele proprietăți.
  • Copiați și lipiți următoarele proprietăți în fișierul ` aplicație.proprietăți ` (dacă utilizați Maven)

//Această proprietate este folosită pentru a indica calea șablonului nostru
spring.mvc.view.prefix=/templates/

//Această proprietate este folosită pentru a indica extensia sau tipul șabloanelor
spring.mvc.view.sufx=.html

//Această proprietate setată la false indică faptul că nu dorim să folosim pagina de eroare implicită cu etichetă albă server.error.whitelabel.enabled=fals

//Această proprietate este folosită pentru a specifica calea paginii noastre de eroare
server.error.path=/error

Pasul 4: Crearea clasei Controller

Să creăm clasa Controller a proiectului nostru. Pentru a face acest lucru, navigați la pachetul implicit al proiectului nostru. Creați un sub-pachet numit ` controlor ` și în interiorul pachetului de controler creați clasa de controler. De exemplu, am numit clasa controlerului ca ` 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'>;> >}> > }> 

>

>

Explicație pentru crearea clasei de controler:

În codul de mai sus, ControllerClass implementează ` ErrorController ` pentru a reda erori. În clasă, am definit un ` handleError ` metoda care este adnotată cu ` @GetMapping ` specificat cu punctul final ` /eroare ` și returnând șablonul ` eroare_page `.

Structura proiectului

Asigurați-vă că proiectul dvs. se află în următoarea structură de proiect.

structură_proiect

Pași pentru rularea aplicației

Pentru a rula aplicația, faceți clic dreapta pe proiect > Fugi ca > Aplicația Spring Boot.

springboot_application_run

hrithik roshan

Ieșirea paginii de eroare personalizată:

Încercați să dați orice cale care nu este gestionată în clasa controlerului. Va afișa pagina de eroare personalizată.

custom_error_page