Android学习笔记47-使用HttpClient接口实现网络通信

在Android中，我们可以通过使用标准的Java接口来完成Android应用程序的联网操作。但是在实际开发中，可能会需要用到更复杂的联网操作，为此，Android平台提供了Apache HttpClient接口，为客户端的HTTP编程提供了高效、便捷、功能丰富的工具包支持。

　　Android平台在引入Apache HttpClient的同时，还对其进行了一些封装和扩展，如设置缺省的HTTP超时和缓存大小等。使用Apache HttpClient接口，我们可以创建HttpClient、HttpGet/HttpPost、HttpResponse等对象，设置连接参数，执行HTTP操作，处理服务器返回结果等。

　　本文将以两个实例演示在Android开发中如何使用HttpClient接口完成客户端HTTP编程。其中，一个实例使用GET方式获取服务器上的图片进行显示；一个实例使用POST方式向服务器提交数据，完成登录功能。

 

1.常用的接口和类

　　在讲解实例之前，我们有必要先了解一下在HttpClient接口中，为我们提供了哪些常用的接口和类。

1.1 ClientConnectionManager接口

　　ClientConnectionManager是客户端连接管理器接口，用于对连接到服务器上的客户端进行管理，主要提供了以下6个抽象方法：

　　（1）abstract void closeExpiredConnections();

　　（2）abstract void closeIdleConnections(long idletime, TimeUnit tunit);

　　（3）abstract SchemeRegistry getSchemeRegistry();

　　（4）abstract void releaseConnection(ManagedClientConnection conn, long validDuration, TimeUnit timeUnit);

　　（5）abstract ClientConnectionRequest requestConnection(HttpRoute route, Object state); 

　　（6）abstract void shutdown();

　　其中，closeExpiredConnections()方法用于关闭所有过期的连接；closeIdleConnections()方法用于关闭所有空闲的连接；getSchemeRegistry()方法用于获得注册方案；releaseConnection()方法用于释放连接；requestConnection()方法用于请求一个新的连接；shutdown()方法用于关闭管理器并释放资源。

1.2 DefaultHttpClient

　　DefaultHttpClient是HttpClient接口的一个直接子类，它是一个默认的HTTP客户端，通常我们可以使用它来创建一个HTTP连接。在HttpClient接口中提供了多个重载的execute()方法，用来执行HTTP请求。

1.3 HttpRequest接口

　　HttpGet和HttpPost都是HttpRequest接口的直接子类，分别用于向服务器提交GET请求和POST请求。

1.4 HttpResponse接口

　　HttpResponse接口提供了HTTP的响应信息，其主要方法如图1所示。

图1 HttpResponse接口提供的主要方法

　　其中，getEntity()方法用于获取响应的消息实体；getStatusLine()方法用于获取响应的状态行，在返回结果StatusLine对象中包含了HTTP响应的状态码，可以使用方法getStatusCode()获得。

 

2.使用GET方式获取服务器上的图片

　　在该实例中，我们使用了在上一篇博文《Android学习笔记46：使用Post方式提交数据》中搭建好的Web工程作为服务器，并在该工程中添加了一张名为“cat.jpg”的图片作为我们将要获取的对象。

　　使用GET方式获取服务器上的图片，可以按照以下4个步骤进行：

　　（1）创建一个GET方式的HttpRequest请求对象。

　　（2）创建一个默认的HTTP客户端，并执行该GET方式的HTTP请求。

　　（3）获得服务器的响应码，据此判断服务器是否正确响应。

　　（4）获得服务器的响应内容（InputStream），转换成Bitmap图片。

　　以上4个步骤的具体实现代码如下：

 1     /*
 2      * Function   :   发送GET请求
 3      * Author     :   博客园-依旧淡然
 4      */
 5     public static Bitmap sendGetResquest(String path) {
 6         Bitmap bitmap = null;
 7         HttpGet httpGet = new HttpGet(path);                           //创建一个GET方式的HttpRequest对象
 8         DefaultHttpClient httpClient = new DefaultHttpClient();        //创建一个默认的HTTP客户端
 9         try {
10             HttpResponse httpResponse = httpClient.execute(httpGet);               //执行GET方式的HTTP请求
11             int reponseCode = httpResponse.getStatusLine().getStatusCode();        //获得服务器的响应码
12             if(reponseCode == HttpStatus.SC_OK) {
13                 InputStream inputStream = httpResponse.getEntity().getContent();   //获得服务器的响应内容
14                 bitmap = BitmapFactory.decodeStream(inputStream);
15                 inputStream.close();
16             }
17         } catch (ClientProtocolException e) {
18             e.printStackTrace();
19         } catch (IOException e) {
20             e.printStackTrace();
21         }
22         return bitmap;
23     }

　　最后，我们在Activity中通过一个Button按钮来向服务器发送GET请求，并调用sendGetResquest()方法将得到的Bitmap对象显示在ImageView控件中。具体的实现代码如下：

 1     /*
 2      * Function  :   点击事件响应
 3      * Author    :   博客园-依旧淡然
 4      */
 5     public void onClick(View view) {
 6         switch(view.getId()) {
 7         case R.id.button_get:
 8             String url = "http://192.168.1.101:8080/myhttp/cat.jpg";
 9             Bitmap bitmap = HttpUtils.sendGetResquest(url);
10             mImageView.setImageBitmap(bitmap);
11             break;
12         }
13     }

　　运行该工程，点击“提交GET请求”按钮后，可以看到如图2所示的显示界面，在“提交GET请求”按钮的下面所显示的图片正是我们从服务器上得到的图片。

图2 使用GET方式获取服务器上的图片

 

3.使用POST方式向服务器提交数据

　　在该实例中，我们同样使用了在上一篇博文《Android学习笔记46：使用Post方式提交数据》中搭建好的Web工程作为服务器。运行Tomcat，在浏览器中访问该Web工程，可以看到如图3所示的界面。 

图3 Web工程的显示页面

　　该实例要做的就是，使用POST方式向服务器提交用户名和密码，模拟登录过程，并获得服务器的验证信息，显示登录是否成功。

　　使用POST方式向服务器提交数据，比GET方式要稍微复杂点，具体可以按照以下5个步骤进行：

　　（1）对请求体参数（也就是username和password）进行封装。

　　（2）创建一个POST方式的HttpRequest对象，并设置POST方式的请求体。

　　（3）创建一个默认的HTTP客户端，并执行该POST方式的HTTP请求。

　　（4）获得服务器的响应码，据此判断服务器是否正确响应。

　　（5）获得服务器的响应内容（InputStream），转换成String字符串进行显示。

　　以上5个步骤的具体实现代码如下：

 1     /*
 2      * Function  :   发送POST请求
 3      * Author    :   博客园-依旧淡然
 4      */
 5     public static String sendPostResquest(String path, Map<String, String> params, String encoding) {
 6         List<NameValuePair> list = new ArrayList<NameValuePair>();      //封装请求体参数
 7         if((params != null) && !params.isEmpty()) {
 8             for(Map.Entry<String, String> param : params.entrySet()) {
 9                 list.add(new BasicNameValuePair(param.getKey(), param.getValue()));
10             }
11         }
12         try {
13             UrlEncodedFormEntity entity = new UrlEncodedFormEntity(list, encoding);    //对请求体参数进行URL编码
14             HttpPost httpPost = new HttpPost(path);           //创建一个POST方式的HttpRequest对象
15             httpPost.setEntity(entity);                       //设置POST方式的请求体
16             DefaultHttpClient client = new DefaultHttpClient();
17             HttpResponse httpResponse = client.execute(httpPost);                      //执行POST请求
18             int reponseCode = httpResponse.getStatusLine().getStatusCode();            //获得服务器的响应码
19             if(reponseCode == HttpStatus.SC_OK) {
20                 String resultData = EntityUtils.toString(httpResponse.getEntity());    //获得服务器的响应内容
21                 return resultData;
22             }
23         } catch (IOException e) {
24             e.printStackTrace();
25         }
26         return "";
27     }

　　同样的，我们在Activity中通过一个Button按钮来向服务器发送POST请求，并调用sendPostResquest()方法将得到的服务器响应结果显示在TextView控件中。具体的实现代码如下：

 1     /*
 2      * Function  :   点击事件响应
 3      * Author    :   博客园-依旧淡然
 4      */
 5     public void onClick(View view) {
 6         switch(view.getId()) {
 7         case R.id.button_submit:
 8             String username = mEditText_userName.getText().toString();
 9             String password = mEditText_password.getText().toString();
10             Map<String, String> params = new HashMap<String, String>();
11             params.put("username", username);
12             params.put("password", password);
13             String url = "http://192.168.1.101:8080/myhttp/servlet/LoginAction";
14             mTextView_result.setText(HttpUtils.sendPostResquest(url, params, "utf-8"));
15             break;
16         }
17     }

　　运行该工程，在EditText控件中分别输入用户名和密码，点击“提交数据”按钮后，可以看到如图4所示的显示界面，在“提交数据”按钮下面的TextView控件中可以看到服务器返回了“Login succeeded!” 的提示信息。