簡化安卓環境下HTTP連接的SDK設計

林育曼+溫子儀+鄧圳立+羅枳珊+劉茹+饒浩

摘要：為簡化安卓下HTTP連接請求的操作，在HttpURLConnection連接的基礎上，封裝連接與異步到一個aar上，最終用一至二行代碼實現想要的操作，提高工作效率。在減少操作代碼的同時，也保留了異步操作的靈活性。

關鍵詞：安卓；SDK；連接aar；異步；HTTP連接

中圖分類號：TP311 文獻標識碼：A 文章編號：1009-3044（2018）01-0053-02

Abstract： To simplify the operation of the HTTP connection request under Android， Based on the HttpURLConnection， connection was encapsulated and asynchronous to AAR. One or two lines of code were used to implement the desired operation. The efficiency of software development has been improved. The flexibility of asynchronous operations was also retained.

Key words： android； SDK； connection aar； asynchronous； http connection

1 背景

隨著智能手機的普及，安卓設備的應用層出不窮，手機應用聯網獲取數據是必不可少的。傳統的安卓開發使用鍵值對傳值，或者利用json 解析，但是往往諸如此類重復的代碼需要在很多地方出現，影響整體代碼質量。另一方面，代碼多了也容易出錯，往往一個空指針就需要一番調試。面向對象程序設計很好地解決了這個問題，把很多復雜繁瑣的操作封裝起來，供用戶調用。用戶只要會使用方法操作就行，無須花費精力去研究。因此，善于利用封裝好所需類的包，可以為開發帶來便利。

2 Android連接協議和解析方式

Android使用java語言進行開發，java里面連接的API有HttpURLConnection和 HttpClient，目前官方已經不推薦使用HttpClient，并且HttpURLConnection在原則上也會比HttpClient要快。故而Android常使用HttpURLConnection連接。

每個HttpURLConnection實例都可用于生成單個請求，但是其他實例可以透明地共享連接到HTTP服務器的基礎網絡。請求后在 HttpURLConnection的InputStream或OutputStream上調用close（）方法可以釋放與此實例關聯的網絡資源，對共享的持久連接沒有任何影響。如果在調用 disconnect（） 時持久連接空閑，則可能關閉基礎套接字。

HttpURLConnection已經封裝好URL.openConnection（）打開一個連接強制轉換為HttpURLConnection。然后為其設置“POST”或“GET”以及連接超時時間。若HttpURLConnection的返回碼為200則表示連接成功。可以進行下一步操作。

數據請求有POST和GET兩種，服務器根據請求的不同給予不同的處理。對于服務器傳過來的數據需要根據數據的格式進行解析，較為常用的是JSON和XML，移動開發，用的比較多的是JSON。而傳遞參數則是直接編輯傳遞過程的參數，如“www.xxx.com/login？phone=110&user=dxs”。

3 常規連接方式

常規開發采用異步開發，比如一個登錄的接口，需要POST傳遞手機號和密碼參數到服務器，服務器再傳遞登錄信息回來。

首先建一個服務器模擬登錄的接口，這個接口接收兩個參數，一個手機號碼，一個加密過的密碼，接收到參數后會進行驗證，若驗證通過則返回登錄成功的狀態碼還有登錄的手機號碼；若驗證不通過，返回錯誤狀態碼還有錯誤信息。

protected void doPost（HttpServletRequest request， HttpServletResponse response） throws ServletException， IOException {

// TODO Auto-generated method stub

String phone = request.getParameter（"phone"）；

String password = request.getParameter（"password"）；

response.setCharacterEncoding（"utf-8"）；

PrintWriter out = response.getWriter（）；

if（phone.equals（"110"））{

out.print（"{status：1，data：110，message：''}"）；}

else{

out.print（"{status：0，data：''，message：fail}"）；}}

手機端初始化鍵值對params， 然后把手機號和加密過的密碼分別添加到params里面，用HttpURLConnection連接把params轉為html代碼通過UTF-8編碼發給服務器。

這時候因為UI直接在UI線程操作會造成UI堵塞，這在安卓開發里是不允許出現的，所以可建立一個新的線程進行操作，將返回的數據傳遞給Handler句柄，在Handler進行想要的處理。endprint

4 SDK設計

4.1 4個請求類的設計

首先設計了4個請求類TextRequest、ImageRequest、FileRequest、MapRequest，具體如下：

TextRequest：有兩個靜態方法getTxt（String urlPath， String encoding），sendTxt（String urlPath， String txt， String encoding），分別從服務器獲取文本還有向服務器發送文本，用于直接發送數據或者json，xml格式數據。

ImageRequest：只提供一個基本的獲取圖片的靜態方法Bitmap getUrlImage（String url）。

FileRequest：提供三個文件上傳的靜態方法，分別通過文件名字+文件路徑，還有不帶參數的文件與帶參數的文件。

MapRequest：向服務器發送參數的類，有兩個靜態方法sendPost（String urlPath，Map params， String encoding），sendGet（String urlPath， Map params， String encoding），分別用Post方式還有Get方式向服務器發送參數。

4.2 設計NetTool類調用4個請求類的方法

這里是把幾個方法整合到一個類里方便調用，并做了一些優化處理。如GetTxt方法：

public boolean getTxt（final String urlPath， final String encoding， final int what， final Handler handler） {

（new Thread（new Runnable（） {

public void run（） {

try {

String result = TextRequest.getTxt（urlPath， encoding）；

Message msg = new Message（）；

msg.what = what；

msg.obj = result；

handler.sendMessage（msg）；

} catch （Exception e） {

e.printStackTrace（）；}}

}））.start（）；

return true；}

除了TextRequest.getTxt（urlPath， encoding）本來需要的兩個參數外，還需要傳遞Message.what和Handler，urlPath， encoding改為終態參數。將TextRequest.getTxt（urlPath， encoding）返回值即服務器返回數據作為Message的obj字段，參數what做為Message的what字段，向Handler發送Message信息。

4.3 用數組形式給出鍵值對

如果數據本來就是Map格式，可以直接傳遞給MapRequest類下的方法。但如果不是，很多情況下使用參數傳參需要做很多重復的工作，將數據添加到Map，再將Map轉化為html，這就做了不少多余的工作。上述操作可以用兩個數組解決，一個存鍵，一個存值，在NetTool里將其遍歷并添加Map，再用MapRequest類傳參，例如：NetTool.sendPost（loginurl，new String[]{"phone"，"password"}，new Object[]{phone，md5password}，"utf-8"，0，handler）； 該操作借鑒于安卓的SimpleAdapter類。

4.4 生成aar包

新建一個android library，放入文件，重新編譯，會自動生成aar包，導入項目如圖1所示。

5 遇到的問題和解決方案

最大的問題是返回的數據要怎么返回給主程序。因為操作畢竟是在另外一個線程，要怎么從函數里面返回給主程序。一開始的思路是新建個handler，然后在Thread里調用，但是不管怎么創建，始終不是主程序的，無法進行溝通。后來在NetTool類建立一個result靜態字段，線程結束后返回值給result，然后把result作為函數的返回值。但是這也是不行的，無法確定線程結束的時間，自然也不知道result里面的值是不是想要的數據。之前用過較好的Imageloader軟件包能幫忙加載圖片，也是一行代碼實現，但是因為傳遞了Context和具體的控件，內容也較為明確，故軟件包可以代替實現操作。但是本軟件包并不僅為某一單一功能服務，而是希望程序員可以利用它進一步去做自己的各種操作，所以本方法不適用。最后的方法是在函數參數里傳遞handler ，而為了編碼人員更加靈活操作，把 Message.what也做為參數傳過來。這樣可以較大提高代碼效率，同時保證了數據的穩定性。

6 結束語

常規的安卓把操作封裝成一個類，其中每次操作都要使用HttpUrlConnection連接是比較繁瑣的步驟，每次連接都要新開一個線程。為了減少代碼負擔，往往會將連接的過程分離出來，提取成一個方法，但是仍然要手動開啟一個線程。

本包將線程一并封裝，并且使用兩個數組分別傳遞參數名和參數值，無須用戶考慮線程等問題，且在已有Handler情況下一行代碼即可實現全部操作。線程和Handler由編碼人員自己編寫，可以靈活進行各種處理。本軟件包幫忙建立了線程，但是Handler還是程序員自己給的，what參數也由程序員給出，因此保留了靈活性。

參考文獻：

[1] 鐘鍵. 試析Android異步通信機制[J]. 電腦編程技巧與維護， 2016（10）：46-47.

[2] 程藝. android studio生成aar包并在其他工程引用aar包[EB/OL]. （2017-08-20）.http：//blog.csdn.net/getchance/article/details/47257389.

[3] 郭霖. 第一行代碼Android[M]. 北京： 人民郵電出版社， 2014.

[4] 夏盛新. 基于Android的移動開放平臺SDK的設計與實現[D]. 西安： 西安電子科技大學， 2014.

[5] 薛海龍， 陳渝， 雷蕾， 等. Android應用異步編程模型性能分析[J]. 計算機科學與探索， 2017.

[6] 章蓬陽， 邵帥. Android異步框架的研究與設計[J]. 軟件， 2016， 37（2）：150-154.