Android學習筆記46：使用Post方式提交數據

　　在Android中，提供了標准Java接口HttpURLConnection和Apache接口HttpClient，為客戶端HTTP編程提供了豐富的支持。

　　在HTTP通信中使用最多的就是GET和POST了，GET請求可以獲取靜態頁面，也可以把參數放在URL字符串的后面，傳遞給服務器。POST與GET的不同之處在於POST的參數不是放在URL字符串里面，而是放在HTTP請求數據中。

　　本文將使用標准Java接口HttpURLConnection，以一個實例演示如何使用POST方式向服務器提交數據，並將服務器的響應結果顯示在Android客戶端。

 

1.服務器端的准備

　　為了完成該實例，我們需要在服務器端做以下准備工作：

　　（1）我們需要在MyEclipse中創建一個Web工程，用來模擬服務器端的Web服務，這里，我將該工程命名為了“myhttp”。

　　（2）修改該工程的“index.jsp”文件，添加兩個輸入框和一個提交按鈕，作為該Web工程的顯示頁面。運行Tomcat，在瀏覽器中訪問該Web工程，可以看到如圖1所示的界面。

圖1 Web工程的顯示頁面

　　（3）在該Web工程中，創建一個繼承自HttpServlet的LoginAction類，並實現其中的doPost()方法，用來響應圖1所示頁面的用戶操作。具體實現如下：

　　public void doPost(HttpServletRequest request, HttpServletResponse response)
            throws ServletException, IOException {

        response.setContentType("text/html;charset=utf-8");
        request.setCharacterEncoding("utf-8");
        response.setCharacterEncoding("utf-8");
        PrintWriter out = response.getWriter();
        
        String username = request.getParameter("username");
        String password = request.getParameter("password");
                
        //判斷用戶名密碼是否正確
        if(username.equals("admin") && password.equals("123")) {
            out.print("Login succeeded!");
        }else {
            out.print("Login failed!");
        }
        
        out.flush();
        out.close();
    }

　　由上述代碼可以看出，當我們在圖1所示的頁面輸入用戶名“admin”，密碼“123”時，點擊提交按鈕，會得到“Login succeeded!”的提示信息，如圖2所示。若用戶名、密碼錯誤，則會得到“Login failed!”的提示信息。

圖2 登錄成功界面

　　至此，服務器端的准備工作就全部完成了。

 

2.客戶端實現

　　在Android客戶端，我們需要完成的工作是：以POST方式發送用戶名密碼到上述服務器，並獲得服務器的驗證信息。

　　我們分以下幾個步驟來完成。

2.1 UI界面

　　在Android工程中，我們需要完成一個簡單的UI界面，用來完成用戶名密碼的輸入、發送POST請求、顯示服務器的驗證結果，完成后的界面如圖3所示。

圖3 客戶端UI界面

　　在MainActivity中，我們需要獲取兩個EditText控件的輸入，“提交”按鍵的監聽，以及服務器驗證結果的TextView內容顯示。具體實現代碼如下：

    /*
     * Function  :   點擊事件響應
     * Author    :   博客園-依舊淡然
     */
    public void onClick(View view) {
        switch(view.getId()) {
        case R.id.button_submit:
            String username = mEditText_userName.getText().toString();
            String password = mEditText_password.getText().toString();
            Map<String, String> params = new HashMap<String, String>();
            params.put("username", username);
            params.put("password", password);
            mTextView_result.setText(HttpUtils.submitPostData(params, "utf-8"));
            break;
        }
    }

2.2發送POST請求到服務器

　　可以看到上述代碼中，我們調用了HttpUtils類的靜態方法submitPostData()完成了發送POST請求到服務器，並將該方法的返回值（服務器的響應結果）顯示在了TextView控件中。

　　在HttpUtils類中，submitPostData()方法的具體實現如下：

/*
     * Function  :   發送Post請求到服務器
     * Param     :   params請求體內容，encode編碼格式
     * Author    :   博客園-依舊淡然
     */
    public static String submitPostData(Map<String, String> params, String encode) {
        
        byte[] data = getRequestData(params, encode).toString().getBytes();　　　　//獲得請求體
        try {            
            HttpURLConnection httpURLConnection = (HttpURLConnection)url.openConnection();
            httpURLConnection.setConnectTimeout(3000);        　　//設置連接超時時間
            httpURLConnection.setDoInput(true);                  //打開輸入流，以便從服務器獲取數據
            httpURLConnection.setDoOutput(true);                 //打開輸出流，以便向服務器提交數據
            httpURLConnection.setRequestMethod("POST");    　　　 //設置以Post方式提交數據
            httpURLConnection.setUseCaches(false);               //使用Post方式不能使用緩存
            //設置請求體的類型是文本類型
            httpURLConnection.setRequestProperty("Content-Type", "application/x-www-form-urlencoded");
            //設置請求體的長度
            httpURLConnection.setRequestProperty("Content-Length", String.valueOf(data.length));
            //獲得輸出流，向服務器寫入數據
            OutputStream outputStream = httpURLConnection.getOutputStream();
            outputStream.write(data);
            
            int response = httpURLConnection.getResponseCode();            //獲得服務器的響應碼
            if(response == HttpURLConnection.HTTP_OK) {
                InputStream inptStream = httpURLConnection.getInputStream();
                return dealResponseResult(inptStream);                     //處理服務器的響應結果
            }
        } catch (IOException e) {
            e.printStackTrace();
        }
        return "";
    }

　　通過以上的代碼可以看出，在該方法中，其實完成了3件事：

　　（1）將用戶名密碼封裝成請求體，這是通過調用getRequestData()方法來實現的（后面會講到這個方法的具體實現）。

　　（2）設置HttpURLConnection對象的各種參數（其實是設置HTTP協議請求體的各項參數），然后通過httpURLConnection.getOutputStream()方法獲得服務器輸出流outputStream，再使用outputStream.write()方法將請求體內容發送給服務器。

　　（3）判斷服務器的響應碼，通過httpURLConnection.getInputStream()方法獲得服務器的響應輸入流，然后再調用dealResponseResult()方法處理服務器的響應結果。

2.3封裝請求體

　　使用POST請求時，POST的參數不是放在URL字符串里，而是放在HTTP請求數據中，所以我們需要對POST的參數進行封裝。

　　針對該實例而言，我們發送的URL請求是：http://192.168.1.101:8080/myhttp/servlet/LoginAction，但是我們需要將POST的參數（也就是username和password）封裝到該請求中，形成如下的形式：http://192.168.1.101:8080/myhttp/servlet/LoginAction?username=admin&password=123。我們該怎么做呢？如下的代碼給出了一種實現的方案：

    /*
     * Function  :   封裝請求體信息
     * Param     :   params請求體內容，encode編碼格式
     * Author    :   博客園-依舊淡然
     */
    public static StringBuffer getRequestData(Map<String, String> params, String encode) {
        StringBuffer stringBuffer = new StringBuffer();        //存儲封裝好的請求體信息
        try {
            for(Map.Entry<String, String> entry : params.entrySet()) {
                stringBuffer.append(entry.getKey())
                            .append("=")
                            .append(URLEncoder.encode(entry.getValue(), encode))
                            .append("&");
            }
            stringBuffer.deleteCharAt(stringBuffer.length() - 1);    //刪除最后的一個"&"
        } catch (Exception e) {
            e.printStackTrace();
        }
        return stringBuffer;
    }

2.4處理響應結果

　　最后，我們再來看一看對服務器返回結果的處理是怎樣的。因為在本實例中，服務器的返回結果是字符串“Login succeeded!”或“Login failed!”，所以這里我們需要做的就是將服務器的返回結果輸入流轉化成字符串。當然了，如果服務器返回的是圖片，那么，我們就需要就得到的輸入流轉化成Bitmap圖片了。如下代碼是上面代碼中用到的dealResponseResult()方法的具體實現。

    /*
     * Function  :   處理服務器的響應結果（將輸入流轉化成字符串）
     * Param     :   inputStream服務器的響應輸入流
     * Author    :   博客園-依舊淡然
     */
    public static String dealResponseResult(InputStream inputStream) {
        String resultData = null;      //存儲處理結果
        ByteArrayOutputStream byteArrayOutputStream = new ByteArrayOutputStream();
        byte[] data = new byte[1024];
        int len = 0;
        try {
            while((len = inputStream.read(data)) != -1) {
                byteArrayOutputStream.write(data, 0, len);
            }
        } catch (IOException e) {
            e.printStackTrace();
        }
        resultData = new String(byteArrayOutputStream.toByteArray());    
        return resultData;
    }

2.5運行效果

　　最后，看看該實例的運行效果吧，如圖4所示。

圖4 實例運行效果