springboot之旅第四篇-web開發

来源:https://www.cnblogs.com/yuanqinnan/archive/2019/04/14/10708043.html
-Advertisement-
Play Games

一、引言 有了自動配置,springboot使web開發變得簡單,這個在springboot之旅中的第一篇中就有體現,實際的開發中當然不會這麼簡單,很多時候我們都需要自己去定製一些東西。web開發的東西比較多, 我們先掌握一些必要知識點,剩下的就是CRUD開發。 快速的創建一個springboot ...


一、引言

有了自動配置,springboot使web開發變得簡單,這個在springboot之旅中的第一篇中就有體現,實際的開發中當然不會這麼簡單,很多時候我們都需要自己去定製一些東西。web開發的東西比較多, 我們先掌握一些必要知識點,剩下的就是CRUD開發。

快速的創建一個springboot web項目在第一篇總結中有講:https://www.cnblogs.com/yuanqinnan/p/10604761.html

二、靜態資源的映射規則

現在大部分公司都是前後端分離的開發模式,一般作為後臺開發不用關心前端,只需要提供相應介面,但是有關前端的知識我們最好還是能基本掌握一些。我們先了一套bootstrap框架,然後開始進行開發。

在之前的web開發中,在main目錄下麵會有webapp文件夾,我們將所有的靜態資源放在裡面,但是springboot的預設生成中並沒有這個文件夾,那麼springboot是怎麼映射靜態資源。

ctrl+N快捷鍵,找到WebMvcAutoConfiguration類,再找到裡面的addResourceHandlers 方法

public void addResourceHandlers(ResourceHandlerRegistry registry) {
   if (!this.resourceProperties.isAddMappings()) {
      logger.debug("Default resource handling disabled");
      return;
   }
   Duration cachePeriod = this.resourceProperties.getCache().getPeriod();
   CacheControl cacheControl = this.resourceProperties.getCache()
         .getCachecontrol().toHttpCacheControl();
   //webjar形式
   if (!registry.hasMappingForPattern("/webjars/**")) {
      customizeResourceHandlerRegistration(registry
            .addResourceHandler("/webjars/**")
            .addResourceLocations("classpath:/META-INF/resources/webjars/")
            .setCachePeriod(getSeconds(cachePeriod))
            .setCacheControl(cacheControl));
   }
    //匹配/**
   String staticPathPattern = this.mvcProperties.getStaticPathPattern();
   if (!registry.hasMappingForPattern(staticPathPattern)) {
      customizeResourceHandlerRegistration(
            registry.addResourceHandler(staticPathPattern)
                  .addResourceLocations(getResourceLocations(
                      //映射的資源文件夾
                        this.resourceProperties.getStaticLocations()))
                  .setCachePeriod(getSeconds(cachePeriod))
                  .setCacheControl(cacheControl));
   }
}

2.1 webjars

這裡的代碼告訴我們:如果是訪問/webjars/**下的請求 ,都去 classpath:/META-INF/resources/webjars/ 找資源。webjars是指以jar包的方式引入靜態資源。打開https://www.webjars.org/ ,可以找到我們前端開發常用的一些組件,我們選擇相應的版本,例:

 

<dependency>
  <groupId>org.webjars</groupId>
  <artifactId>jquery</artifactId>
  <version>3.3.1-1</version>
</dependency>

引入後可以看到jquer文件被引入了:

如果順利的話,此時訪問http://localhost:8080/webjars/jquery/3.3.1-1/jquery.js可以得到文件,結果如下:

2.2 自己的靜態文件

另外當訪問當前項目的任何資源,都去(靜態資源的文件夾)找映射,資源文件夾是一個數組,包括:

"classpath:/META-INF/resources/", "classpath:/resources/","classpath:/static/", "classpath:/public/" ,

"/":當前項目的根路徑。只要將靜態文件放入其中,那麼springboot就能找到。

2.3 首頁

在訪問"/**",會去找靜態資源文件夾下的所有index.html頁面。

2.4 圖標

所有的 **/訪問都是靜態資源文件下找favicon.ico。

我們將一些靜態文件放在static下,並將index.html放入public文件夾下,如圖:

訪問http://localhost:8080/index.html ,可得到正確返回

三、模板引擎

模板引擎有很多,如JSP、Velocity、Freemarker、Thymeleaf,springboot推薦的是Thymeleaf,那我們就來簡單看看Thymeleaf語法。導入starter:

<dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-thymeleaf</artifactId>
</dependency>

進入之後可以看到預設版本,我們也可以改成自己需要的版本。

<thymeleaf.version>3.0.9.RELEASE</thymeleaf.version>
<!-- 佈局功能的支持程式  thymeleaf3主程式  layout2以上版本 -->
<!-- thymeleaf2   layout1-->
<thymeleaf-layout-dialect.version>2.2.2</thymeleaf-layout-dialect.version>

3.1 Thymeleaf使用

通過源碼我們知道,只要我們把HTML頁面放在classpath:/templates/,thymeleaf就能自動渲染

@ConfigurationProperties(prefix = "spring.thymeleaf")
public class ThymeleafProperties {
private static final Charset DEFAULT_ENCODING = Charset.forName("UTF-8");
private static final MimeType DEFAULT_CONTENT_TYPE = MimeType.valueOf("text/html");
public static final String DEFAULT_PREFIX = "classpath:/templates/";
public static final String DEFAULT_SUFFIX = ".html";

我們可以去官網查看教程,這裡只是簡單的進行介紹,主要步驟

第一步:導入命名空間,導入之後會有相應提示

<html lang="en" xmlns:th="http://www.thymeleaf.org">

第二步:使用語法

<!DOCTYPE html>
<html lang="en" xmlns:th="http://www.thymeleaf.org">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
<h1>成功!</h1>
  <!--th:text 將div裡面的文本內容設置為 -->
<div><th th:text="${hello}"></th>這是顯示歡迎信息</div>
</body>
</html>

更具體的使用方法,可以去查看官網教程,這種如果沒有使用到的話不建議花太多時間去學,很多公司都是前後端分離,即使不是前後端分離,也有很多前端框架給我們使用。這些可以再我們使用的時候再去學習,速度也是很快的。

四、SpringMVC自動配置

4.1 自動配置

springboot預設將為我們配置如下一些SpringMvc的必要組件:

  1. 必要的ViewResolver(視圖解析器:根據方法的返回值得到視圖對象(View)),如ContentNegotiatingViewResolver和BeanNameViewResolver

  2. 將必要的Converter, GenericConverter, Formatter 等bean註冊到ioc容器中。

  3. 添加了一系列的HttpMessageConverters以便支持對web請求和相應的類型轉換。

  4. 自動配置和註冊MessageCodesResolver

任何時候,我們對預設提供的組件設定不滿意,都可以註冊新的同類型的bean定義來替換,web的所有自動場景都在org.springframework.boot.autoconfigure.web包中,我們可以參照進行配置。

當然完全靠自動配置在實際開發時不夠的,我們經常需要自己配置一些東西,比如攔截器,視圖映射規則。

4.2 擴展配置

在sprinboot2.0之前 配置類繼承WebMvcConfigurerAdapter,但是現在這個方法已經過時,現在可以使用兩種方式,繼承WebMvcConfigurer介面或者繼承WebMvcConfigurationSupport類,推薦使用的是WebMvcConfigurationSupport。

@Configuration
public class WebConfig implements WebMvcConfigurer {

    @Override
    public void addViewControllers(ViewControllerRegistry registry) {
        registry.addViewController("/yuan").setViewName("success");
    }
}

這段代碼就實現了自定義的視圖映射。上面這種寫法使SpringMVC的自動配置和我們的擴展配置都會起作用

我們甚至可以全面接管springmvc,只要在配置類中增加@EnableWebMv註解,這樣所有的SpringMVC的自動配置都失效了。當然,一般情況下我們不會這麼做。

五、登陸

web系統一般少不了登錄頁面,我們先設定預設頁面為登錄頁。

registry.addViewController("/").setViewName("login");
registry.addViewController("/index.html").setViewName("login");

5.1 登錄方法

具體登錄html的代碼就不貼了,可以下載源碼查看,新建controller

@Controller
public class LoginController {

    @PostMapping(value = "/user/login")
    public String login(@RequestParam("username") String username,
                        @RequestParam("password") String password,
                        Map<String,Object> map, HttpSession httpSession){
        if(!StringUtils.isEmpty(username)&&
        "123456".equals(password)){
             //設置session
             httpSession.setAttribute("loginUser",username);
            //重定向到主頁
            return "redirect:/main.html";
        }else {
            map.put("msg","用戶名密碼錯誤");
            return "login";
        }
    }
}

5.2 登錄攔截器

登錄操作完成之後,為了對每個頁面進行登錄驗證,我們還需要設置登錄攔截器。先創建登錄攔截器

@Component
public class LoginHandlerInterceptor implements HandlerInterceptor {

    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
        Object user = request.getSession().getAttribute("loginUser");
        if(user == null){
            //未登陸,返回登陸頁面
            request.setAttribute("msg","沒有許可權請先登陸");
            request.getRequestDispatcher("/index.html").forward(request,response);
            return false;
        }else{
            //已登陸,放行請求
            return true;
        }
    }
}

 

然後再加入配置

@Configuration
public class WebConfig implements WebMvcConfigurer {
    @Autowired
    private LoginHandlerInterceptor loginHandlerInterceptor;
    
    public void addInterceptors(InterceptorRegistry registry) {
        registry.addInterceptor(loginHandlerInterceptor).addPathPatterns("/**")
                .excludePathPatterns("/index.html","/","/user/login");
    }
 }

這樣在訪問其他頁面時都會進行登錄攔截操作

六、錯誤處理機制

在進行開發時,錯誤處理是非常重要的,不管是直接顯示給用戶,或者返回給前端,都需要儘量友好和清晰。

6.1 預設的錯誤處理機制

springboot有自身的預設錯誤處理機制,分為兩種

第一種:瀏覽器,瀏覽器會返回一個預設的錯誤頁面,如:

第二種:客戶端,客戶端預設返回的是一個響應一個json數據

如果我們用postman訪問,則返回:

6.2 定製錯誤響應

定製錯誤響應也分為兩種,一種是定製錯誤頁面,第二種是定製錯誤json數據。

6.2.1 定製錯誤頁面

如果我們想要展示更加詳細的信息,就將頁面放在模板引擎文件夾下,路徑名為 error/狀態碼,【將錯誤頁面命名為錯誤狀態碼.html 放在模板引擎文件夾裡面的 error文件夾下】,發生此狀態碼的錯誤就會來到 對應的頁面。在這個頁面我們可以獲取到一些錯誤信息,如:

  • timestamp:時間戳

  • status:狀態碼

  • error:錯誤提示

  • exception:異常對象

  • message:異常消息

  • errors:JSR303數據校驗的錯誤都在這裡

我們可以根據這些錯誤信息來展示錯誤,一般不需要這麼做,拋出的錯誤不應該讓用戶去分析,我們只需要返回靜態頁面即可,返回錯誤靜態頁面是做法也是一樣的,只是我們不用將文件放在模板引擎文件夾下。

6.2.2 定製錯誤的json數據

在實際的開發中我們會對我們的錯誤碼進行規範處理,根據錯誤會返回相應的錯誤碼,所以我們會自己進行json數據包裝處理。

@ControllerAdvice
public class GlobalDefaultExceptionHandler {

    @ExceptionHandler(value = RequestException.class)
    public String requestExceptionHandler(RequestException e,HttpServletRequest request){
        Map<String,Object> map = new HashMap<>();
        //傳入我們自己的錯誤狀態碼  4xx 5xx,否則就不會進入定製錯誤頁面的解析流程
        request.setAttribute("javax.servlet.error.status_code",500);
        map.put("code","user.notexist");
        map.put("message",e.getMessage());
        //轉發到/error
        return "forward:/error";
    }
}

以上是我們在web開發需要先掌握的一些基本技術,有了這些基本知識之後,我們就可以進行CRUD開發,當然在實際的開發中,不管是登錄攔截還是錯誤處理都比這個要複雜,我們以後再詳講。

 

 


您的分享是我們最大的動力!

-Advertisement-
Play Games
更多相關文章
  • [TOC] 介紹 通過本項目能夠更直觀地理解應用層和運輸層網路協議, 以及繼承封裝多態的運用. 網路部分是本文敘述的重點, 你將看到如何使用Java建立TCP和UDP連接並交換報文, 你還將看到如何自己定義一個簡單的應用層協議來讓自己應用進行網路通信. "獲取源碼" 基礎版本 游戲的原理, 圖形界面 ...
  • 9、REINDEX API Reindex要求為源索引中的所有文檔啟用_source。 不會配置目標索引,不會複製源索引的設置。你需要在reindex之前先指定 ,分片數量,副本數量等選項。 最常用的一種方式是複製一個索引。下例會將twitter索引中的文檔複製到new_twitter索引中: 返回 ...
  • 我們今天繼續學習一下Numpy庫 接著前面幾次講的,Numpy中還有一些標準運算 exp表示求e的冪次方,比如上面看到的,e的0次方為1,e的2次方,2.7幾,以此類推 我們可以看到,exp就是求e的多少次方 而sqrt則表示根號,也就是進行開方運算 我們可以得到,0的開方為0,1 的開方為1,2的 ...
  • 靜態語言(C/C++、Java);腳本語言(python、JavaScript、PHP) IPO(Input、Process、Output) #:python中的註釋符號;‘’‘ ’‘’:多行註釋 python的35個保留字 數據類型:字元串、整數、浮點數、列表 整數類型:10011101 字元串類 ...
  • 上次使用了BeautifulSoup庫爬取電影排行榜,爬取相對來說有點麻煩,爬取的速度也較慢。本次使用的lxml庫,我個人是最喜歡的,爬取的語法很簡單,爬取速度也快。 本次爬取的豆瓣書籍排行榜的首頁地址是: https://www.douban.com/doulist/1264675/?start= ...
  • 新聞 "Hedgehog新站點" "Bolero 0.4發佈,增加遠程認證" "FsToolkit.ErrorHandling與Cvdm.ErrorHandling合併了" "F 里的3D圖形編程與游戲開發" "有趣的3D——瀏覽器里F 3D繪製" "F CNTK:變分自動編碼器例子——從2D隱空間 ...
  • 閱讀目錄 一、迭代器 1、迭代的概念 #迭代器即迭代的工具,那什麼是迭代呢? #迭代是一個重覆的過程,每次重覆即一次迭代,並且每次迭代的結果都是下一次迭代的初始值 代碼如下: 2、為何要用迭代器?什麼是可迭代對象?什麼是迭代器對象? 3、迭代器對象的使用 4、for迴圈 5、迭代器的優缺點 ...
  • 8、Bulk API 可以把多個 或`delete bulk API`中執行。這樣可以極大地提高索引速度。 API使用如下的JSON結構: 註意,最後一行數據必須要以 結尾。發送請求時,Content Type 標頭應設置為 application /x ndjson。 可以是 ,`create d ...
一周排行
    -Advertisement-
    Play Games
  • 移動開發(一):使用.NET MAUI開發第一個安卓APP 對於工作多年的C#程式員來說,近來想嘗試開發一款安卓APP,考慮了很久最終選擇使用.NET MAUI這個微軟官方的框架來嘗試體驗開發安卓APP,畢竟是使用Visual Studio開發工具,使用起來也比較的順手,結合微軟官方的教程進行了安卓 ...
  • 前言 QuestPDF 是一個開源 .NET 庫,用於生成 PDF 文檔。使用了C# Fluent API方式可簡化開發、減少錯誤並提高工作效率。利用它可以輕鬆生成 PDF 報告、發票、導出文件等。 項目介紹 QuestPDF 是一個革命性的開源 .NET 庫,它徹底改變了我們生成 PDF 文檔的方 ...
  • 項目地址 項目後端地址: https://github.com/ZyPLJ/ZYTteeHole 項目前端頁面地址: ZyPLJ/TreeHoleVue (github.com) https://github.com/ZyPLJ/TreeHoleVue 目前項目測試訪問地址: http://tree ...
  • 話不多說,直接開乾 一.下載 1.官方鏈接下載: https://www.microsoft.com/zh-cn/sql-server/sql-server-downloads 2.在下載目錄中找到下麵這個小的安裝包 SQL2022-SSEI-Dev.exe,運行開始下載SQL server; 二. ...
  • 前言 隨著物聯網(IoT)技術的迅猛發展,MQTT(消息隊列遙測傳輸)協議憑藉其輕量級和高效性,已成為眾多物聯網應用的首選通信標準。 MQTTnet 作為一個高性能的 .NET 開源庫,為 .NET 平臺上的 MQTT 客戶端與伺服器開發提供了強大的支持。 本文將全面介紹 MQTTnet 的核心功能 ...
  • Serilog支持多種接收器用於日誌存儲,增強器用於添加屬性,LogContext管理動態屬性,支持多種輸出格式包括純文本、JSON及ExpressionTemplate。還提供了自定義格式化選項,適用於不同需求。 ...
  • 目錄簡介獲取 HTML 文檔解析 HTML 文檔測試參考文章 簡介 動態內容網站使用 JavaScript 腳本動態檢索和渲染數據,爬取信息時需要模擬瀏覽器行為,否則獲取到的源碼基本是空的。 本文使用的爬取步驟如下: 使用 Selenium 獲取渲染後的 HTML 文檔 使用 HtmlAgility ...
  • 1.前言 什麼是熱更新 游戲或者軟體更新時,無需重新下載客戶端進行安裝,而是在應用程式啟動的情況下,在內部進行資源或者代碼更新 Unity目前常用熱更新解決方案 HybridCLR,Xlua,ILRuntime等 Unity目前常用資源管理解決方案 AssetBundles,Addressable, ...
  • 本文章主要是在C# ASP.NET Core Web API框架實現向手機發送驗證碼簡訊功能。這裡我選擇是一個互億無線簡訊驗證碼平臺,其實像阿裡雲,騰訊雲上面也可以。 首先我們先去 互億無線 https://www.ihuyi.com/api/sms.html 去註冊一個賬號 註冊完成賬號後,它會送 ...
  • 通過以下方式可以高效,並保證數據同步的可靠性 1.API設計 使用RESTful設計,確保API端點明確,並使用適當的HTTP方法(如POST用於創建,PUT用於更新)。 設計清晰的請求和響應模型,以確保客戶端能夠理解預期格式。 2.數據驗證 在伺服器端進行嚴格的數據驗證,確保接收到的數據符合預期格 ...