1. 簡介

成都創(chuàng)新互聯(lián)公司專注于城區(qū)網(wǎng)站建設(shè)服務(wù)及定制，我們擁有豐富的企業(yè)做網(wǎng)站經(jīng)驗(yàn)。 熱誠為您提供城區(qū)營銷型網(wǎng)站建設(shè)，城區(qū)網(wǎng)站制作、城區(qū)網(wǎng)頁設(shè)計(jì)、城區(qū)網(wǎng)站官網(wǎng)定制、微信平臺小程序開發(fā)服務(wù)，打造城區(qū)網(wǎng)絡(luò)公司原創(chuàng)品牌,更為您提供城區(qū)網(wǎng)站排名全網(wǎng)營銷落地服務(wù)。

本文主要給大家介紹使用SpringMVC的后端服務(wù)如何通過配置來支持多種返回值類型（xml,json,html,excel）

這里的代碼使用的是springboot,下載地址：https://github.com/xiagn825/springboot-todolist/tree/springboot-ContentNegotiation

2. 基礎(chǔ)概念

2.1 HttpHeader中Content-Type和Accept設(shè)置的區(qū)別

Accept:接口要返回給客戶端的數(shù)據(jù)格式

 curl --header 'Accept:application/json' http://localhost:8080/todo

Content-Type:客戶端發(fā)送給服務(wù)器端的數(shù)據(jù)格式

 curl -X PUT --header 'Content-Type:application/json' -d '{"title":"周末日程","content":"睡覺"}' http://localhost:8080/todo

2.2 SpringMVC生成輸出的兩種方式

1） 當(dāng)服務(wù)端使用Restful的方式，只為客戶端的ajax或其他服務(wù)端請求提供數(shù)據(jù)時，通常會使用@ResponseBody來標(biāo)識你的返回，這時候Spring使用HttpMessageConverter來把返回的對象格式化成所需的格式。

2） 當(dāng)你需要提供表現(xiàn)層(比如：HTML)，這時候SpringMVC使用ViewResolver來將處理你的返回。

有時候你的應(yīng)用程序這兩者都要提供

2.3 SpringMVC輸出格式判定

很多時候?yàn)榱酥С侄鄠€系統(tǒng)或多個終端，你需要讓相同的數(shù)據(jù)已不同的表現(xiàn)形式輸出。

SpringMVC使用ContentNegotationStrategy來判定用戶請求希望得到什么格式的數(shù)據(jù)。

ContentNegotationStrategy通過三種方式來識別用戶想要返回什么樣的數(shù)據(jù)

• 通過請求URL后綴：http://myserver/myapp/accounts/list.html 返回html格式
• 通過請求的參數(shù)：http://myserver/myapp/accounts/list?format=xls 該設(shè)置默認(rèn)不開啟，默認(rèn)key是format。
• 通過HTTP Header的Accept：Accept:application/xml 優(yōu)先級由上至下

請看如下配置

@Override
public void configureContentNegotiation(ContentNegotiationConfigurer configurer) {
 configurer.favorPathExtension(false)
   .favorParameter(true)
   .parameterName("mediaType")
   .defaultContentType(MediaType.APPLICATION_JSON)
   .mediaType("xml", MediaType.APPLICATION_XML)
   .mediaType("html", MediaType.TEXT_HTML)
   .mediaType("json", MediaType.APPLICATION_JSON);
}

在你工程的WebMvcConfig中加入以上配置，表示關(guān)閉URL后綴的規(guī)則，打開請求參數(shù)規(guī)則并設(shè)置請求參數(shù)為'mediaType',默認(rèn)的返回格式是json，還支持返回xml,html。

這三個組件是用來處理返回不同格式輸出的關(guān)鍵

• Request Mappings: 決定不同的請求到不同的方法并返回不同的格式.
• View Resolution: 根據(jù)類型返回合適的表示層.
• HttpMessageConverters: 將request中的參數(shù)轉(zhuǎn)換成java對象，將java對象轉(zhuǎn)換成相應(yīng)的輸出格式到response.

2.4 RequestMappings

2.4.1 RequestMappingHandlerMapping

我們在spring中通常使用的就是RequestMappingHandlerMapping，根據(jù)RequestMappingInfo,細(xì)化匹配條件，整體的查找過程如下：

AbstractHandlerMethodMapping實(shí)現(xiàn)接口getHandlerInternal

1. 使用UrlPathHelper查找request對應(yīng)的path

2. 查找path對應(yīng)的HandlerMethod

2.1 從urlMap中直接等值匹配查找匹配條件RequestMappingInfo

2.2 如果等值查找到匹配條件,將其添加到match條件中

2.3 如果沒有找到匹配條件,使用所有的handlerMethod的RequestMappingInfo進(jìn)行匹配

2.4 對匹配到的Match進(jìn)行排序,取出最高優(yōu)先級的Match,并核對是否是唯一的最高優(yōu)先級

2.5 對匹配到條件,沒有匹配到條件的兩種情況,分別進(jìn)行封裝

3. 封裝HandlerMethod,確保bean中存的是實(shí)例 　　 ContentNegotiationManager其中提供了針對miniType的match條件比較，使框架可以匹配到最合適的處理方法。

2.5 HttpMessageConverter

2.5.1 The Default Message Converters

SpringMvc默認(rèn)會加載下列HttpMessageConverters：

ByteArrayHttpMessageConverter – converts byte arrays
StringHttpMessageConverter – converts Strings
ResourceHttpMessageConverter – converts org.springframework.core.io.Resource for any type of octet stream
SourceHttpMessageConverter – converts javax.xml.transform.Source
FormHttpMessageConverter – converts form data to/from a MultiValueMap<String, String>.
Jaxb2RootElementHttpMessageConverter – converts Java objects to/from XML (added only if JAXB2 is present on the classpath)
MappingJackson2HttpMessageConverter – converts JSON (added only if Jackson 2 is present on the classpath)
MappingJacksonHttpMessageConverter – converts JSON (added only if Jackson is present on the classpath)
AtomFeedHttpMessageConverter – converts Atom feeds (added only if Rome is present on the classpath)
RssChannelHttpMessageConverter – converts RSS feeds (added only if Rome is present on the classpath)

我們?nèi)绻祷氐氖鞘褂聾ResponseBody來標(biāo)識的，那么框架會使用HttpMessageConverter來處理返回值，默認(rèn)的xmlCoverter不是特別好用，依賴返回實(shí)體對象上的@XmlRootElement注解，不是很方便所以引入輔助類庫，并自定義MessageConverter這樣可以直接將返回的對象處理成xml格式。

Gradle import library

compile group: 'org.springframework', name: 'spring-oxm', version: '4.3.9.RELEASE'
compile group: 'com.thoughtworks.xstream', name: 'xstream', version: '1.4.10'

configuration

@Override
public void configureMessageConverters(List<HttpMessageConverter<?>> converters) {
 converters.add(createXmlHttpMessageConverter());
 super.configureMessageConverters(converters);
}
private HttpMessageConverter<Object> createXmlHttpMessageConverter() {
 MarshallingHttpMessageConverter xmlConverter =
   new MarshallingHttpMessageConverter();
 XStreamMarshaller xstreamMarshaller = new XStreamMarshaller();
 xmlConverter.setMarshaller(xstreamMarshaller);
 xmlConverter.setUnmarshaller(xstreamMarshaller);
 return xmlConverter;
}

2.6 View Resolution

2.6.1 頁面render（freemarker）

當(dāng)需要返回頁面時就需要由合適的viewResolver來繪制畫面，這里采用freemarker作為頁面引擎。

Gradle import library

compile("org.springframework.boot:spring-boot-starter-freemarker")

總結(jié)

以上就是這篇文章的全部內(nèi)容了，希望本文的內(nèi)容對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價值，如果有疑問大家可以留言交流，謝謝大家對創(chuàng)新互聯(lián)的支持。

網(wǎng)頁標(biāo)題：spring接口通過配置支持返回多種格式（xml,json,html,excel）
本文URL：http://chinadenli.net/article38/gdggsp.html

成都網(wǎng)站建設(shè)公司_創(chuàng)新互聯(lián)，為您提供營銷型網(wǎng)站建設(shè)、虛擬主機(jī)、小程序開發(fā)、商城網(wǎng)站、網(wǎng)站導(dǎo)航、微信公眾號

廣告

聲明：本網(wǎng)站發(fā)布的內(nèi)容（圖片、視頻和文字）以用戶投稿、用戶轉(zhuǎn)載內(nèi)容為主，如果涉及侵權(quán)請盡快告知，我們將會在第一時間刪除。文章觀點(diǎn)不代表本網(wǎng)站立場，如需處理請聯(lián)系客服。電話：028-86922220；郵箱：631063699@qq.com。內(nèi)容未經(jīng)允許不得轉(zhuǎn)載，或轉(zhuǎn)載時需注明來源： 創(chuàng)新互聯(lián)