Android开发实现HttpClient工具类

时间:2022-03-14 08:45:07

在Android开发中我们经常会用到网络连接功能与服务器进行数据的交互,为此Android的SDK提供了Apache的HttpClient来方便我们使用各种Http服务。你可以把HttpClient想象成一个浏览器,通过它的API我们可以很方便的发出GET,POST请求(当然它的功能远不止这些)。
  比如你只需以下几行代码就能发出一个简单的GET请求并打印响应结果:

  try {
          // 创建一个默认的HttpClient
          HttpClient httpclient = new DefaultHttpClient();
          // 创建一个GET请求
          HttpGet request = new HttpGet("www.google.com");
          // 发送GET请求,并将响应内容转换成字符串
          String response = httpclient.execute(request, new BasicResponseHandler());
          Log.v("response text", response);
      } catch (ClientProtocolException e) {
          e.printStackTrace();
      } catch (IOException e) {
          e.printStackTrace();
      }

  为什么要使用单例HttpClient?
  这只是一段演示代码,实际的项目中的请求与响应处理会复杂一些,并且还要考虑到代码的容错性,但是这并不是本篇的重点。注意代码的第三行:

  HttpClient httpclient = new DefaultHttpClient();

  在发出HTTP请求前,我们先创建了一个HttpClient对象。那么,在实际项目中,我们很可能在多处需要进行HTTP通信,这时候我们不需要为每个请求都创建一个新的HttpClient。因为之前已经提到,HttpClient就像一个小型的浏览器,对于整个应用,我们只需要一个HttpClient就够了。看到这里,一定有人心里想,这有什么难的,用单例啊!!就像这样:

  public class CustomerHttpClient {
      private static HttpClient customerHttpClient;
    
      private CustomerHttpClient() {
      }
    
      public static HttpClient getHttpClient() {
          if(null == customerHttpClient) {
              customerHttpClient = new DefaultHttpClient();
          }
          return customerHttpClient;
      }
  }

  多线程!试想,现在我们的应用程序使用同一个HttpClient来管理所有的Http请求,一旦出现并发请求,那么一定会出现多线程的问题。这就好像我们的浏览器只有一个标签页却有多个用户,A要上google,B要上baidu,这时浏览器就会忙不过来了。幸运的是,HttpClient提供了创建线程安全对象的API,帮助我们能很快地得到线程安全的“浏览器”。

  解决多线程问题

  public class CustomerHttpClient {
      private static final String CHARSET = HTTP.UTF_8;
      private static HttpClient customerHttpClient;

      private CustomerHttpClient() {
      }

      public static synchronized HttpClient getHttpClient() {
          if (null == customerHttpClient) {
              HttpParams params = new BasicHttpParams();
              // 设置一些基本参数
              HttpProtocolParams.setVersion(params, HttpVersion.HTTP_1_1);
              HttpProtocolParams.setContentCharset(params,
                      CHARSET);
              HttpProtocolParams.setUseExpectContinue(params, true);
              HttpProtocolParams
                      .setUserAgent(
                              params,
                              "Mozilla/5.0(Linux;U;Android 2.2.1;en-us;Nexus One Build.FRG83) "
                                      + "AppleWebKit/553.1(KHTML,like Gecko) Version/4.0 Mobile Safari/533.1");
              // 超时设置
              /* 从连接池中取连接的超时时间 */
              ConnManagerParams.setTimeout(params, 1000);
              /* 连接超时 */
              HttpConnectionParams.setConnectionTimeout(params, 2000);
              /* 请求超时 */
              HttpConnectionParams.setSoTimeout(params, 4000);
            
              // 设置我们的HttpClient支持HTTP和HTTPS两种模式
              SchemeRegistry schReg = new SchemeRegistry();
              schReg.register(new Scheme("http", PlainSocketFactory
                      .getSocketFactory(), 80));
              schReg.register(new Scheme("https", SSLSocketFactory
                      .getSocketFactory(), 443));

              // 使用线程安全的连接管理来创建HttpClient
              ClientConnectionManager conMgr = new ThreadSafeClientConnManager(
                      params, schReg);
              customerHttpClient = new DefaultHttpClient(conMgr, params);
          }
          return customerHttpClient;
      }
  }

  在上面的getHttpClient()方法中,我们为HttpClient配置了一些基本参数和超时设置,然后使用ThreadSafeClientConnManager来创建线程安全的HttpClient。上面的代码提到了3种超时设置,比较容易搞混,故在此特作辨析。

HttpClient的3种超时说明

  /* 从连接池中取连接的超时时间 */
  ConnManagerParams.setTimeout(params, 1000);
  /* 连接超时 */
  HttpConnectionParams.setConnectionTimeout(params, 2000);
  /* 请求超时 */
  HttpConnectionParams.setSoTimeout(params, 4000);

  第一行设置ConnectionPoolTimeout:这定义了从ConnectionManager管理的连接池中取出连接的超时时间,此处设置为1秒。
  第二行设置ConnectionTimeout:这定义了通过网络与服务器建立连接的超时时间。Httpclient包中通过一个异步线程去创建与服务器的socket连接,这就是该socket连接的超时时间,此处设置为2秒。
  第三行设置SocketTimeout:这定义了Socket读数据的超时时间,即从服务器获取响应数据需要等待的时间,此处设置为4秒。
  以上3种超时分别会抛出ConnectionPoolTimeoutException,ConnectionTimeoutException与SocketTimeoutException。

  封装简单的POST请求
  有了单例的HttpClient对象,我们就可以把一些常用的发出GET和POST请求的代码也封装起来,写进我们的工具类中了。目前我仅仅实现发出POST请求并返回响应字符串的方法以供大家参考。将以下代码加入我们的CustomerHttpClient类中:

  private static final String TAG = "CustomerHttpClient";

  public static String post(String url, NameValuePair... params) {
          try {
              // 编码参数
              List<NameValuePair> formparams = new ArrayList<NameValuePair>(); // 请求参数
              for (NameValuePair p : params) {
                  formparams.add(p);
              }
              UrlEncodedFormEntity entity = new UrlEncodedFormEntity(formparams,
                      CHARSET);
              // 创建POST请求
              HttpPost request = new HttpPost(url);
              request.setEntity(entity);
              // 发送请求
              HttpClient client = getHttpClient();
              HttpResponse response = client.execute(request);
              if(response.getStatusLine().getStatusCode() != HttpStatus.SC_OK) {
                  throw new RuntimeException("请求失败");
              }
              HttpEntity resEntity =  response.getEntity();
              return (resEntity == null) ? null : EntityUtils.toString(resEntity, CHARSET);
          } catch (UnsupportedEncodingException e) {
              Log.w(TAG, e.getMessage());
              return null;
          } catch (ClientProtocolException e) {
              Log.w(TAG, e.getMessage());
              return null;
          } catch (IOException e) {
              throw new RuntimeException("连接失败", e);
          }

      }

  使用我们的CustomerHttpClient工具类
  现在,在整个项目中我们都能很方便的使用该工具类来进行网络通信的业务代码编写了。下面的代码演示了如何使用username和password注册一个账户并得到新账户ID。

  final String url = "http://yourdomain/context/adduser";
      //准备数据
      NameValuePair param1 = new BasicNameValuePair("username", "张三");
      NameValuePair param2 = new BasicNameValuePair("password", "123456");
      int resultId = -1;
      try {
          // 使用工具类直接发出POST请求,服务器返回json数据,比如"{userid:12}"
          String response = CustomerHttpClient.post(url, param1, param2);
          JSONObject root = new JSONObject(response);
          resultId = Integer.parseInt(root.getString("userid"));
          Log.i(TAG, "新用户ID:" + resultId);
      } catch (RuntimeException e) {
          // 请求失败或者连接失败
          Log.w(TAG, e.getMessage());
          Toast.makeText(this, e.getMessage(), Toast.LENGTH_SHORT);
      } catch (Exception e) {
          // JSon解析出错
          Log.w(TAG, e.getMessage());
      }

Android开发实现HttpClient工具类的更多相关文章

  1. Android开发调试日志工具类&lbrack;支持保存到SD卡&rsqb;

    直接上代码: package com.example.callstatus; import java.io.File; import java.io.FileWriter; import java.i ...

  2. wemall app商城源码android开发MD5加密工具类

    wemall-mobile是基于WeMall的android app商城,只需要在原商城目录下上传接口文件即可完成服务端的配置,客户端可定制修改.本文分享android开发MD5加密工具类主要代码,供 ...

  3. android开发SD卡工具类&lpar;一&rpar;

    SD卡工具类整理: package com.gzcivil.utils; import java.io.File; import java.io.FileInputStream; import jav ...

  4. android开发MD5加密工具类&lpar;一&rpar;

    MD5加密工具类整理: package com.gzcivil.utils; import java.io.UnsupportedEncodingException; import java.secu ...

  5. Java开发小技巧(五):HttpClient工具类

    前言 大多数Java应用程序都会通过HTTP协议来调用接口访问各种网络资源,JDK也提供了相应的HTTP工具包,但是使用起来不够方便灵活,所以我们可以利用Apache的HttpClient来封装一个具 ...

  6. Android开源项目大全 - 工具类

    主要包括那些不错的开发库,包括依赖注入框架.图片缓存.网络相关.数据库ORM建模.Android公共库.Android 高版本向低版本兼容.多媒体相关及其他. 一.依赖注入DI 通过依赖注入减少Vie ...

  7. 基于JavaMail开发邮件发送器工具类

    基于JavaMail开发邮件发送器工具类 在开发当中肯定会碰到利用Java调用邮件服务器的服务发送邮件的情况,比如账号激活.找回密码等功能.本人之前也碰到多次这样需求,为此特意将功能封装成一个简单易用 ...

  8. Android弹出Toast工具类总结

    Android弹出Toast工具类总结,包括系统自带的,也包括自定义的. public class ToastUtil { public ToastUtil() { } public static T ...

  9. Android 中替代 sharedpreferences 工具类的实现

    Android 中替代 sharedpreferences 工具类的实现 背景 想必大家一定用过 sharedpreferences 吧!就我个人而言,特别讨厌每次 put 完数据还要 commit. ...

随机推荐

  1. 《Qt Quick 4小时入门》学习笔记4

    http://edu.csdn.net/course/detail/1042/14806?auto_start=1 Qt Quick 4小时入门 第七章:处理鼠标与键盘事件 1.处理鼠标事件 鼠标信号 ...

  2. &lpar;copy&rpar; Shell Script to Check Linux System Health

    source: http://linoxide.com/linux-shell-script/shell-script-check-linux-system-health/ This article ...

  3. 一个非常简单的RPC服务

    1.servicefunctions.php <?php class ServiceFunctions { public static function getDisplayName($f,$l ...

  4. 安装Stomp扩展时错误提示error&colon; &&num;39&semi;zend&lowbar;class&lowbar;entry&&num;39&semi; has no member named &&num;39&semi;default&lowbar;properties&&num;39&semi;

    在安装stomp扩展时, 有这样的提示 error: 'zend_class_entry' has no member named 'default_properties' 交待下安装上下文, sto ...

  5. CSS&plus;DIV入门第一天基础视频 CSS选择器层叠性和继承性

    大家好,我是小强老师, 现在网上的CSS+DIV视频,要么讲的太深,要么太浅,很多初学的同学们总是遇到困难,今天小强老师专门给大家准备了css课程的视频.带你从零基础学习CSS+DIV一直到能独立完成 ...

  6. Java 8 Learn Notes

    Main reference: [1] http://winterbe.com/posts/2014/03/16/java-8-tutorial/ [2] https://plus.google.co ...

  7. Implement a Linked List

    https://github.com/Premiumlab/Python-for-Algorithms--Data-Structures--and-Interviews/blob/master/Lin ...

  8. Sonar6&period;7&period;1配置修改备注

    sonarqube-6.7.1\conf\sonar.properties的配置字段 sonar.jdbc.url=jdbc:mysql://localhost:3306/sonarqube?useU ...

  9. 使用Python2&period;7 POST 数据到 onenet 平台

    功能 发送数据名称为SENSORID(这里用TEST测试),数值为VALUE(这里用49值做测试)的数据,发送到自己的onenet对应设备 效果发送成功 代码 # -*- coding: utf-8 ...

  10. Oracle分页&lpar;limit方式的运用&rpar;

    select * from a_matrix_navigation_map where rowid not in(select rowid from a_matrix_navigation_map w ...