Springboot系列（四）web靜態資源配置詳解

Springboot系列（四）web靜態資源配置

往期精彩

1. SpringBoot系列（一）idea新建Springboot項目
2. SpringBoot系列（二）入門知識
3. SpringBoot系列（三）配置文件詳解完整版

引言：
SpringBoot web項目開發中往往會涉及到一些靜態資源的使用，比如說圖片，css樣式，js等等，今天我們來講講這些常見的靜態資源應該放在哪個位置，怎么放在自己想放的位置。

目錄

1. 項目創建
2. 資源文件配置與訪問
   1.Springboot中默認的靜態資源路徑
   2.自定義靜態資源路徑
   3.兩種訪問靜態資源的方式
3. 其他靜態資源路徑配置方式
   1.繼承WebMvcConfigurerAdapter
   2.優化配置

1. 項目創建

我們先創建一個空的項目，項目的依賴配置為starter-web依賴，創建好的項目下面有一個resources文件夾，里面有一些空的默認的文件夾，然后有一個配置文件。

templates文件下面一般是放置模板頁面的，比如html，jsp之類的，static文件一般是是放置靜態資源，比如說，圖片，文件等等。

我們放置了文件或者是圖片就需要訪問這個文件，看看怎么才能有效的實現訪問這些靜態資源文件，以及自己訪問自己定義好的資源訪問路徑。

2. 資源文件訪問與配置

一般來說，我們是做前后端分離的，Springboot就作為后端，但是Springboot依然支持有html文件等，實現前后端在一個項目里面。也就是Springboot web項目。

首先，我們在templates文件夾下面創建一個名為index的html5頁面，然后隨便寫一點東西，然后在配置文件中，配置一個項目啟動端口。

html5文件

配置文件端口配置不再講解，前一期里面有配置文件詳解，不會的可以回去看看。
啟動項目，瀏覽器輸入：localhost:8088/index.html
你會發現頁面是404，這時候我們是訪問不了這個頁面的。然后你可能會說localhost:8088/templates/index.html，你會發現都不行都不行！

因為Springboot的默認資源配置里面沒有這個templates路徑，但是有static路徑。

1.Springboot中默認的靜態資源路徑：

1. classpath:/static,
2. classpath:/public,
3. classpath:/resources,
4. classpath:/META-INF/resources,

classpath 在項目中就相當於src/main/resources文件夾.

就是說如果你把html文件直接放在static路徑下面是可以直接訪問的，有兩種訪問方式。

當你添加了start-web的依賴，resources下面是會默認生成一個static文件夾以及templates文件夾。

2.自定義靜態資源路徑。

spring.resources.static-locations=classpath:templates/ 

我們配置了靜態資源路徑映射之后，我們只能訪問這個路徑下面的資源，也就是相當於自定義了靜態資源路徑，就是說默認的靜態資源路徑都會失效。

3.兩種訪問靜態資源的方式

一種是直接通過特定的URL訪問：我們配置好后，啟動項目，瀏覽器輸入：localhost:8088/index.html 就可以正常訪問我們的靜態資源了。
效果圖如下

然后還有一種訪問資源的方法。是使用代碼是實現的。

我們在和啟動文件同級目錄下面創建一個controller文件夾，然后創建一個Testcontroller,代碼如下：

/** * @author 全棧學習筆記 * @date 2020/4/12 12:20 * @description */ @Controller public class TestController { @RequestMapping("/getHtml") public String getHtml(){ return "index.html"; } } 

說明：這個@Controller ，意思標記這個類為控制類，或者說他是一個Springmvc controller對象，標記之后，默認這個類的所有方法返回的是一個頁面。然后這個@RequestMapping的注解是一個用來處理請求地址映射的注解，可用於類或方法上。用於方法之上時，你可以通過URL直接訪問這個方法。它還有一些其他的參數，這里就不講解了。后面會出一期Springboot常用注解的說明。有興趣的可以 wx 搜索 全棧學習筆記。

到這里，我們就可以利用自定義URL訪問靜態資源了。在瀏覽器里面輸入：localhost:8088/getHtml 也能正常訪問靜態資源。圖片也是一樣的。

3. 其他靜態資源路徑配置方式

1. 繼承WebMvcConfigurerAdapter

我們通過重寫這個類的addResourceHandlers方法，定義資源路徑

/** * @author 全棧學習筆記 * @date 2020/4/12 15:46 * @description */ @Configuration public class WebConfig extends WebMvcConfigurerAdapter { @Override public void addResourceHandlers(ResourceHandlerRegistry registry) { registry.addResourceHandler("/**").addResourceLocations("/","classpath:templates/"); super.addResourceHandlers(registry); } } 

2. 優化配置

你會看到之前的那種利用代碼的URL路徑訪問靜態資源文件的寫法，我們需要在返回的地方寫上文件的名稱以及文件的后綴名，當我們要返回某一類型的文件時，這樣寫就相對比較麻煩，所以我們可以通過以下配置來解決這個問題。

#加前綴
spring.mvc.view.prefix=/
#加后綴
spring.mvc.view.suffix=.html

通過以上的配置，我們之前的controller里面的方法返回就可以寫成這樣。

@RequestMapping("/getHtml") public String getHtml(){ return "index"; } 

總結：

靜態資源配置路徑的兩種常用方式： 一種是默認配置，一種是自定義配置，自定義配置可以是代碼配置，可以是配置文件里面配置。這兩種配置方式都會使原來默認的配置方式失效。

靜態資源的訪問方式有兩種：一種是自己用代碼定義路徑，然后訪問，一種是直接利用特定的URL方式訪問靜態資源。