詳解Http請(qǐng)求中Content-Type講解以及在Spring MVC中的應(yīng)用

引言： 在Http請(qǐng)求中，我們每天都在使用Content-type來(lái)指定不同格式的請(qǐng)求信息，但是卻很少有人去全面了解content-type中允許的值有多少，這里將講解Content-Type的可用值，以及在spring MVC中如何使用它們來(lái)映射請(qǐng)求信息。

1.  Content-Type

  MediaType，即是Internet Media Type，互聯(lián)網(wǎng)媒體類(lèi)型；也叫做MIME類(lèi)型，在Http協(xié)議消息頭中，使用Content-Type來(lái)表示具體請(qǐng)求中的媒體類(lèi)型信息。

類(lèi)型格式：type/subtype(;parameter)? type 
主類(lèi)型，任意的字符串，如text，如果是*號(hào)代表所有；  
subtype 子類(lèi)型，任意的字符串，如html，如果是*號(hào)代表所有；  
parameter 可選，一些參數(shù)，如Accept請(qǐng)求頭的q參數(shù)， Content-Type的 charset參數(shù)。  

 例如： Content-Type: text/html;charset:utf-8;

 常見(jiàn)的媒體格式類(lèi)型如下：

1.     text/html ： HTML格式
2.     text/plain ：純文本格式     
3.     text/xml ：  XML格式
4.     image/gif ：gif圖片格式   
5.     image/jpeg ：jpg圖片格式
6.     image/png：png圖片格式

   以application開(kāi)頭的媒體格式類(lèi)型：

1.    application/xhtml+xml ：XHTML格式
2.    application/xml     ： XML數(shù)據(jù)格式
3.    application/atom+xml  ：Atom XML聚合格式   
4.    application/json    ： JSON數(shù)據(jù)格式
5.    application/pdf       ：pdf格式 
6.    application/msword  ： Word文檔格式
7.    application/octet-stream ： 二進(jìn)制流數(shù)據(jù)（如常見(jiàn)的文件下載）
8.    application/x-www-form-urlencoded ： <form encType=””>中默認(rèn)的encType，form表單數(shù)據(jù)被編碼為key/value格式發(fā)送到服務(wù)器（表單默認(rèn)的提交數(shù)據(jù)的格式）
   

   另外一種常見(jiàn)的媒體格式是上傳文件之時(shí)使用的：

    multipart/form-data ： 需要在表單中進(jìn)行文件上傳時(shí)，就需要使用該格式

     以上就是我們?cè)谌粘５拈_(kāi)發(fā)中，經(jīng)常會(huì)用到的若干content-type的內(nèi)容格式。

2.   Spring MVC中關(guān)于關(guān)于Content-Type類(lèi)型信息的使用

    首先我們來(lái)看看RequestMapping中的Class定義：

@Target({ElementType.METHOD, ElementType.TYPE}) 
@Retention(RetentionPolicy.RUNTIME) 
@Documented 
@Mapping 
public @interface RequestMapping { 
   String[] value() default {}; 
   RequestMethod[] method() default {}; 
   String[] params() default {}; 
   String[] headers() default {}; 
   String[] consumes() default {}; 
   String[] produces() default {}; 
} 

value:  指定請(qǐng)求的實(shí)際地址， 比如 /action/info之類(lèi)。
method：  指定請(qǐng)求的method類(lèi)型， GET、POST、PUT、DELETE等
consumes： 指定處理請(qǐng)求的提交內(nèi)容類(lèi)型（Content-Type），例如application/json, text/html;
produces:    指定返回的內(nèi)容類(lèi)型，僅當(dāng)request請(qǐng)求頭中的(Accept)類(lèi)型中包含該指定類(lèi)型才返回
params： 指定request中必須包含某些參數(shù)值是，才讓該方法處理
headers： 指定request中必須包含某些指定的header值，才能讓該方法處理請(qǐng)求
其中，consumes， produces使用content-typ信息進(jìn)行過(guò)濾信息；headers中可以使用content-type進(jìn)行過(guò)濾和判斷。

3. 使用示例

  3.1 headers

@RequestMapping(value = "/test", method = RequestMethod.GET, headers="Referer=http://www.ifeng.com/")  
public void testHeaders(@PathVariable String ownerId, @PathVariable String petId) {    
 // implementation omitted  
}  

  這里的Headers里面可以匹配所有Header里面可以出現(xiàn)的信息，不局限在Referer信息。

  示例2

@RequestMapping(value = "/response/ContentType", headers = "Accept=application/json")  
public void response2(HttpServletResponse response) throws IOException {  
  //表示響應(yīng)的內(nèi)容區(qū)數(shù)據(jù)的媒體類(lèi)型為json格式，且編碼為utf-8(客戶(hù)端應(yīng)該以u(píng)tf-8解碼)  
  response.setContentType("application/json;charset=utf-8");  
  //寫(xiě)出響應(yīng)體內(nèi)容  
  String jsonData = "{\"username\":\"zhang\", \"password\":\"123\"}";  
  response.getWriter().write(jsonData);  
}  

服務(wù)器根據(jù)請(qǐng)求頭“Accept=application/json”生產(chǎn)json數(shù)據(jù)。

當(dāng)你有如下Accept頭，將遵守如下規(guī)則進(jìn)行應(yīng)用：

①Accept：text/html,application/xml,application/json
      將按照如下順序進(jìn)行produces的匹配 ①text/html ②application/xml ③application/json
②Accept：application/xml;q=0.5,application/json;q=0.9,text/html
      將按照如下順序進(jìn)行produces的匹配 ①text/html ②application/json ③application/xml
      參數(shù)為媒體類(lèi)型的質(zhì)量因子，越大則優(yōu)先權(quán)越高(從0到1)
③Accept：*/*,text/*,text/html
      將按照如下順序進(jìn)行produces的匹配 ①text/html ②text/* ③*/*

即匹配規(guī)則為：最明確的優(yōu)先匹配。

Requests部分

Responses 部分

3.2 params的示例

@RequestMapping(value = "/test/{userId}", method = RequestMethod.GET, params="myParam=myValue")  
public void findUser(@PathVariable String userId) {    
 // implementation omitted  
}  

  僅處理請(qǐng)求中包含了名為“myParam”，值為“myValue”的請(qǐng)求，起到了一個(gè)過(guò)濾的作用。

3.3 consumes/produces

@Controller  
@RequestMapping(value = "/users", method = RequestMethod.POST, consumes="application/json", produces="application/json")  
@ResponseBody 
public List<User> addUser(@RequestBody User userl) {    
  // implementation omitted  
  return List<User> users; 
}  

  方法僅處理request Content-Type為“application/json”類(lèi)型的請(qǐng)求. produces標(biāo)識(shí)==>處理request請(qǐng)求中Accept頭中包含了"application/json"的請(qǐng)求，同時(shí)暗示了返回的內(nèi)容類(lèi)型為application/json;

4. 總結(jié)

  在本文中，首先介紹了Content-Type主要支持的格式內(nèi)容，然后基于@RequestMapping標(biāo)注的內(nèi)容介紹了主要的使用方法，其中,headers, consumes,produces,都是使用Content-Type中使用的各種媒體格式內(nèi)容，可以基于這個(gè)格式內(nèi)容來(lái)進(jìn)行訪問(wèn)的控制和過(guò)濾。

感謝閱讀，希望能幫助到大家，謝謝大家對(duì)本站的支持！