logo

TechCodeview

Spring Boot – mukauta Whitelabel-virhesivua

Jos Spring Boot -ekosysteemissä ei ole mukautettua virhesivua tietyn virheen käsittelemiseksi, Spring Boot käsittelee virheen oletusarvoisesti Whitelabel-virhesivu.

Whitelabel_Error_Page



Tämä on oletusarvoinen Whitelabel-virhesivu. Voimme myös muokata tätä whitelabel-virhesivua. Tässä artikkelissa käsitellään joitakin lähestymistapoja tämän Whitelabel-virhesivun mukauttamiseen.

Huomautus: Voimme poistaa Whitelabel-virhesivun käytöstä asettamalla ominaisuuden server.error.whitelabel.enabled arvoon false.
server.error.whitelabel.enabled=false

IDE-asetukset projektille

Otetaan käyttöön IDE luomalla Spring Boot -projekti. Jos haluat luoda Spring Boot -projektin, siirry kohtaan Tiedosto-valikko > Uusi > muut > Kevään aloitusprojekti



springboot_starter_project_creation

Konfiguroi projekti tarpeidesi mukaan.

Huomautus: Tässä Java-versio 8, Maven-koontiversionhallintatyökalu ja Eclipse IDE Java- ja Web-kehittäjille 2023-06



spring_starter_projektin_ikkuna

Voimme myös lisätä seuraavat riippuvuudet yhdellä napsautuksella projektin asennuksen aikana.

Vaaditut riippuvuudet 

Spring Boot DevTools Thymeleaf Spring Web Services>

Ja kun olet lisännyt nämä riippuvuudet, napsauta ' suorittaa loppuun 'projekti luodaan.

adding_dependencies_in_spring_starter_project

Projektin asetukset sovellukselle

Vaihe 1: Lisää riippuvuuksia

Kun projekti on luotu, anna meidän määrittää pom.xml-tiedostomme (jos käytät Mavenia) lisäämällä tarvittavat riippuvuudet.

Spring-boot-starter-web-palvelut : HTTP-menetelmien ja päätepisteiden käsittelemiseen

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

spring-boot-starter-thymeleaf: Thymeleaf on mallimoottori ja antaa mallille jäsennellymmän muodon.

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

spring-boot-devtools: Se on valinnainen riippuvuus, mutta tarjoaa monia kehitystyökaluja ja ominaisuuksia sovellusten rakentamiseen.

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

Vaihe 2: Luo resurssit

Kun pom.xml-tiedosto on määritetty, luokaamme resurssit.

  • Siirry kohtaan ` src/main/resources `-kansioon projektirakenteessa. Luo sen sisään kansio nimeltä ` malleja ` tallentaaksesi HTML-malleja. Luo nyt mukautettu virhesivu, jossa on ` .html ` laajennus. Olen esimerkiksi nimennyt HTML-mallin nimellä ` error_page `.html.

package_explorer

estää youtube-mainokset Android
  • Kirjoita nyt mukautettu logiikkasi, jolla haluat ohittaa oletusarvoisen whitelabel-virhesivun.

error_page.html:

HTML




> <>html>>>> head>>>> <>title>>Errortitle> head>

Mukautettu virhesivuh1>

Jotain meni pieleen. Yritä myöhemmin uudelleen.p> body> html>>>

 

> 
    
 Spring Boot käyttää oletusarvoisesti `    application.properties    ` tai `    application.yml    `-tiedosto asettaaksesi sovelluksen ominaisuudet. Voimme ohittaa Spring Boot -sovelluksen oletuskäyttäytymisen lisäämällä ja määrittämällä näiden tiedostojen ominaisuudet koontiversion hallintatyökalun mukaan. Spring Boot käyttää oletusarvoisesti Whitelabel-virhesivua. Voit ohittaa tämän käyttäytymisen määrittämällä joitain ominaisuuksia. 
  • Kopioi ja liitä seuraavat ominaisuudet -kenttään    application.properties    ` (jos käytät Mavenia)
    •    
     
    //Tätä ominaisuutta käytetään osoittamaan mallimme polku          
        spring.mvc.view.prefix=/templates/    
     
    //Tätä ominaisuutta käytetään osoittamaan mallien laajennus tai tyyppi          
        spring.mvc.view.suffix=.html    
     
    //Tämän ominaisuuden arvoksi asetettu false osoittaa, että emme halua käyttää oletusarvoista whitelabel-virhesivua    server.error.whitelabel.enabled=false    
     
    //Tätä ominaisuutta käytetään virhesivumme polun määrittämiseen          
        server.error.path=/error    
     
     
    Vaihe 4: Controller-luokan luominen
     
    Luodaan projektiimme Controller-luokka. Voit tehdä sen siirtymällä projektimme oletuspakettiin. Luo alipaketti nimeltä `    ohjain    ` ja ohjainpaketin sisällä luo ohjainluokka. Olen esimerkiksi nimennyt ohjainluokan nimellä `    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'>;> >}> > }>  
          
     
        
     
    >
     
        
     
    >
     
     
    Selitys ohjainluokan luomiseen:
     
    Yllä olevassa koodissa ControllerClass toteuttaa `    ErrorController    ` tehdä virheitä. Luokassa olemme määrittäneet `    Käsittelijävirhe    `-menetelmä, johon on merkitty `    @GetMapping    ` määritetty päätepisteellä `    /virhe    ` ja palauttamalla mallin `    error_page    `.
     
    Hankkeen rakenne
     
    Varmista, että projektisi on seuraavassa projektirakenteessa.
     
     projektin_rakenne
     
    Sovelluksen suorittamisen vaiheet
     
    Suorittaaksesi sovelluksen,    napsauta projektia hiiren kakkospainikkeella    >    Juokse kuten    >    Spring Boot -sovellus.    
     
     springboot_application_run
     
    Mukautetun virhesivun tulos:
     
    Yritä antaa mikä tahansa polku, jota ei käsitellä ohjainluokassa. Se näyttää mukautetun virhesivun.
     
     custom_error_page