前言

一直以來對HTTP請求中各種屬性一知半解,偶然在部落格中找到一篇,特意摘錄過來方便自己以後檢視.

正文

敬請關注部落格，後期不斷更新優質博文，謝謝

這裡講解Content-Type的可用值，以及在spring MVC中如何使用它們來對映請求資訊。

1.  Content-Type

  MediaType，即是Internet Media Type，網際網路媒體型別；也叫做MIME型別，在Http協議訊息頭中，使用Content-Type來表示具體請求中的媒體型別資訊。

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

 常見的媒體格式型別如下：

•     text/html ： HTML格式
•     text/plain ：純文字格式      
•     text/xml ：  XML格式
•     image/gif ：gif圖片格式    
•     image/jpeg ：jpg圖片格式 
•     image/png：png圖片格式

   以application開頭的媒體格式型別：

•    application/xhtml+xml ：XHTML格式
•    application/xml     ： XML資料格式
•    application/atom+xml  ：Atom XML聚合格式    
•    application/json    ： JSON資料格式
•    application/pdf       ：pdf格式  
•    application/msword  ： Word文件格式
•    application/octet-stream ： 二進位制流資料（如常見的檔案下載）
•    application/x-www-form-urlencoded ： <form encType=””>中預設的encType，form表單資料被編碼為key/value格式傳送到伺服器（表單預設的提交資料的格式）

   另外一種常見的媒體格式是上傳檔案之時使用的：

•     multipart/form-data ： 需要在表單中進行檔案上傳時，就需要使用該格式

     以上就是我們在日常的開發中，經常會用到的若干content-type的內容格式。

2.   Spring MVC中關於關於Content-Type型別資訊的使用

    首先我們來看看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:  指定請求的實際地址， 比如 /action/info之類。
method：  指定請求的method型別， GET、POST、PUT、DELETE等
consumes： 指定處理請求的提交內容型別（Content-Type），例如application/json, text/html;
produces:    指定返回的內容型別，僅當request請求頭中的(Accept)型別中包含該指定型別才返回
params： 指定request中必須包含某些引數值是，才讓該方法處理
headers： 指定request中必須包含某些指定的header值，才能讓該方法處理請求

其中，consumes， produces使用content-typ資訊進行過濾資訊；headers中可以使用content-type進行過濾和判斷。

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裡面可以出現的資訊，不侷限在Referer資訊。

  示例2

    @RequestMapping(value = "/response/ContentType", headers = "Accept=application/json")    
    public void response2(HttpServletResponse response) throws IOException {    
        //表示響應的內容區資料的媒體型別為json格式，且編碼為utf-8(客戶端應該以utf-8解碼)    
        response.setContentType("application/json;charset=utf-8");    
        //寫出響應體內容    
        String jsonData = "{\"username\":\"zhang\", \"password\":\"123\"}";    
        response.getWriter().write(jsonData);    
    }    

伺服器根據請求頭“Accept=application/json”生產json資料。

當你有如下Accept頭，將遵守如下規則進行應用：
①Accept：text/html,application/xml,application/json
      將按照如下順序進行produces的匹配 ①text/html ②application/xml ③application/json
②Accept：application/xml;q=0.5,application/json;q=0.9,text/html
      將按照如下順序進行produces的匹配 ①text/html ②application/json ③application/xml
      引數為媒體型別的質量因子，越大則優先權越高(從0到1)
③Accept：*/*,text/*,text/html
      將按照如下順序進行produces的匹配 ①text/html ②text/* ③*/*

即匹配規則為：最明確的優先匹配。

Requests部分

Responses 部分 

3.2 params的示例

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

  僅處理請求中包含了名為“myParam”，值為“myValue”的請求，起到了一個過濾的作用。

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”型別的請求. produces標識==>處理request請求中Accept頭中包含了"application/json"的請求，同時暗示了返回的內容型別為application/json;

總結

  在本文中，首先介紹了Content-Type主要支援的格式內容，然後基於@RequestMapping標註的內容介紹了主要的使用方法，其中,headers, consumes,produces,都是使用Content-Type中使用的各種媒體格式內容，可以基於這個格式內容來進行訪問的控制和過濾。

參考資料：

1.  HTTP中支援的Content-Type: http://tool.oschina.NET/commons

2.  Media Type介紹。 http://www.iteye.com/topic/1127120