靜態(tài)資源處理
默認(rèn)靜態(tài)資源映射
首先看官網(wǎng)解釋?zhuān)?/p>
By default Spring Boot will serve static content from a directory called /static (or /public or /resources or /META-INF/resources) in the classpath or from the root of the ServletContext. It uses the ResourceHttpRequestHandler from Spring MVC so you can modify that behavior by adding your own WebMvcConfigurerAdapter and overriding the addResourceHandlers method.
大意是:在默認(rèn)情況下,springboot 默認(rèn)映射類(lèi)路徑下 /static啤挎、/public、 /resources、 /META-INF/resources 等目錄下的資源。
默認(rèn)映射框杜,在啟動(dòng)服務(wù)的時(shí)候,控制臺(tái)有打印以下記錄:
[ restartedMain] o.s.w.s.handler.SimpleUrlHandlerMapping : Mapped URL path [/webjars/**] onto handler of type [class org.springframework.web.servlet.resource.ResourceHttpRequestHandler]
[ restartedMain] o.s.w.s.handler.SimpleUrlHandlerMapping : Mapped URL path [/**] onto handler of type [class org.springframework.web.servlet.resource.ResourceHttpRequestHandler]
# 默認(rèn)配置的 /** 映射到 /static (或/public郭计、/resources霸琴、/META-INF/resources)
其優(yōu)先級(jí)是 META/resources > resources > static > public
# 默認(rèn)配置的 /webjars/** 映射到 classpath:/META-INF/resources/webjars/
01 在resources下新建目錄static/images,任意放一張圖片springboot.jpg 到images目錄:
└─resources
│ application.properties
│
├─static
│ └─images
│ springboot.jpg
│
└─templates
empList.html
Error.html
ok.html
02 在empList.html 添加一個(gè)img 標(biāo)簽:
<img src="/images/springboot.jpg" />
# 瀏覽器訪問(wèn) http://localhost:8080/emp/empList
打印圖片
打印員工信息……
#靜態(tài)資源訪問(wèn)成功,將static目錄重命名為public昭伸,重啟服務(wù)梧乘,刷新網(wǎng)頁(yè):
打印圖片
打印員工信息……
#測(cè)試驗(yàn)證通過(guò)
03 注意 src="/images/springboot.jpg",資源定位以“/” 開(kāi)頭庐杨,也就是說(shuō)默認(rèn)以“/” 開(kāi)始定位选调,如果我們的應(yīng)用上下文不是“/” 呢? application.proterties 添加上下文配置:
# application.proterties 添加配置:
server.context-path=/springmybatis
04 重啟服務(wù),訪問(wèn) http://localhost:8080/springmybatis/emp/empList
打印員工信息
# 未顯示圖片灵份,檢查發(fā)現(xiàn)圖片的定位是:http://localhost:8080/images/springboot.jpg =>缺上下文一級(jí)
05 更改圖片路徑
<img src="/springmybatis/images/springboot.jpg" />
# 重新訪問(wèn)仁堪,http://localhost:8080/springmybatis/emp/empList
打印圖片
打印員工信息
06 加入context-path發(fā)生改變呢?那么如此固定的寫(xiě)法改動(dòng)起來(lái)就顯得非常被動(dòng)了填渠,那么如何處理呢弦聂?有以下兩種方式:
#方法一:動(dòng)態(tài)獲取contextPath添加到路徑之前,img 標(biāo)簽重寫(xiě)為:
<img th:src="${#httpServletRequest.getContextPath()+'/images/springboot.jpg'}" />
#重現(xiàn)編譯氛什,或者重啟服務(wù)莺葫,刷新頁(yè)面
打印圖片
打印員工信息
#問(wèn)題解決,如此動(dòng)態(tài)獲取contextpath避免了固定寫(xiě)法的被動(dòng)
但是這樣做也有一個(gè)問(wèn)題枪眉,每次在定位靜態(tài)資源時(shí)都要在路徑前獲取contextpath,代碼重復(fù)較重捺檬!推薦采用base解決:
# 方法二: 在網(wǎng)頁(yè)head 標(biāo)簽中添加一個(gè)base 子標(biāo)簽
<base th:href="${#httpServletRequest.getContextPath()+'/'}"/>
# img 標(biāo)簽重寫(xiě)為:
<img src="images/springboot.jpg" />
# 重現(xiàn)編譯,或者重啟服務(wù)贸铜,刷新頁(yè)面 http://localhost:8080/springmybatis/emp/empList
打印圖片
打印員工信息
# 問(wèn)題解決堡纬,如此,類(lèi)似img標(biāo)簽代碼重復(fù)問(wèn)題得以解決
自定義靜態(tài)資源映射
01 在classpath(即:resources) 下自定義一個(gè)資源目錄:mysource,添加wu.jpg 到其中:
resources
mysource
wu.jpg
02 瀏覽器訪問(wèn) http://localhost:8080/springmybatis/wu.gif
# 頁(yè)面報(bào)錯(cuò)404 蒿秦,找不到資源
03 新建 person/jack.config/MyConfig:
package person.jack.config;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.config.annotation.ResourceHandlerRegistry;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurerAdapter;
@Configuration
public class MyConfig extends WebMvcConfigurerAdapter {
@Override
public void addResourceHandlers(ResourceHandlerRegistry registry) {
registry.addResourceHandler("/**").addResourceLocations("classpath:/mysource/");
super.addResourceHandlers(registry);
}
}
04 重啟服務(wù)烤镐,重新訪問(wèn):http://localhost:8080/springmybatis/wu.gif
打印圖片
# 在上述代碼調(diào)用 addResourceHandler("/**") 方法時(shí),傳入的參數(shù)時(shí):/** 棍鳖,這樣會(huì)破會(huì)默認(rèn)的靜態(tài)資源配置职车,
# 重新訪問(wèn):http://localhost:8080/springmybatis/emp/empList
打印員工信息
# springboot.jpg 圖片沒(méi)有打印該處傳參時(shí)不宜用 “/**”,改為“/my/*”:
registry.addResourceHandler("/my/*").addResourceLocations("classpath:/mysource/");
05 重啟服務(wù),訪問(wèn):
# 1. http://localhost:8080/springmybatis/emp/empList
打印圖片
打印員工信息
# 2. http://localhost:8080/springmybatis/my/wu.gif
打印 “悟”圖片
06 成功悴灵,完成!
設(shè)置默認(rèn)路徑映射
到本章為止骂蓖,還沒(méi)有解決默認(rèn)映射的問(wèn)題积瞒,比如 /、/index登下、/index.html 默認(rèn)映射到首頁(yè)茫孔,先看以下步驟:
01 在person/jack.config/MyConfig 重寫(xiě)addViewControllers() 方法:
@Configuration
public class MyConfig extends WebMvcConfigurerAdapter {
……
@Override
public void addViewControllers(ViewControllerRegistry registry) {
registry.addViewController("/").setViewName("index");
registry.addViewController("/index").setViewName("index");
registry.addViewController("/index.html").setViewName("index");
super.addViewControllers(registry);
}
}
02 在 templates 目錄下新建index.html 模板:
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8"/>
<title>Title</title>
</head>
<body>
<h1>首頁(yè)</h1>
</body>
</html>
03 重啟服務(wù),訪問(wèn):
# 訪問(wèn):http://localhost:8080/springmybatis/被芳,頁(yè)面打印
首頁(yè)
# 訪問(wèn):http://localhost:8080/springmybatis/index缰贝,頁(yè)面打印
首頁(yè)
# 訪問(wèn):http://localhost:8080/springmybatis/index.html,頁(yè)面打印
首頁(yè)
# 測(cè)試畔濒,成功剩晴!
04 總結(jié):設(shè)置默認(rèn)映射,即在有@Configuration 注解修飾的繼承了WebMvcConfigurerAdapter超類(lèi)的類(lèi)中重寫(xiě)addViewControllers() 方法侵状,通過(guò)ViewControllerRegistry 對(duì)象調(diào)用addViewController()方法設(shè)置對(duì)應(yīng)的映射即可赞弥!