Http請求中Content-Type講解以及在Spring MVC中的應用

http://blog.csdn.net/blueheart20/article/details/45174399

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

  1. Content-Type
    MediaType，即是Internet Media Type，互聯(lián)網(wǎng)媒體類型；也叫做MIME類型，在Http協(xié)議消息頭中，使用Content-Type來表示具體請求中的媒體類型信息。
    [html] view plain copy
    在CODE上查看代碼片
    在CODE上查看代碼片
    派生到我的代碼片
    派生到我的代碼片

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

例如： 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數(shù)據(jù)格式
application/atom+xml ：Atom XML聚合格式
application/json ： JSON數(shù)據(jù)格式
application/pdf ：pdf格式
application/msword ： Word文檔格式
application/octet-stream ： 二進制流數(shù)據(jù)（如常見的文件下載）
application/x-www-form-urlencoded ： <form encType=””>中默認的encType，form表單數(shù)據(jù)被編碼為key/value格式發(fā)送到服務器（表單默認的提交數(shù)據(jù)的格式）

另外一種常見的媒體格式是上傳文件之時使用的：
multipart/form-data ： 需要在表單中進行文件上傳時，就需要使用該格式

 以上就是我們在日常的開發(fā)中，經(jīng)常會用到的若干content-type的內(nèi)容格式。
  1. Spring MVC中關于關于Content-Type類型信息的使用
    首先我們來看看RequestMapping中的Class定義：
    [html] view plain copy
    在CODE上查看代碼片
    在CODE上查看代碼片
    派生到我的代碼片
    派生到我的代碼片

@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： 指定處理請求的提交內(nèi)容類型（Content-Type），例如application/json, text/html;produces: 指定返回的內(nèi)容類型，僅當request請求頭中的(Accept)類型中包含該指定類型才返回params： 指定request中必須包含某些參數(shù)值是，才讓該方法處理headers： 指定request中必須包含某些指定的header值，才能讓該方法處理請求
其中，consumes， produces使用content-typ信息進行過濾信息；headers中可以使用content-type進行過濾和判斷。

  1. 使用示例
    3.1 headers
    [html] view plain copy
    在CODE上查看代碼片
    在CODE上查看代碼片
    派生到我的代碼片
    派生到我的代碼片

@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
[html] view plain copy

派生到我的代碼片
派生到我的代碼片

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

服務器根據(jù)請求頭“Accept=application/json”生產(chǎn)json數(shù)據(jù)。
當你有如下Accept頭，將遵守如下規(guī)則進行應用：①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 參數(shù)為媒體類型的質(zhì)量因子，越大則優(yōu)先權越高(從0到1)③Accept：/,text/,text/html 將按照如下順序進行produces的匹配 ①text/html ②text/ ③/
即匹配規(guī)則為：最明確的優(yōu)先匹配。
Requests部分
Header
解釋
示例

Accept
指定客戶端能夠接收的內(nèi)容類型
Accept: text/plain, text/html

Accept-Charset
瀏覽器可以接受的字符編碼集。
Accept-Charset: iso-8859-5

Accept-Encoding
指定瀏覽器可以支持的web服務器返回內(nèi)容壓縮編碼類型。
Accept-Encoding: compress, gzip

Accept-Language
瀏覽器可接受的語言
Accept-Language: en,zh

Accept-Ranges
可以請求網(wǎng)頁實體的一個或者多個子范圍字段
Accept-Ranges: bytes

Authorization
HTTP授權的授權證書
Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==

Cache-Control
指定請求和響應遵循的緩存機制
Cache-Control: no-cache

Connection
表示是否需要持久連接。（HTTP 1.1默認進行持久連接）
Connection: close

Cookie
HTTP請求發(fā)送時，會把保存在該請求域名下的所有cookie值一起發(fā)送給web服務器。
Cookie: $Version=1; Skin=new;

Content-Length
請求的內(nèi)容長度
Content-Length: 348

Content-Type
請求的與實體對應的MIME信息
Content-Type: application/x-www-form-urlencoded

Date
請求發(fā)送的日期和時間
Date: Tue, 15 Nov 2010 08:12:31 GMT

Expect
請求的特定的服務器行為
Expect: 100-continue

From
發(fā)出請求的用戶的Email
From: user@email.com

Host
指定請求的服務器的域名和端口號
Host: www.zcmhi.com

If-Match
只有請求內(nèi)容與實體相匹配才有效
If-Match: “737060cd8c284d8af7ad3082f209582d”

If-Modified-Since
如果請求的部分在指定時間之后被修改則請求成功，未被修改則返回304代碼
If-Modified-Since: Sat, 29 Oct 2010 19:43:31 GMT

If-None-Match
如果內(nèi)容未改變返回304代碼，參數(shù)為服務器先前發(fā)送的Etag，與服務器回應的Etag比較判斷是否改變
If-None-Match: “737060cd8c284d8af7ad3082f209582d”

If-Range
如果實體未改變，服務器發(fā)送客戶端丟失的部分，否則發(fā)送整個實體。參數(shù)也為Etag
If-Range: “737060cd8c284d8af7ad3082f209582d”

If-Unmodified-Since
只在實體在指定時間之后未被修改才請求成功
If-Unmodified-Since: Sat, 29 Oct 2010 19:43:31 GMT

Max-Forwards
限制信息通過代理和網(wǎng)關傳送的時間
Max-Forwards: 10

Pragma
用來包含實現(xiàn)特定的指令
Pragma: no-cache

Proxy-Authorization
連接到代理的授權證書
Proxy-Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==

Range
只請求實體的一部分，指定范圍
Range: bytes=500-999

Referer
先前網(wǎng)頁的地址，當前請求網(wǎng)頁緊隨其后,即來路
Referer: http://www.zcmhi.com/archives/71.html

TE
客戶端愿意接受的傳輸編碼，并通知服務器接受接受尾加頭信息
TE: trailers,deflate;q=0.5

Upgrade
向服務器指定某種傳輸協(xié)議以便服務器進行轉(zhuǎn)換（如果支持）
Upgrade: HTTP/2.0, SHTTP/1.3, IRC/6.9, RTA/x11

User-Agent
User-Agent的內(nèi)容包含發(fā)出請求的用戶信息
User-Agent: Mozilla/5.0 (Linux; X11)

Via
通知中間網(wǎng)關或代理服務器地址，通信協(xié)議
Via: 1.0 fred, 1.1 nowhere.com (Apache/1.1)

Warning
關于消息實體的警告信息
Warn: 199 Miscellaneous warning

Responses 部分
Header
解釋
示例

Accept-Ranges
表明服務器是否支持指定范圍請求及哪種類型的分段請求
Accept-Ranges: bytes

Age
從原始服務器到代理緩存形成的估算時間（以秒計，非負）
Age: 12

Allow
對某網(wǎng)絡資源的有效的請求行為，不允許則返回405
Allow: GET, HEAD

Cache-Control
告訴所有的緩存機制是否可以緩存及哪種類型
Cache-Control: no-cache

Content-Encoding
web服務器支持的返回內(nèi)容壓縮編碼類型。
Content-Encoding: gzip

Content-Language
響應體的語言
Content-Language: en,zh

Content-Length
響應體的長度
Content-Length: 348

Content-Location
請求資源可替代的備用的另一地址
Content-Location: /index.htm

Content-MD5
返回資源的MD5校驗值
Content-MD5: Q2hlY2sgSW50ZWdyaXR5IQ==

Content-Range
在整個返回體中本部分的字節(jié)位置
Content-Range: bytes 21010-47021/47022

Content-Type
返回內(nèi)容的MIME類型
Content-Type: text/html; charset=utf-8

Date
原始服務器消息發(fā)出的時間
Date: Tue, 15 Nov 2010 08:12:31 GMT

ETag
請求變量的實體標簽的當前值
ETag: “737060cd8c284d8af7ad3082f209582d”

Expires
響應過期的日期和時間
Expires: Thu, 01 Dec 2010 16:00:00 GMT

Last-Modified
請求資源的最后修改時間
Last-Modified: Tue, 15 Nov 2010 12:45:26 GMT

Location
用來重定向接收方到非請求URL的位置來完成請求或標識新的資源
Location: http://www.zcmhi.com/archives/94.html

Pragma
包括實現(xiàn)特定的指令，它可應用到響應鏈上的任何接收方
Pragma: no-cache

Proxy-Authenticate
它指出認證方案和可應用到代理的該URL上的參數(shù)
Proxy-Authenticate: Basic

refresh
應用于重定向或一個新的資源被創(chuàng)造，在5秒之后重定向（由網(wǎng)景提出，被大部分瀏覽器支持）

Refresh: 5; url=
http://www.zcmhi.com/archives/94.html

Retry-After
如果實體暫時不可取，通知客戶端在指定時間之后再次嘗試
Retry-After: 120

Server
web服務器軟件名稱
Server: Apache/1.3.27 (Unix) (Red-Hat/Linux)

Set-Cookie
設置Http Cookie
Set-Cookie: UserID=JohnDoe; Max-Age=3600; Version=1

Trailer
指出頭域在分塊傳輸編碼的尾部存在
Trailer: Max-Forwards

Transfer-Encoding
文件傳輸編碼
Transfer-Encoding:chunked

Vary
告訴下游代理是使用緩存響應還是從原始服務器請求
Vary: *

Via
告知代理客戶端響應是通過哪里發(fā)送的
Via: 1.0 fred, 1.1 nowhere.com (Apache/1.1)

Warning
警告實體可能存在的問題
Warning: 199 Miscellaneous warning

WWW-Authenticate
表明客戶端請求實體應該使用的授權方案
WWW-Authenticate: Basic

3.2 params的示例

[html] view plain copy

派生到我的代碼片
派生到我的代碼片

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

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

[html] view plain copy

派生到我的代碼片
派生到我的代碼片

@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"的請求，同時暗示了返回的內(nèi)容類型為application/json;

  1. 總結
    在本文中，首先介紹了Content-Type主要支持的格式內(nèi)容，然后基于@RequestMapping標注的內(nèi)容介紹了主要的使用方法，其中,headers, consumes,produces,都是使用Content-Type中使用的各種媒體格式內(nèi)容，可以基于這個格式內(nèi)容來進行訪問的控制和過濾。
    參考資料：
  2. HTTP中支持的Content-Type: http://tool.oschina.NET/commons
  3. Media Type介紹。 http://www.iteye.com/topic/1127120
最后編輯于 ：
?著作權歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成，瀏覽時請結合常識與多方信息審慎甄別。
平臺聲明：文章內(nèi)容（如有圖片或視頻亦包括在內(nèi)）由作者上傳并發(fā)布，文章內(nèi)容僅代表作者本人觀點，簡書系信息發(fā)布平臺，僅提供信息存儲服務。

相關閱讀更多精彩內(nèi)容

友情鏈接更多精彩內(nèi)容