接口測試中模擬post四種請求數據

https://www.jianshu.com/p/3b6d7aa2043a

 

1、背景介紹

在平常的接口測試工做中，模擬接口請求一般有兩種方法，fiddler模擬和HttpClient模擬。

Fiddler是一個簡單的http協議調試代理工具，它界面友好，易於操做，是模擬http請求的利器之一。
而咱們常說的HttpClient工具包，追根溯源是Apache基金的HttpComponent項目的一個組成部分。HttpComponent有三個主要組成部分，分別是HttpCore、HttpClient以及AsynchHttpClient。按照HttpComponent官網的介紹，HttpCore是底層的HTTP傳輸組件，用最小的內存來實現模擬客戶端和服務器端的Http請求。HttpClient則是基於HttpCore實現的Http請求模擬代理， 能夠用來提供高效的、最新的、功能豐富的支持HTTP協議的客戶端編程工具包。Asynch HttpClient也是基於HttpCore的，顧名思義則是用於處理大量併發請求時的http代理。不一樣格式的數據經過這兩種模擬方法的處理方式不一樣。

在接口測試中，接口一般是get請求或者post請求。get請求的測試通常較爲簡單，只需設置好相關的請求頭，url寫正確便可。可是在測試post請求時，請求數據格式的設置每每就稍顯複雜。尤爲是在開發人員的接口文檔描述不清楚的狀況下，會影響到測試效率。

故而本文總結了下post請求常見的四種數據格式和他們對應的fiddler、HttpClient模擬請求的構造方法。

---

2、post請求主體詳解

一個正常的post請求主要包括請求行，請求頭，請求主體，也就是
 <method><url><version> <headers> <entity-body> 

對於get請求來講沒有請求主體entity-body。對於post請求而言，不會對發送請求的數據格式進行限制，理論上你能夠發任意數據，可是服務器能不能處理就是另外一回事了。服務器收到數據後，如何解析數據呢？它會以請求頭中的Content-Type設置的內容來進行數據解析。肯定好Content-Type的格式以後，請求主體的數據格式也就肯定下來了。Content-Type的格式有四種：分別是application/x-www-form-urlencoded（這也是默認格式）、application/json、text/xml以及multipart/form-data格式。
這些不一樣的post請求數據格式要經過HttpEntity來構造，有必要簡單理一下HttpClient的HttpEntity對象，由於全部的post請求數據均須要置於HttpEntity實體中進行發送。HttpEntity是一個接口，實現這個接口的具體類有不少，比較經常使用的是StringEntity、UrlEncodedFormEntity（繼承自StringEntity）、MultipartEntity。他們將在發送不一樣格式的post請求時被用到。接下來就詳細地介紹每一種數據格式對應的fiddler請求模擬和httpClient請求模擬（java實現）的實現狀況。

---

3、四種Post請求數據格式和fiddler和HttpClient模擬請求構造

（一）application/x-www-form-urlencoded數據格式

在W3C官網上明確對這種數據格式進行了定義：
This is the default content type. Forms submitted with this content type must be encoded as follows:
Control names and values are escaped. Space characters are replaced by '+', and then reserved characters are escaped as described in [RFC1738], section 2.2: Non-alphanumeric characters are replaced by '%HH', a percent sign and two hexadecimal digits representing the ASCII code of the character. Line breaks are represented as "CR LF" pairs (i.e., '%0D%0A').The control names/values are listed in the order they appear in the document. The name is separated from the value by '=' and name/value pairs are separated from each other by '&'.

這是post請求最多見也是默認的數據提交格式。它要求數據名稱（name）和數據值（value）之間以等號相連，與另外一組name/value值之間用&相連。例如：parameter1=12345&parameter2=23456。將請求的內容進行格式化了，其實這個方法同時簡化的客戶端發送，也簡化了服務器端獲取，服務器經過getParameters（String name）便可獲取到傳送來的信息。
咱們看下如何分別用fiddler和HttpClient的話模擬post請求。
（1）若是用fiddler模擬請求的話，請求頭和請求主體的內容能夠這樣構造：

 

 

模擬請求以後，從返回結果能夠查看到咱們的請求數據：

 

 

（2）若是用HttpClient模擬post請求的話，請求能夠這樣構造：

DefaultHttpClient client = new DefaultHttpClient(); List<BasicNameValuePair> params = new ArrayList<BasicNameValuePair>(); //定義鍵值對列表，用於存放向url發送post請求的數據。 params.add(new BasicNameValuePair("parameter1", "12345")); params.add(new BasicNameValuePair("parameter2", "23456")); //向params設置數據 HttpPost post = new HttpPost("http://example.com"); //定義HttpPost對象並初始化它 HttpEntity reqEntity = new UrlEncodedFormEntity(params); //用UrlEncodedFormEntity對象包裝請求體數據 post.setEntity(reqEntity); //設置post請求實體 HttpResponse response = client.execute(post); //發送http請求 System.out.println("the request body is:"+EntityUtils.toString(reqEntity)); //打印出請求實體 System.out.println(response.getStatusLine().getStatusCode()); //打印http請求返回碼 

**（二）application/json數據格式 **
application/json格式的請求頭是指用來告訴服務端post過去的消息主體是序列化後的 JSON 字符串。
（1）若是用fiddler模擬請求的話，請求頭和請求主體的內容能夠這樣構造：

 

 

模擬請求以後，從返回結果能夠看到咱們的請求數據：

 

 

 

（2）若是用HttpClient模擬post請求的話，請求能夠這樣構造：

HttpClient client = new DefaultHttpClient(); JSONObject js = new JSONObject(); //定義一個JSON數據格式對象，用其保存請求主體數據。 js.element("parameter1", "12345"); //爲JSON對象的各個key值賦值 js.element("parameter2","23456"); String postRequest = js.toString(); HttpPost post = new HttpPost("http://example.com"); //定義HttpPost對象並初始化它 StringEntity reqEntity = new StringEntity(js.toString()); //用StringEntity對象包裝請求體數據 reqEntity.setContentType("application/json"); //設置請求頭數據傳輸格式 post.setEntity(reqEntity); //設置post請求實體 HttpResponse response = client.execute(post); //發送http請求 System.out.println("the request body is:"+EntityUtils.toString(reqEntity)); //打印出請求實體 System.out.println(response.getStatusLine().getStatusCode()); //打印http請求返回碼 

這裏咱們能夠發現HttpClient模擬post請求時，請求頭格式爲application/x-www-form-urlencoded與application/json的主要差異在於請求主體的構造格式（前者是鍵值對，後者是JSON串）以及包裝請求體數據用的方法不一樣（前者是UrlEncodedFormEntity，後者是StringEntity）。
** （三）text/xml數據格式 **
（1）若是用fiddler模擬請求的話，請求頭和請求主體的內容能夠這樣構造：

 

 

模擬請求以後，從返回結果能夠看到咱們的請求數據：

 

 

（2）若是用HttpClient模擬post請求的話，請求能夠這樣構造：

Document doc = DocumentHelper.createDocument(); //建立document對象 Element book = doc.addElement("book"); //構建document對象各個節點 book.addElement("title").addText("羋月傳"); book.addElement("author").addText("蔣勝男"); String body = book.asXML(); //Document對象轉成string類型 StringEntity reqEntity = new StringEntity(body); //用StringEntity對象包裝請求體數據 reqEntity.setContentType("text/xml"); //設置請求頭數據傳輸格式 reqEntity.setContentEncoding("utf-8"); //設置請求頭數據編碼格式 HttpPost post = new HttpPost("http://example.com"); //定義HttpPost對象並初始化它 post.setEntity(reqEntity); //設置post請求實體 HttpResponse response = client.execute(post); //發送http請求 System.out.println("the request body is:"+EntityUtils.toString(reqEntity)); //打印出請求實體 System.out.println(response.getStatusLine().getStatusCode()); //打印http請求返回碼 

（四）multipart/form-data數據格式
除了傳統的application/x-www-form-urlencoded表單，咱們另外一個常常用到的是上傳文件用的表單，這種表單的類型爲multipart/form-data。在HttpClient程序擴展包（HttpMime）中專門有一個類與之對應，那就是MultipartEntity類。此類一樣實現了HttpEntity接口。
（1）若是用fiddler模擬請求的話，請求頭和請求主體的內容能夠這樣構造：
第一步，先設置好請求頭格式，而後點擊upload file...

 

 

第二步，上傳你的文件，這裏我上傳一個png的圖片

 

 

這是fiddler根據咱們上傳的文件自動調整生成的請求，在請求頭中看到，咱們須要選擇一段數據做爲「分割邊界」（boundary屬性），這個「邊界數據」不能在內容其餘地方出現，通常來講使用一段從機率上說「幾乎不可能」的數據便可。每次post瀏覽器都會生成一個隨機的30-40位長度的隨機字符串，瀏覽器通常不會遍歷此次post的全部數據找到一個不可能出如今數據中的字符串，通常都是隨機生成。選擇了這個邊界以後，瀏覽器便把它放在Content-Type 裏面傳遞給服務器，服務器根據此邊界解析數據。下面的數據便根據boundary劃分段，每一段即是一項數據。(每一個field被分紅小部分，並且包含一個value是"form-data"的"Content-Disposition"的頭部；一個"name"屬性對應field的ID等等，文件的話包括一個filename)
模擬請求以後，從返回結果能夠看到咱們的請求數據：

 

（2）若是用HttpClient模擬post請求的話，請求能夠這樣構造：

HttpPost post = new HttpPost("http://example.com");           //定義HttpPost對象並初始化它
MultipartEntity mutiEntity = new MultipartEntity();           //定義MultipartEntity對象
File file = new File("C:\Users\hzsuixiang\Desktop\image_20151117151539.png");
mutiEntity.addPart("desc",new StringBody("網易雲閱讀", Charset.forName("utf-8")));     //設置multiEntity對象的主體數據
mutiEntity.addPart("pic", newFileBody(file));post.setEntity(mutiEntity);             //設置post請求主體
HttpResponse  httpResponse = client.execute(post);                                   //執行post請求
HttpEntity httpEntity =  httpResponse.getEntity();                                   //得到響應返回實體

綜上，就是接口測試中fiddler與HttpClient模擬post接口四種請求數據的構造方法，總結起來有利於在之後的接口測試工組過程當中能夠及時查閱。另外，爲了儘量簡化核心代碼，列出的這些代碼中並無寫出須要的jar包，你們使用的時候須要自行添加。