Post方式與引數詳解

阿新 • • 發佈：2018-11-05

定義和用法

enctype 屬性規定在傳送到伺服器之前應該如何對錶單資料進行編碼。
預設地，表單資料會編碼為 "application/x-www-form-urlencoded"。就是說，在傳送到伺服器之前，所有字元都會進行編碼（空格轉換為 "+" 加號，特殊符號轉換為 ASCII HEX 值）。

enctype屬性值

值	描述
application/x-www-form-urlencoded	在傳送前編碼所有字元（預設）
multipart/form-data	不對字元編碼。在使用包含檔案上傳控制元件的表單時，必須使用該值。
text/plain	空格轉換為 "+" 加號，但不對特殊字元編碼。

值

描述

application/x-www-form-urlencoded

在傳送前編碼所有字元（預設）

multipart/form-data

不對字元編碼。

在使用包含檔案上傳控制元件的表單時，必須使用該值。

text/plain

空格轉換為 "+" 加號，但不對特殊字元編碼。

HTTP/1.1 協議規定的 HTTP 請求方法有 OPTIONS、GET、HEAD、POST、PUT、DELETE、TRACE、CONNECT 這幾種。
其中 POST 一般用來向服務端提交資料，本文主要討論 POST 提交資料的幾種方式。

我們知道，HTTP 協議是以 ASCII 碼傳輸，建立在 TCP/IP 協議之上的應用層規範。
規範把 HTTP 請求分為三個部分：狀態行、請求頭、訊息主體。類似於下面這樣：

BASH<method> <request-URL> <version>
<headers>

<entity-body>

協議規定 POST 提交的資料必須放在訊息主體（entity-body）中，但協議並沒有規定資料必須使用什麼編碼方式。實際上，開發者完全可以自己決定訊息主體的格式，只要最後傳送的 HTTP 請求滿足上面的格式就可以。

但是，資料傳送出去，還要服務端解析成功才有意義。一般服務端語言如 php、python 等，以及它們的 framework，都內建了自動解析常見資料格式的功能。
服務端通常是根據請求頭（headers）中的 Content-Type

欄位來獲知請求中的訊息主體是用何種方式編碼，再對主體進行解析。
所以說到 POST 提交資料方案，包含了 Content-Type 和訊息主體編碼方式兩部分。
下面就正式開始介紹它們。

application/x-www-form-urlencoded

這應該是最常見的 POST 提交資料的方式了。瀏覽器的原生 <form> 表單，如果不設定 enctype 屬性，那麼最終就會以 application/x-www-form-urlencoded 方式提交資料。

<form action="form_action.asp" enctype="text/plain">
  <p>First name: <input type="text" name="fname" /></p>
  <p>Last name: <input type="text" name="lname" /></p>
  <input type="submit" value="Submit" />
</form>

此時Form提交的請求資料，抓包時看到的請求會是這樣的內容（無關的請求頭在本文中都省略掉了）：

BASHPOST http://www.example.com HTTP/1.1
Content-Type: application/x-www-form-urlencoded;charset=utf-8
title=test&sub%5B%5D=1&sub%5B%5D=2&sub%5B%5D=3

首先，Content-Type 被指定為 application/x-www-form-urlencoded；其次，提交的資料按照 key1=val1&key2=val2 的方式進行編碼，key 和 val 都進行了 URL 轉碼。
大部分服務端語言都對這種方式有很好的支援。例如 PHP 中，$_POST['title'] 可以獲取到 title 的值，$_POST['sub'] 可以得到 sub 陣列。

很多時候，我們用 Ajax 提交資料時，也是使用這種方式。
例如 JQuery 和 QWrap 的 Ajax，Content-Type 預設值都是「application/x-www-form-urlencoded;charset=utf-8」。

multipart/form-data

這又是一個常見的 POST 資料提交的方式。我們使用表單上傳檔案時，必須讓 <form> 表單的enctype 等於 multipart/form-data。直接來看一個請求示例：

BASHPOST http://www.example.com HTTP/1.1
Content-Type:multipart/form-data; boundary=----WebKitFormBoundaryrGKCBY7qhFd3TrwA

------WebKitFormBoundaryrGKCBY7qhFd3TrwA
Content-Disposition: form-data; name="text"

title
------WebKitFormBoundaryrGKCBY7qhFd3TrwA
Content-Disposition: form-data; name="file"; filename="chrome.png"
Content-Type: image/png

PNG ... content of chrome.png ...
------WebKitFormBoundaryrGKCBY7qhFd3TrwA--

這個例子稍微複雜點。首先生成了一個 boundary 用於分割不同的欄位，為了避免與正文內容重複，boundary 很長很複雜。然後 Content-Type 裡指明瞭資料是以 multipart/form-data 來編碼，本次請求的 boundary 是什麼內容。訊息主體裡按照欄位個數又分為多個結構類似的部分，每部分都是以 --boundary 開始，緊接著是內容描述資訊，然後是回車，最後是欄位具體內容（文字或二進位制）。如果傳輸的是檔案，還要包含檔名和檔案型別資訊。訊息主體最後以 --boundary-- 標示結束。
關於 multipart/form-data 的詳細定義，請前往 rfc1867 檢視。

這種方式一般用來上傳檔案，各大服務端語言對它也有著良好的支援。

上面提到的這兩種 POST 資料的方式，都是瀏覽器原生支援的，而且現階段標準中原生 <form> 表單也只支援這兩種方式（通過 <form> 元素的 enctype 屬性指定，預設為 application/x-www-form-urlencoded。其實 enctype 還支援 text/plain，不過用得非常少）。

隨著越來越多的 Web 站點，尤其是 WebApp，全部使用 Ajax 進行資料互動之後，我們完全可以定義新的資料提交方式，給開發帶來更多便利。

application/json

application/json 這個 Content-Type 作為響應頭大家肯定不陌生。實際上，現在越來越多的人把它作為請求頭，用來告訴服務端訊息主體是序列化後的 JSON 字串。由於 JSON 規範的流行，除了低版本 IE 之外的各大瀏覽器都原生支援 JSON.stringify，服務端語言也都有處理 JSON 的函式，使用 JSON 不會遇上什麼麻煩。

JSON 格式支援比鍵值對複雜得多的結構化資料，這一點也很有用。記得我幾年前做一個專案時，需要提交的資料層次非常深，我就是把資料 JSON 序列化之後來提交的。不過當時我是把 JSON 字串作為 val，仍然放在鍵值對裡，以 x-www-form-urlencoded 方式提交。

Google 的 AngularJS 中的 Ajax 功能，預設就是提交 JSON 字串。例如下面這段程式碼：

JSvar data = {'title':'test', 'sub' : [1,2,3]};
$http.post(url, data).success(function(result) {
    ...
});

最終傳送的請求是：

BASHPOST http://www.example.com HTTP/1.1 
Content-Type: application/json;charset=utf-8

{"title":"test","sub":[1,2,3]}

這種方案，可以方便的提交複雜的結構化資料，特別適合 RESTful 的介面。各大抓包工具如 Chrome 自帶的開發者工具、Firebug、Fiddler，都會以樹形結構展示 JSON 資料，非常友好。但也有些服務端語言還沒有支援這種方式，例如 php 就無法通過 $_POST 物件從上面的請求中獲得內容。這時候，需要自己動手處理下：在請求頭中 Content-Type 為 application/json 時，從 php://input 裡獲得原始輸入流，再 json_decode 成物件。一些 php 框架已經開始這麼做了。

當然 AngularJS 也可以配置為使用 x-www-form-urlencoded 方式提交資料。如有需要，可以參考這篇文章。

text/xml

我的部落格之前提到過 XML-RPC（XML Remote Procedure Call）。它是一種使用 HTTP 作為傳輸協議，XML 作為編碼方式的遠端呼叫規範。典型的 XML-RPC 請求是這樣的：

HTMLPOST http://www.example.com HTTP/1.1 
Content-Type: text/xml

<?xml version="1.0"?>
<methodCall>
    <methodName>examples.getStateName</methodName>
    <params>
        <param>
            <value><i4>41</i4></value>
        </param>
    </params>
</methodCall>

XML-RPC 協議簡單、功能夠用，各種語言的實現都有。它的使用也很廣泛，如 WordPress 的 XML-RPC Api，搜尋引擎的 ping 服務等等。JavaScript 中，也有現成的庫支援以這種方式進行資料互動，能很好的支援已有的 XML-RPC 服務。不過，我個人覺得 XML 結構還是過於臃腫，一般場景用 JSON 會更靈活方便。

https://imququ.com/post/four-ways-to-post-data-in-http.html

rest api引數與content-type

最近為專案組提供rest api 時遇到了關於介面引數的傳遞問題，主要是沒有充分考慮到第三方呼叫者的使用方式，應該儘量的去相容公司之前提供出去的介面呼叫方式，這樣可以降低第三方呼叫者的學習成本，儘管之前的方式並不是那麼的推薦，好的做法是即相容老的做法也支援推薦的做法。

對於基於http post介面，Content-type我會優先選擇application/json,但公司之前提供的介面恰恰採用了application/x-www-form-urlencoded，它是表單預設的提交型別，基於key/value形式提交到服務端的。spring mvc是如何接收下面兩種經典資料的? (至於form-data，它即可以傳鍵值對也可以上傳檔案，這裡不涉及到檔案所以只討論下面兩種)：

Content-type=application/json：需要在引數上增加@RequestBody這個註解，說明引數是從http的requestbody中獲取。

下圖中的引數，是標準的json格式，對前端js非常友好。

Content-type=application/x-www-form-urlencoded，引數上不能增加@RequestBody的註解

下圖的可以看出引數形式與get請求時，URL後面的引數格式

為什麼不推薦採用application/x-www-form-urlencoded這種型別，它有如下問題：

測試困難,就別想通過postman這類工具測試：提交到服務端實際上是一個MultiValueMap(org.springframework.util.MultiValueMap或org.springframework.util.LinkedMultiValueMap)，
如果value中的物件也是一個物件，那麼在構建這個引數時就非常困難，看下它的過程
- 採用key1=value1&key2=value2這種形式將所有引數拼接起來，從一長串字元中想了解每個引數的含義沒有個好眼力怕是不行。
- value要進行編碼，編碼之後的對除錯者不友好。
- value是複雜物件的情況更加糟糕，一般只能通過程式來序列化得到引數，想手寫基本不可能。
客戶端呼叫複雜

需要去構建List<NameValuePair>，一般頁面傳遞的引數都是一個實體物件Model，需要額外的將這個Model轉換成List<NameValuePair>，如果這個物件複雜，那麼構建這個Key/Value就夠人煩的了。
這裡給一個java通過apache httpclient呼叫的對比，看看哪一個簡單。

application/x-www-form-urlencoded

需要手工將model轉換成NameValuePair。

application/json

這裡只需要Model即可，不需要二次轉換，結構也非常清楚。

key/value的語言表達形式沒有json強，下面兩種你更加喜歡哪一個呢？
字串

post man這類模似http請求的工具中，如果key對應的value是個物件，那麼你需要通過工具得到它的序列化之後的字串然後填寫到欄位中，想想都煩。如果你說我不需要通過這些模似工具測試，那就另當別論

- json

資料結構更加複雜

如果需要提交的物件非常複雜，屬性非常多，如果將所有的屬性都構建到MultiValueMap中，那個Map的構建會非常複雜，試想如果物件有多級巢狀物件呢。所有為了避免這個問題，我們將需要提交的業務物件做為一個key來儲存，value就是物件序列化之後的字串。再加了一些非業務引數，比如安全方面的token等引數，有效的降低了MultiValueMap構建的複雜度。但這種方式相對於json的傳遞方式來講層次更深。如下圖，我們的引數多了一層,jsonParam。

如果解決呢？
不能不相容現有的模式，但又想支援json，焦點就是在引數的接收上，讓其能夠完美的相容上述兩種引數傳遞，這裡可以從HttpMessageConverter著手，這個就是用來將請求的引數對映到spring mvc方法中的實體引數的。我們可以編寫一個自定義的類，內部借用FormHttpMessageConverter來接收MultiValueMap，即使方法引數上增加了@RequestBody的註解，也會走我們自定義的converter，就有機會去重新給引數賦值。

這個方法中需要解決一個問題，就是客戶端傳遞時每個引數都是當成字串來處理的，這種導致我們通過FormHtppMessageConverter轉換成Map時，原本是物件的屬性被識別成字串，而不是object，結果就是在反序列化時會出錯。好在，上面我們將需要提交的物件包裝了一次，產生一個公共的object引數jsonParam，只需要處理這一個特殊物件。做法就是從Map取出jsonParam，然後對其內容進行反序列化，更新Map值，再次進行反序列化就正常了。

上圖中的做法目前有如下問題

序列化的欄位是約定好的，也是基於我們的post model基本上來處理的，是針對性的converter
程式碼最後面呼叫的jackon的convertValue，對需要反序列化的物件型別有要求，好像不支援泛型型別，比如這種型別的就不行： CommonParamInfoDto<SearchParamInfo<ProductSearchInfo>>

完整的conveter程式碼如下，其實主要程式碼就是上圖貼圖中的那麼對特定欄位的序列化處理，其它的方法都是預設即可。

public class ObjectHttpMessageConverter implements HttpMessageConverter<Object> {

    private final FormHttpMessageConverter formHttpMessageConverter = new FormHttpMessageConverter();
    private final ObjectMapper objectMapper = new ObjectMapper();

    private static final LinkedMultiValueMap<String, ?> LINKED_MULTI_VALUE_MAP = new LinkedMultiValueMap<>();
    private static final Class<? extends MultiValueMap<String, ?>> LINKED_MULTI_VALUE_MAP_CLASS
            = (Class<? extends MultiValueMap<String, ?>>) LINKED_MULTI_VALUE_MAP.getClass();

    @Override
    public boolean canRead(Class clazz, MediaType mediaType) {
        return objectMapper.canSerialize(clazz) && formHttpMessageConverter.canRead(MultiValueMap.class, mediaType);
    }

    @Override
    public boolean canWrite(Class clazz, MediaType mediaType) {
        return false;
    }

    @Override
    public List<MediaType> getSupportedMediaTypes() {
        return formHttpMessageConverter.getSupportedMediaTypes();
    }


    @Override
    public Object read(Class clazz, HttpInputMessage inputMessage) throws IOException, HttpMessageNotReadableException {
        Map input = formHttpMessageConverter.read(LINKED_MULTI_VALUE_MAP_CLASS, inputMessage).toSingleValueMap();
        String jsonParamKey="jsonParam";
        if(input.containsKey(jsonParamKey)) {
            String jsonParam = input.get(jsonParamKey).toString();
            SearchParamInfo<Object> searchParamInfo = new SearchParamInfo<Object>();
            Object jsonParamObj = JsonHelper.json2Object(jsonParam, searchParamInfo.getClass());
            input.put("jsonParam", jsonParamObj);
        }
        Object objResult= objectMapper.convertValue(input, clazz);
        return objResult;
    }

    @Override
    public void write(Object o, MediaType contentType, HttpOutputMessage outputMessage) throws UnsupportedOperationException {
        throw new UnsupportedOperationException("");
    }
}

配置，寫好了conveter之後，需要在配置檔案中配置上才能生效。

最後，我們的方法就可以這樣寫，即可以支援 key/value對，也支援json

我的目的在於api的引數即能支援application/x-www-form-urlencoded也能支援application/json，上面是我目前能想到的辦法，如果大家有其它更好的辦法多多指點。

根據上面的描述，可以得到以下結論：
物件將轉換成什麼樣的內容型別很大程式上取決於傳遞給put方法的型別，
如果給定一個String值，那麼將會使用StringHttpMessageConverter，這個值直接被寫到請求體中，內容型別設定為"text/plain"
如果給定一個MultiValueMap<String,String>，那麼這個Map中的值會被FormHttpMessageConverter以“application/x-www-form-urlencoded”的格式寫到請求體中
因為給定的是一個自定義物件，所以需要一個能夠處理任意物件的資訊轉換器。如果在類路徑下包含Jackson2庫，那麼MappingJacksonHttpMessageConverter將以application/json格式將自定義物件寫到請求中

我又可以愉快的使用post man測試了。而且可以推薦第三方呼叫者優先使用json，我相信這種即能簡化程式設計又方便除錯的優點應該能夠吸引它們。

http://www.cnblogs.com/ASPNET2008/p/5744815.html

postman中 form-data、x-www-form-urlencoded、raw、binary的區別

1、form-data:
就是http請求中的multipart/form-data,它會將表單的資料處理為一條訊息，以標籤為單元，用分隔符分開。既可以上傳鍵值對，也可以上傳檔案。當上傳的欄位是檔案時，會有Content-Type來表名檔案型別；content-disposition，用來說明欄位的一些資訊；
由於有boundary隔離，所以multipart/form-data既可以上傳檔案，也可以上傳鍵值對，它採用了鍵值對的方式，所以可以上傳多個檔案。

新版本Postman在此處檢視：

2、x-www-form-urlencoded：
就是application/x-www-from-urlencoded,會將表單內的資料轉換為鍵值對，比如,name=java&age = 23

3、raw
可以上傳任意格式的文字，可以上傳text、json、xml、html等

4、binary
相當於Content-Type:application/octet-stream,從字面意思得知，只可以上傳二進位制資料，通常用來上傳檔案，由於沒有鍵值，所以，一次只能上傳一個檔案。

multipart/form-data與x-www-form-urlencoded區別
multipart/form-data：既可以上傳檔案等二進位制資料，也可以上傳表單鍵值對，只是最後會轉化為一條資訊；
x-www-form-urlencoded：只能上傳鍵值對，並且鍵值對都是間隔分開的。

http://blog.csdn.net/ye1992/article/details/49998511

上傳檔案的表單中<form>要加屬性enctype="multipart/form-data",很多人只是死記硬背知道上傳表單要這麼寫，知其然而不知其所以然。那到底為什麼要新增這個屬性呢？它是什麼意思呢？它又有什麼其他可選值呢？其實form表單在你不寫enctype屬性時，也預設為其添加了enctype屬性值，預設值是enctype="application/x- www-form-urlencoded".這個屬性管理的是表單的MIME編碼，共有三個值可選：
　　①application/x-www-form-urlencoded (預設值)
　　②multipart/form-data
　　③text/plain

　　其中①application/x-www-form-urlencoded是預設值，大家可能在AJAX裡見過這個：xmlHttp.setRequestHeader("Content-Type","application/x-www-form- urlencoded"); 這兩個要做的是同一件事情，就是設定表單傳輸的編碼。在AJAX裡不寫有可能會報錯，但是在HTML的form表單裡是可以不寫 enctype="application/x-www-form-urlencoded"的，因為預設HTML表單就是這種傳輸編碼型別。而 ②multipart-form-data是用來指定傳輸資料的特殊型別的，主要就是我們上傳的非文字的內容，比如圖片或者mp3等等。 ③text/plain是純文字傳輸的意思，在傳送郵件時要設定這種編碼型別，否則會出現接收時編碼混亂的問題，網路上經常拿text/plain和 text/html做比較，其實這兩個很好區分，前者用來傳輸純文字檔案，後者則是傳遞html程式碼的編碼型別，在傳送標頭檔案時才用得上。①和③都不能用於上傳檔案，只有multipart/form-data才能完整的傳遞檔案資料。

　　上面提到的MIME，它的英文全稱是"Multipurpose Internet Mail Extensions" 多功能Internet 郵件擴充服務，它是一種多用途網際郵件擴充協議，在1992年最早應用於電子郵件系統，但後來也應用到瀏覽器。伺服器會將它們傳送的多媒體資料的型別告訴瀏覽器，而通知手段就是說明該多媒體資料的MIME型別，從而讓瀏覽器知道接收到的資訊哪些是MP3檔案，哪些是Shockwave檔案等等。伺服器將 MIME標誌符放入傳送的資料中來告訴瀏覽器使用哪種外掛讀取相關檔案。

　　簡單說，MIME型別就是設定某種副檔名的檔案用一種應用程式來開啟的方式型別，當該副檔名檔案被訪問的時候，瀏覽器會自動使用指定應用程式來開啟。多用於指定一些客戶端自定義的檔名，以及一些媒體檔案開啟方式。

　　瀏覽器接收到檔案後，會進入外掛系統進行查詢，查找出哪種外掛可以識別讀取接收到的檔案。如果瀏覽器不清楚呼叫哪種外掛系統，它可能會告訴使用者缺少某外掛，或者直接選擇某現有外掛來試圖讀取接收到的檔案，後者可能會導致系統的崩潰。傳輸的資訊中缺少MIME標識可能導致的情況很難估計，因為某些計算機系統可能不會出現什麼故障，但某些計算機可能就會因此而崩潰。

檢查一個伺服器是否正確設定了MIME型別的步驟是：

　　1. 在Netscape瀏覽器中開啟伺服器網頁
　　2. 進入"View"選單，選擇"Page Info"
　　3. 在彈出的視窗中點選上層框架中的"EMBED"
　　4. 在下層框架中檢視MIME的型別是否為"application/x-director"或"application/x-shockwave- flash"，如果是上述資訊的話表明伺服器已經正確設定了MIME型別；
而如果MIME型別列出的是文字內容、八位一組的資料或是其它形式均表明伺服器的MIME型別沒有設定正確。

　　如果伺服器沒有正確標明其傳送的資料的型別，伺服器管理員應該正確新增相關資訊，具體操作方法非常簡單快捷。

　　每個MIME型別由兩部分組成，前面是資料的大類別，例如聲音audio、圖象image等，後面定義具體的種類。

　　常見的MIME型別

　　　　超文字標記語言文字 .html,.html text/html

　　　　普通文字 .txt text/plain

　　　　RTF文字 .rtf application/rtf

　　　　GIF圖形 .gif image/gif

　　　　JPEG圖形 .jpeg,.jpg image/jpeg

　　　　au聲音檔案 .au audio/basic

　　　　MIDI音樂檔案 mid,.midi audio/midi,audio/x-midi

　　　　RealAudio音樂檔案 .ra, .ram audio/x-pn-realaudio

　　　　MPEG檔案 .mpg,.mpeg video/mpeg

　　　　AVI檔案 .avi video/x-msvideo

　　　　GZIP檔案 .gz application/x-gzip

　　　　TAR檔案 .tar application/x-tar

Internet中有一個專門組織IANA來確認標準的MIME型別，但Internet發展的太快，很多應用程式等不及IANA來確認他們使用的MIME型別為標準型別。因此他們使用在類別中以x-開頭的方法標識這個類別還沒有成為標準，例如：x-gzip，x-tar等。事實上這些型別運用的很廣泛，已經成為了事實標準。只要客戶機和伺服器共同承認這個MIME型別，即使它是不標準的型別也沒有關係，客戶程式就能根據MIME型別，採用具體的處理手段來處理資料。而Web伺服器和瀏覽器（包括作業系統）中，預設都設定了標準的和常見的MIME型別，只有對於不常見的 MIME型別，才需要同時設定伺服器和客戶瀏覽器，以進行識別。
----------------------------------------------------------------
表單中enctype="multipart/form-data"的意思，是設定表單的MIME編碼。預設情況，
這個編碼格式是application/x-www-form-urlencoded，不能用於檔案上傳；
只有使用了multipart/form-data，才能完整的傳遞檔案資料，進行下面的操作.
enctype="multipart/form-data"是上傳二進位制資料; form裡面的input的值以2進位制的方式傳過去。
form裡面的input的值以2進位制的方式傳過去，
所以request就得不到值了。也就是說加了這段程式碼,用request就會傳遞不成功,取表單值加入資料庫時，用到下面的：

SmartUpload su = new SmartUpload();//新建一個SmartUpload物件
su.getRequest().getParameterValues();取陣列值
su.getRequest().getParameter( );取單個引數單個值

ajax中的application/x-www-form-urlencoded中的使用

一，HTTP上傳的基本知識

在Form元素的語法中，EncType表明提交資料的格式用 Enctype 屬性指定將資料回發到伺服器時瀏覽器使用的編碼型別。下邊是說明： application/x-www-form-urlencoded：窗體資料被編碼為名稱/值對。這是標準的編碼格式。 multipart/form-data：窗體資料被編碼為一條訊息，頁上的每個控制元件對應訊息中的一個部分。 text/plain：窗體資料以純文字形式進行編碼，其中不含任何控制元件或格式字元。
補充
form的enctype屬性為編碼方式，常用有兩種：application/x-www-form-urlencoded和multipart/form-data，預設為application /x-www-form-urlencoded。

當action為get時候，瀏覽器用x-www-form-urlencoded的編碼方式把form資料轉換成一個字串（name1=value1& amp; amp;name2=value2...），然後把這個字串append到url後面，用?分割，載入這個新的url。

當action為post時候，瀏覽器把form資料封裝到http body中，然後傳送到server。

如果沒有type=file的控制元件，用預設的application/x-www-form-urlencoded就可以了。但是如果有 type=file的話，就要用到multipart/form-data了。
瀏覽器會把整個表單以控制元件為單位分割，併為每個部分加上 Content-Disposition(form-data或者file),Content-Type(預設為text/plain),name(控制元件 name)等資訊，並加上分割符(boundary)。

二，使用中需要注意的地方

在AJAX往伺服器上傳資料是，設定了content-type為application/x-www-form-urlencoded，此時是對整個發送內容作了編碼，並不是對名字對應的值做了編碼。因此，在伺服器端，通過request.getParameter("name")的方式取值，是有問題的。

有兩種解法辦法：

1）改伺服器端：採用流的方式硬編碼

InputStream stream=request.getInputStream();
InputStreamReader isr=new InputStreamReader(stream);
BufferedReader br=new BufferedReader(isr);
String str=br.readLine(); 
System.out.println(str);

str=URLDecoder.decode(str,"gb2312");
System.out.println(str);
br.close();

2）改客戶端：更改資料傳送結構

在往伺服器上發資料的時候，使用name=escape(value)的方式組對

此時在伺服器程式碼中，通過request.getParameter("name")獲得的數值，就不用編碼了

application/x-www-form-urlencoded、multipart/form-data、text/plain

http://www.cnblogs.com/mumue/archive/2012/05/24/2515984.html

org.springframework.web.HttpMediaTypeNotSupportedException: Content type 'multipart/form-data;boundary=----WebKitFormBoundaryRAYPKeHKTYSNdzc1;charset=UTF-8' not supported

最近同事在做一個圖片上傳功能、在入參 body 中同時傳入檔案和其它基本資訊結果出現如題異常、在此記錄下解決辦法、以做記錄。

controller 程式碼如下：

@RequestMapping(value = "/upload", method =RequestMethod.POST)
@ResponseBody
public String upload(@RequestParam("file") MultipartFile file, @RequestBody User user) {
// 業務處理
......
......

}

在使用工具測試（Postman、 swagger ）時報如下異常

  "timestamp": 1473349676109,
  "status": 415,
  "error": "Unsupported Media Type",
  "exception": "org.springframework.web.HttpMediaTypeNotSupportedException",
  "message": "Content type 'multipart/form-data;boundary=----WebKitFormBoundaryTVc9eDC2a2elulOx;charset=UTF-8' not supported",
  "path": "/upload"

解決方案：

去掉 @RequestBody 註解就行了
原因：使用在進行圖片或者檔案上傳時 multipart/form-data 型別時、資料會自動進行對映不要新增任何註解。
加了@RequestBody後，所以引數都會轉換成JSON,會影響 POST中上報資料流的格式
https://www.cnblogs.com/yueli/p/7552888.html

關鍵詞：理解 http 訊息頭
使用 multipart form-data 上傳檔案
以前的章節已經介紹過了form傳輸表單的形式，但是在使用過程中仍然有很多問題，這裡再向大家詳細介紹一下。

multipart/form-data是上傳檔案的一種方式。multipart/form-data其實就是瀏覽器用表單上傳檔案的方式。
最常見的情境是：在寫郵件時，向郵件後新增附件，附件通常使用表單新增，也就是用multipart/form-data格式上傳到伺服器。

具體的步驟如下：

1、客戶端和伺服器建立連結（tcp協議）
2、客戶端可以向伺服器傳送資料
3、客戶端按照符合multipart/form-data的格式傳送資料

post /top/router/rest ?timestamp=2013-05-24%2010%3a14%3a48&method=taobao.item.update&title=title%20998&session=610231517b65e4e4e82575817e2d9169eeaac271cb91c55378591009&app_key=10011050&v=2.0&num_iid=13068812771&format=js on&sign=6570c00315a94edac47414b6e9b681e0 http/1.0
content-type: multipart/form-data; boundary=------webkitformboundaryx3mhup4uhvo8zy3o
accept-charset: utf-8
host: gw.api.taobao.com
connection: close
content-length: 58294

--------webkitformboundaryx3mhup4uhvo8zy3o
content-disposition: form-data; name="image"; filename="path\ddd.jpg"
content-type: image/gif

......jfif.............c..................................省略的圖片檔案資訊
--------webkitformboundaryx3mhup4uhvo8zy3o--
解釋說明

content-type: multipart/form-data; boundary=------webkitformboundaryx3mhup4uhvo8zy3o
說明的是multipart/form-data格式的請求，boundary是一個字串，用來切分資料。
仔細檢視，會發現body裡面的bounday比header裡面的前面都多了“--”。這是一個坑，我被搬到過。

需要注意的是，在html協議中換行使用的是:"\r\n"，這我也被絆倒過。

下面是lua拼寫的上傳伺服器的程式碼：

body = "--------webkitformboundaryx3mhup4uhvo8zy3o\r\ncontent-disposition: form-data; name=\"image\"; filename=\"path\\ddd.jpg\"\r\ncontent-type: image/gif\r\n\r\n" .. body;
body = body .. "\r\n--------webkitformboundaryx3mhup4uhvo8zy3o--\r\n";

搜尋此文相關文章：理解HTTP訊息頭五——使用multipart/form-data上傳檔案
此文連結：http://www.makaidong.com/%E5%8D%9A%E5%AE%A2%E5%9B%AD%E6%90%9C/30170.shtml

postman進行訪問伺服器時，使用瀏覽器的url可以正常返回結果，但是postman卻顯示Could not get any response

Could not get any response  
This seems to be like an error connecting to http://pc.oma.com:9090/oma/venue/updateVenue.  
Why this might have happened:  
The server couldn't send a response:  
Ensure that the backend is working properly  
SSL connections are being blocked:  
Fix this by importing SSL certificates in Chrome  
Cookies not being sent:  
Use the Postman Interceptor extension  
Request timeout:  
Change request timeout in Settings > General

解決辦法：

關閉防火牆。
https://blog.csdn.net/sunny_12138/article/details/79196107

Post方式與引數詳解

定義和用法

enctype屬性值

application/x-www-form-urlencoded

multipart/form-data

application/json

text/xml

rest api引數與content-type

ajax中的application/x-www-form-urlencoded中的使用

Post方式與引數詳解

Rsync 服務部署與引數詳解

Redis持久化方式RDB與AOF詳解

JVM堆記憶體管理與自定義分配引數詳解

requests.post()方法中的data、json引數詳解

對SVM與核函式的理解及sklearn引數詳解

Java Spring Data Redis實戰與配置引數詳解 application.properties

create table ,create as 與create like三種建表方式的使用詳解

dhcpcd引數詳解與總結

關於AngularJs中$http post、get 傳送和接受引數詳解

pandas系列 read_csv 與 to_csv 方法各引數詳解（全，中文版）

Nginx安裝目錄與編譯引數詳解

C C++帶多個引數的巨集(...與__VA_ARGS__詳解)

python介面自動化（四十一）- 發xml格式引數的post請求（超詳解）

HTTP 中 GET 與 POST 的區別（詳解）

Javascript中的apply與call詳解

let與const詳解

MySQL5.6 數據庫主從（Master/Slave）同步安裝與配置詳解

Js中JSON.stringify()與JSON.parse()與eval()詳解及使用案例

AngularJS 過濾與排序詳解及實例代碼

Post方式與引數詳解

定義和用法

enctype屬性值

application/x-www-form-urlencoded

multipart/form-data

application/json

text/xml

ajax中的application/x-www-form-urlencoded中的使用

相關推薦