SpringBoot對Spring MVC都做了哪些事?(二)
上一篇:《??SpringBoot對Spring MVC都做了哪些事?(一)??》
靜態(tài)內(nèi)容
默認(rèn)情況下,Spring Boot從類路徑中名為/static(或/public或/resources或/META-INF/resources)的目錄或ServletContext的根目錄提供靜態(tài)內(nèi)容。它使用Spring MVC中的ResourceHttpRequestHandler,因此你可以通過添加自己的WebMVCConfiguer并重寫addResourceHandlers方法來修改該行為。
在一個獨立的web應(yīng)用程序中,容器中的默認(rèn)servlet也被啟用,并作為備用,如果Spring決定不處理它,則從ServletContext的根提供內(nèi)容。大多數(shù)情況下,這不會發(fā)生(除非你修改默認(rèn)的MVC配置),因為Spring始終可以通過DispatcherServlet處理請求。
默認(rèn)情況下,資源映射到/**,但你可以通過spring.mvc.static-path-pattern屬性進(jìn)行調(diào)整。例如,可以通過以下方式將所有資源重新定位到/resources/**中:
spring:
mvc:
static-path-pattern: "/resources/**"
你也可以通過spring.web.resources.static-locations屬性執(zhí)行設(shè)置靜態(tài)資源的位置。Servlet的根上下文路徑“/”也會自動添加為一個位置。
除了前面提到的“標(biāo)準(zhǔn)”靜態(tài)資源位置之外,Webjars內(nèi)容還有一種特殊情況。任何路徑在/webjars/**的資源都是從jar文件中提供的,如果它們被打包成webjars格式的話。
Spring Boot還支持Spring MVC提供的高級資源處理特性,允許使用緩存破壞靜態(tài)資源或為webjar使用版本無關(guān)url等用例。
要對webjar使用版本不確定的url,需要添加Webjars-locator-core依賴。然后聲明你的Webjar。以jQuery為例,添加“/Webjar/jQuery/jQuery.min.js”,得到“/Webjar/jQuery/x.y.z/jQuery .min.js”,其中x.y.z是Webjar版本。
歡迎頁
Spring Boot支持靜態(tài)和模板歡迎頁面。它首先在配置的靜態(tài)內(nèi)容位置中查找index.html文件。如果沒有找到,它將查找索引模板。如果找到其中一個,它將自動用作應(yīng)用程序的歡迎頁面。
路徑匹配和內(nèi)容協(xié)商
Spring MVC可以通過查看請求路徑并將其與應(yīng)用程序中定義的映射(例如,Controller方法上的@GetMapping注釋)來將傳入的HTTP請求映射到處理程序。
默認(rèn)情況下,Spring Boot選擇禁用后綴模式匹配,這意味著像“GET /projects/spring-boot”這樣的請求。json"不會匹配@GetMapping("/projects/spring-boot")映射。這被認(rèn)為是Spring MVC應(yīng)用程序的最佳實踐。這個特性主要是在過去的HTTP客戶端沒有發(fā)送正確的“Accept”請求頭的時候有用;我們需要確保向客戶端發(fā)送正確的內(nèi)容類型。如今,內(nèi)容協(xié)商更加可靠。
還有其他方法來處理HTTP客戶端不一致地發(fā)送正確的“Accept”請求頭。不使用后綴匹配,我們可以使用查詢參數(shù)來確保像“GET /projects/spring-boot?”format=json"將被映射到@GetMapping("/projects/spring-boot"):
示例:
"/format")(
public Map<String, Object> format() {
Map<String, Object> result = new HashMap<>() ;
result.put("name", "張三") ;
return result ;
}
如上接口,在正常請求的情況下返回:
再次測試,這次我們將Accept請求Header做下修改如下:
請求失敗了,你客戶端能接收的是text/html,但是服務(wù)端生成的application/json類型,所以客戶端是無法解析處理的。
對服務(wù)端做如下配置:
spring:
mvc:
contentnegotiation:
favor-parameter: true
在請求中這次添加一個format參數(shù):
成功,如果你將format值改成其它又會錯誤。
修改參數(shù)名:
spring:
mvc:
contentnegotiation:
favor-parameter: true
parameter-name: akf
通過parameter-name將默認(rèn)的format修改為akf。
自定義請求header類型
spring:
mvc:
contentnegotiation:
media-types:
cnn: app/cnn
這時候我們的Accept也是可以接收app/cnn的請求類型的。
ConfigurableWebBindingInitializer
Spring MVC使用WebBindingInitializer為特定的請求初始化WebDataBinder。如果你創(chuàng)建了自己的ConfigurableWebBindingInitializer @Bean, Spring Boot會自動配置Spring MVC來使用它。
模版引擎
除了REST web服務(wù)之外,還可以使用Spring MVC來提供動態(tài)HTML內(nèi)容。Spring MVC支持各種模板技術(shù),包括thymleaf、FreeMarker和jsp。此外,許多其他模板引擎也包含它們自己的Spring MVC集成。
Spring Boot包括對以下模板引擎的自動配置支持:
- FreeMarker
- Groovy
- Thymeleaf
- Mustache
如果可能的話,應(yīng)該避免使用jsp。當(dāng)將它們與嵌入式servlet容器一起使用時,有幾個已知的限制。
當(dāng)你使用這些帶有默認(rèn)配置的模板引擎之一時,你的模板將自動從src/main/resources/templates中獲取。