http://blog.csdn.net/zhangfei_jiayou/article/details/20797255
http://blog.csdn.net/zhangfei_jiayou/article/details/20797255
http://blog.csdn.net/zhangfei_jiayou/article/details/20797255
http://blog.csdn.net/zhangfei_jiayou/article/details/20797255
http://blog.csdn.net/zhangfei_jiayou/article/details/20797255
HttpClient是Apache开源组织提供的一个开源的项目,从名字上就可以看出,它是一个简单的HTTP客户端(并不是浏览器),可以发送HTTP请求,接受HTTP响应。但是不会缓存服务器的响应,不能执行HTTP页面中签入嵌入的JS代码,自然也不会对页面内容进行任何解析、处理,这些都是需要开发人员来完成的。
现在Android已经成功集成了HttpClient,所以开发人员在Android项目中可以直接使用HttpClient来想Web站点提交请求以及接受响应,如果使用其他的Java项目,需要引入进相应的Jar包。HttpClient可以在官网上下载。
HttpClient
HttpClient其实是一个interface类型,HttpClient封装了对象需要执行的Http请求、身份验证、连接管理和其它特性。从文档上看,HttpClient有三个已知的实现类分别是:AbstractHttpClient, AndroidHttpClient, DefaultHttpClient,会发现有一个专门为Android应用准备的实现类AndroidHttpClient,当然使用常规的DefaultHttpClient也可以实现功能,但是既然开发的是Android应用程序,还是使用Android专有的实现类,一定有其优势。
从两个类包所有在位置就可以看出区别,AndroidHttpClient定义在android.net.http.AndroidHttpClient包下,属于Android原生的http访问,而DefaultHttpClient定义在org.apache.http.impl.client.DefaultHttpClient包下,属于对apche项目的支持。而AndroidHttpClient没有公开的构造函数,只能通过静态方法newInstance()方法来获得AndroidHttpClient对象。
AndroidHttpClient对于DefaultHttpClient做了一些改进,使其更使用用于Android项目:
- 关掉过期检查,自连接可以打破所有的时间限制。
- 可以设置ConnectionTimeOut(连接超时)和SoTimeout(读取数据超时)。
- 关掉重定向。
- 使用一个Session缓冲用于SSL Sockets。
- 如果服务器支持,使用gzip压缩方式用于在服务端和客户端传递的数据。
- 默认情况下不保留Cookie。
简单来说,用HttpClient发送请求、接收响应都很简单,只需要几个步骤即可:
- 创建HttpClient对象。
- 创建对应的发送请求的对象,如果需要发送GET请求,则创建HttpGet对象,如果需要发送POST请求,则创建HttpPost对象。
- 对于发送请求的参数,GET和POST使用的方式不同,GET方式可以使用拼接字符串的方式,把参数拼接在URL结尾;POST方式需要使用setEntity(HttpEntity entity)方法来设置请求参数。
- 调用HttpClient对象的execute(HttpUriRequest request)发送请求,执行该方法返回一个HttpResponse对象。
- 调用HttpResponse的对应方法获取服务器的响应头、响应内容等。
DefaultHttpClient
先看看使用DefaultHttpClient方式发送Web站点请求,上面已经简要说明了步骤,在这里简要说明一个参数的传递问题,对于GET方式,只需要拼接字符串就在URL结尾即可,但是对于POST方式,需要传递HttpEntity对象,HttpEntity为一个接口,有多个实现类,可以使用其间接子继承,UrlEncodedFormEntity类来保存请求参数,并传递给HttpPost。
此例子简单实现了在Android客户端使用DefaultHttpClient实现一个Http站点登陆的实现,使用的是POST传递,其传递值只需要传递username+password即可,当传递的数据为admin+123则认为登陆成功。Web站点使用.net的架构,一个一般处理程序,简单的比对账户密码,这里就不在此讲解。
因为Android4.0之后对使用网络有特殊要求,已经无法再在主线程中访问网络了,必须使用多线程访问的模式,其他的一些信息在代码注释中已经说明。
DefaultHttpClient-Code
1 package com.bgxt.httpUtils;
2
3 import java.io.ByteArrayOutputStream;
4 import java.io.IOException;
5 import java.io.InputStream;
6 import java.io.UnsupportedEncodingException;
7 import java.util.ArrayList;
8 import java.util.HashMap;
9 import java.util.List;
10 import java.util.Map;
11
12 import org.apache.http.HttpResponse;
13 import org.apache.http.NameValuePair;
14 import org.apache.http.client.ClientProtocolException;
15 import org.apache.http.client.entity.UrlEncodedFormEntity;
16 import org.apache.http.client.methods.HttpPost;
17 import org.apache.http.impl.client.DefaultHttpClient;
18 import org.apache.http.message.BasicNameValuePair;
19
20 public class httpClientUtils implements Runnable {
21 /**
22 * 对于Android4.0之上的环境下,不能在主线程中访问网络 所以这里另新建了一个实现了Runnable接口的Http访问类
23 */
24 private String username;
25 private String password;
26
27 public httpClientUtils(String username, String password) {
28 // 初始化用户名和密码
29 this.username = username;
30 this.password = password;
31 }
32
33 @Override
34 public void run() {
35 // 设置访问的Web站点
36 String path = "http://192.168.1.103:1231/loginas.ashx";
37 // 设置Http请求参数
38 Map<String, String> params = new HashMap<String, String>();
39 params.put("username", username);
40 params.put("password", password);
41
42 String result = sendHttpClientPost(path, params, "utf-8");
43 // 把返回的接口输出
44 System.out.println(result);
45 }
46
47 /**
48 * 发送Http请求到Web站点
49 *
50 * @param path
51 * Web站点请求地址
52 * @param map
53 * Http请求参数
54 * @param encode
55 * 编码格式
56 * @return Web站点响应的字符串
57 */
58 private String sendHttpClientPost(String path, Map<String, String> map,
59 String encode) {
60 List<NameValuePair> list = new ArrayList<NameValuePair>();
61 if (map != null && !map.isEmpty()) {
62 for (Map.Entry<String, String> entry : map.entrySet()) {
63 // 解析Map传递的参数,使用一个键值对对象BasicNameValuePair保存。
64 list.add(new BasicNameValuePair(entry.getKey(), entry
65 .getValue()));
66 }
67 }
68 try {
69 // 实现将请求 的参数封装封装到HttpEntity中。
70 UrlEncodedFormEntity entity = new UrlEncodedFormEntity(list, encode);
71 // 使用HttpPost请求方式
72 HttpPost httpPost = new HttpPost(path);
73 // 设置请求参数到Form中。
74 httpPost.setEntity(entity);
75 // 实例化一个默认的Http客户端
76 DefaultHttpClient client = new DefaultHttpClient();
77 // 执行请求,并获得响应数据
78 HttpResponse httpResponse = client.execute(httpPost);
79 // 判断是否请求成功,为200时表示成功,其他均问有问题。
80 if (httpResponse.getStatusLine().getStatusCode() == 200) {
81 // 通过HttpEntity获得响应流
82 InputStream inputStream = httpResponse.getEntity().getContent();
83 return changeInputStream(inputStream, encode);
84 }
85 } catch (UnsupportedEncodingException e) {
86 e.printStackTrace();
87 } catch (ClientProtocolException e) {
88 e.printStackTrace();
89 } catch (IOException e) {
90 e.printStackTrace();
91 }
92 return "";
93 }
94
95 /**
96 * 把Web站点返回的响应流转换为字符串格式
97 *
98 * @param inputStream
99 * 响应流
100 * @param encode
101 * 编码格式
102 * @return 转换后的字符串
103 */
104 private String changeInputStream(InputStream inputStream, String encode) {
105 ByteArrayOutputStream outputStream = new ByteArrayOutputStream();
106 byte[] data = new byte[1024];
107 int len = 0;
108 String result = "";
109 if (inputStream != null) {
110 try {
111 while ((len = inputStream.read(data)) != -1) {
112 outputStream.write(data, 0, len);
113 }
114 result = new String(outputStream.toByteArray(), encode);
115
116 } catch (IOException e) {
117 e.printStackTrace();
118 }
119 }
120 return result;
121 }
122
123 }
AndroidHttpClient
使用AndroidHttpClient的方式和DefaultHttpClient差不多,不多的几点区别上面已经说明,但是在此例子中没有体现。有一点需要注意的是,AndroidHttpClient是一个final类,也没有公开的构造函数,所以无法使用new的形式对其进行实例化,必须使用AndroidHttpClient.newInstance()方法获得AndroidHttpClient对象。
示例中依然是使用POST请求,实现的功能和DefaultHttpClient示例一样。细节部分已经在注释中体现,直接看代码即可。
1 package com.bgxt.httpUtils;
2
3 import java.io.ByteArrayOutputStream;
4 import java.io.IOException;
5 import java.io.InputStream;
6 import java.io.UnsupportedEncodingException;
7 import java.util.ArrayList;
8 import java.util.HashMap;
9 import java.util.List;
10 import java.util.Map;
11
12 import org.apache.http.HttpResponse;
13 import org.apache.http.NameValuePair;
14 import org.apache.http.client.ClientProtocolException;
15 import org.apache.http.client.HttpClient;
16 import org.apache.http.client.entity.UrlEncodedFormEntity;
17 import org.apache.http.client.methods.HttpPost;
18 import org.apache.http.impl.client.DefaultHttpClient;
19 import org.apache.http.message.BasicNameValuePair;
20
21 import android.net.http.AndroidHttpClient;
22
23 public class AndroidHttpClientUtils implements Runnable {
24
25 private String username;
26 private String password;
27
28 public AndroidHttpClientUtils(String username, String password) {
29 // 初始化用户名和密码
30 this.username = username;
31 this.password = password;
32 }
33
34 @Override
35 public void run() {
36 // 设置访问的Web站点
37 String path = "http://192.168.1.103:1231/loginas.ashx";
38 //设置Http请求参数
39 Map<String, String> params = new HashMap<String, String>();
40 params.put("username", username);
41 params.put("password", password);
42
43 String result = sendHttpClientPost(path, params, "utf-8");
44 //把返回的接口输出
45 System.out.println(result);
46 }
47 /**
48 * 发送Http请求到Web站点
49 * @param path Web站点请求地址
50 * @param map Http请求参数
51 * @param encode 编码格式
52 * @return Web站点响应的字符串
53 */
54 private String sendHttpClientPost(String path,Map<String, String> map,String encode)
55 {
56 List<NameValuePair> list=new ArrayList<NameValuePair>();
57 if(map!=null&&!map.isEmpty())
58 {
59 for(Map.Entry<String, String> entry:map.entrySet())
60 {
61 //解析Map传递的参数,使用一个键值对对象BasicNameValuePair保存。
62 list.add(new BasicNameValuePair(entry.getKey(), entry.getValue()));
63 }
64 }
65 try {
66 //实现将请求 的参数封装封装到HttpEntity中。
67 UrlEncodedFormEntity entity=new UrlEncodedFormEntity(list, encode);
68 //使用HttpPost请求方式
69 HttpPost httpPost=new HttpPost(path);
70 //设置请求参数到Form中。
71 httpPost.setEntity(entity);
72 //实例化一个默认的Http客户端,使用的是AndroidHttpClient
73 HttpClient client=AndroidHttpClient.newInstance("");
74 //执行请求,并获得响应数据
75 HttpResponse httpResponse= client.execute(httpPost);
76 //判断是否请求成功,为200时表示成功,其他均问有问题。
77 if(httpResponse.getStatusLine().getStatusCode()==200)
78 {
79 //通过HttpEntity获得响应流
80 InputStream inputStream=httpResponse.getEntity().getContent();
81 return changeInputStream(inputStream,encode);
82 }
83
84 } catch (UnsupportedEncodingException e) {
85 // TODO Auto-generated catch block
86 e.printStackTrace();
87 } catch (ClientProtocolException e) {
88 // TODO Auto-generated catch block
89 e.printStackTrace();
90 } catch (IOException e) {
91 // TODO Auto-generated catch block
92 e.printStackTrace();
93 }
94
95 return "";
96 }
97 /**
98 * 把Web站点返回的响应流转换为字符串格式
99 * @param inputStream 响应流
100 * @param encode 编码格式
101 * @return 转换后的字符串
102 */
103 private String changeInputStream(InputStream inputStream,
104 String encode) {
105 ByteArrayOutputStream outputStream = new ByteArrayOutputStream();
106 byte[] data = new byte[1024];
107 int len = 0;
108 String result="";
109 if (inputStream != null) {
110 try {
111 while ((len = inputStream.read(data)) != -1) {
112 outputStream.write(data,0,len);
113 }
114 result=new String(outputStream.toByteArray(),encode);
115
116 } catch (IOException e) {
117 e.printStackTrace();
118 }
119 }
120 return result;
121 }
122 }
在本文的示例中,环境是使用的Android项目,可以对其进行简单的界面布局,如图:
如果输入用户和密码为:admin+123,则可以再LogCat中查看到登录成功。
总结
最近的两次博客中,已经分别介绍了HttpUrlConnection和HttpClient两种方式,通过Http协议对Web站点的访问。如果还不了解HttpURLConnection的读者,可以看看Android--Http协议。
根据官方文档上说的显示,Android包括两个Http客户端:HttpURLConnection和Apache HttpClient。并且都支持HTTPS,流媒体上传下载,并且可配置超时以及支持IPv6和连接池技术。但是因为移动设备的局限性,HttpURLConnection会是比Apache Http更好的选择,因为其API简单,运行消耗内存小,并且具有公开化的压缩算法,以及响应缓存,能更好的减少网络使用,提供运行速度和节省电池。
但是也不能否认Apache HttpClient,它有大量的灵活的API,实现比较稳定,少有Bug,可造成的问题就是很难在不影响其兼容性的情况下对其进行改进了。现在Android开发者已经慢慢放弃Apache HttpClient的使用,转而使用HttpURLConnection。但是对于Android2.2之前的版本,HttpURLConnection具有一个致命的BUG,在响应输入流InputStream中调用.Close()方法将会阻碍连接池,因为这个BUG,只能放弃连接池的使用,但是Apache HttpClient不存在这个问题,当然Android2.3之后的版本中,HttpURLConnection已经解决了这个BUG,可以放心使用。
转载至:http://www.cnblogs.com/plokmju/p/Android_apacheHttpClient.html
http://blog.csdn.net/zhangfei_jiayou/article/details/8076215
http://blog.csdn.net/zhangfei_jiayou/article/details/8076215
http://blog.csdn.net/zhangfei_jiayou/article/details/8076215
- <?xml version="1.0" encoding="utf-8"?>
- <manifest xmlns:android="http://schemas.android.com/apk/res/android"
- package=""
- android:versionCode="1"
- android:versionName="1.0">
- <application android:icon="@drawable/icon" android:label="@string/app_name">
- <!-- 配置测试要使用的类库 -->
- <uses-library android:name="android.test.runner"/>
- </application>
- <!-- 配置测试设备的主类和目标包 -->
- <instrumentation android:name="android.test.InstrumentationTestRunner"
- android:targetPackage="com.scott.http"/>
- <!-- 访问HTTP服务所需的网络权限 -->
- <uses-permission android:name="android.permission.INTERNET"/>
- <uses-sdk android:minSdkVersion="8" />
- </manifest>
然后,我们的单元测试类需要继承android.test.AndroidTestCase类,这个类本身是继承junit.framework.TestCase,并提供了getContext()方法,用于获取Android上下文环境,这个设计非常有用,因为很多Android API都是需要Context才能完成的.
现在让我们来看一下我们的测试用例,HttpTest.java代码如下:
- public class HttpTest extends AndroidTestCase {
- private static final String PATH = "http://192.168.1.57:8080/web";
- public void testGet() throws Exception {
- HttpClient client = new DefaultHttpClient();
- HttpGet get = new HttpGet(PATH
- + "/TestServlet?id=1001&name=john&age=60");
- HttpResponse response = client.execute(get);
- if (response.getStatusLine().getStatusCode() == HttpStatus.SC_OK) {
- InputStream is = response.getEntity().getContent();
- String result = inStream2String(is);
- Assert.assertEquals(result, "GET_SUCCESS");
- }
- }
- public void testPost() throws Exception {
- HttpClient client = new DefaultHttpClient();
- HttpPost post = new HttpPost(PATH + "/TestServlet");
- List<NameValuePair> params = new ArrayList<NameValuePair>();
- params.add(new BasicNameValuePair("id", "1001"));
- params.add(new BasicNameValuePair("name", "john"));
- params.add(new BasicNameValuePair("age", "60"));
- HttpEntity formEntity = new UrlEncodedFormEntity(params);
- post.setEntity(formEntity);
- HttpResponse response = client.execute(post);
- if (response.getStatusLine().getStatusCode() == HttpStatus.SC_OK) {
- InputStream is = response.getEntity().getContent();
- String result = inStream2String(is);
- Assert.assertEquals(result, "POST_SUCCESS");
- }
- }
- public void testUpload() throws Exception {
- InputStream is = getContext().getAssets().open("books.xml");
- HttpClient client = new DefaultHttpClient();
- HttpPost post = new HttpPost(PATH + "/UploadServlet");
- InputStreamBody isb = new InputStreamBody(is, "books.xml");
- MultipartEntity multipartEntity = new MultipartEntity();
- multipartEntity.addPart("file", isb);
- multipartEntity.addPart("desc", new StringBody("this is description."));
- post.setEntity(multipartEntity);
- HttpResponse response = client.execute(post);
- if (response.getStatusLine().getStatusCode() == HttpStatus.SC_OK) {
- is = response.getEntity().getContent();
- String result = inStream2String(is);
- Assert.assertEquals(result, "UPLOAD_SUCCESS");
- }
- }
- // 将输入流转换成字符串
- private String inStream2String(InputStream is) throws Exception {
- ByteArrayOutputStream baos = new ByteArrayOutputStream();
- byte[] buf = new byte[1024];
- int len = -1;
- while ((len = is.read(buf)) != -1) {
- baos.write(buf, 0, len);
- }
- return new String(baos.toByteArray());
- }
- }
首先,需要注意的是,我们定位服务器地址时使用到了IP,因为这里不能用localhost,服务端是在windows上运行,而本单元测试运行在Android平台,如果使用localhost就意味着在Android内部去访问服务,可能是访问不到的,所以必须用IP来定位服务.
我们先来分析一下testGet测试用例.我们使用了HttpGet,请求参数直接附在URL后面,然后由HttpClient执行GET请求,如果响应成功的话,取得响应内如输入流,并转换成字符串,最后判断是否为GET_SUCCESS.
testGet测试对应服务端Servlet代码如下:
- @Override
- protected void doGet(HttpServletRequest request,HttpServletResponse response) throws ServletException, IOException {
- System.out.println("doGet method is called.");
- String id = request.getParameter("id");
- String name = request.getParameter("name");
- String age = request.getParameter("age");
- System.out.println("id:" + id + ", name:" + name + ", age:" + age);
- response.getWriter().write("GET_SUCCESS");
- }
testPost测试对应的服务端代码如下:
- @Override
- protected void doPost(HttpServletRequest request,HttpServletResponse response) throws ServletException, IOException {
- System.out.println("doPost method is called.");
- String id = request.getParameter("id");
- String name = request.getParameter("name");
- String age = request.getParameter("age");
- System.out.println("id:" + id + ", name:" + name + ", age:" + age);
- response.getWriter().write("POST_SUCCESS");
- }
由于Android附带的HttpClient版本暂不支持多部件POST请求,所以我们需要用到一个HttpMime开源项目,该组件是专门处理与MIME类型有关的操作。因为HttpMime是包含在HttpComponents 项目中的,所以我们需要去apache官方网站下载HttpComponents,然后把其中的HttpMime.jar包放到项目中去。
然后,我们观察testUpload测试用例,我们用HttpMime提供的InputStreamBody处理文件流参数,用StringBody处理普通文本参数,最后把所有类型参数都加入到一个MultipartEntity的实例中,并将这个multipartEntity设置为此次POST请求的参数实体,然后执行POST请求。服务端Servlet代码如下:
- @SuppressWarnings("serial")
- public class UploadServlet extends HttpServlet {
- @Override
- @SuppressWarnings("rawtypes")
- protected void doPost(HttpServletRequest request,
- HttpServletResponse response) throws ServletException, IOException {
- boolean isMultipart = ServletFileUpload.isMultipartContent(request);
- if (isMultipart) {
- FileItemFactory factory = new DiskFileItemFactory();
- ServletFileUpload upload = new ServletFileUpload(factory);
- try {
- List items = upload.parseRequest(request);
- Iterator iter = items.iterator();
- while (iter.hasNext()) {
- FileItem item = (FileItem) iter.next();
- if (item.isFormField()) {
- // 普通文本信息处理
- String paramName = item.getFieldName();
- String paramValue = item.getString();
- System.out.println(paramName + ":" + paramValue);
- } else {
- // 上传文件信息处理
- String fileName = item.getName();
- byte[] data = item.get();
- String filePath = getServletContext().getRealPath(
- "/files")
- + "/" + fileName;
- FileOutputStream fos = new FileOutputStream(filePath);
- fos.write(data);
- fos.close();
- }
- }
- } catch (FileUploadException e) {
- e.printStackTrace();
- }
- }
- response.getWriter().write("UPLOAD_SUCCESS");
- }
- }
介绍完上面的三种不同的情况之后,我们需要考虑一个问题,在实际应用中,我们不能每次都新建HttpClient,而是应该只为整个应用创建一个HttpClient,并将其用于所有HTTP通信.此外,还应该注意在通过一个HttpClient同时发出多个请求时可能发生的多线程问题.针对这两个问题,我们需要改进一下我们的项目:
1.扩展系统默认的Application,并应用在项目中。
2.使用HttpClient类库提供的ThreadSafeClientManager来创建和管理HttpClient。
其中MyApplication扩展了系统的Application,代码如下:
- public class MyApplication extends Application {
- private HttpClient httpClient;
- @Override
- public void onCreate() {
- super.onCreate();
- httpClient = this.createHttpClient();
- }
- @Override
- public void onLowMemory() {
- super.onLowMemory();
- this.shutdownHttpClient();
- }
- @Override
- public void onTerminate() {
- super.onTerminate();
- this.shutdownHttpClient();
- }
- // 创建HttpClient实例
- private HttpClient createHttpClient() {
- HttpParams params = new BasicHttpParams();
- HttpProtocolParams.setVersion(params, HttpVersion.HTTP_1_1);
- HttpProtocolParams.setContentCharset(params,
- HTTP.DEFAULT_CONTENT_CHARSET);
- HttpProtocolParams.setUseExpectContinue(params, true);
- SchemeRegistry schReg = new SchemeRegistry();
- schReg.register(new Scheme("http", PlainSocketFactory
- .getSocketFactory(), 80));
- schReg.register(new Scheme("https",
- SSLSocketFactory.getSocketFactory(), 443));
- ClientConnectionManager connMgr = new ThreadSafeClientConnManager(
- params, schReg);
- return new DefaultHttpClient(connMgr, params);
- }
- // 关闭连接管理器并释放资源
- private void shutdownHttpClient() {
- if (httpClient != null && httpClient.getConnectionManager() != null) {
- httpClient.getConnectionManager().shutdown();
- }
- }
- // 对外提供HttpClient实例
- public HttpClient getHttpClient() {
- return httpClient;
- }
- }
然后,想要让我们这个加强版的“Application”生效,需要在AndroidManifest.xml中做如下配置:
- <application android:name=".MyApplication" ...>
- ....
- </application>
有了上面的配置,我们就可以在活动中应用了,HttpActivity.java代码如下:
- public class HttpActivity extends Activity {
- @Override
- protected void onCreate(Bundle savedInstanceState) {
- super.onCreate(savedInstanceState);
- setContentView(R.layout.main);
- Button btn = (Button) findViewById(R.id.btn);
- btn.setOnClickListener(new View.OnClickListener() {
- @Override
- public void onClick(View v) {
- execute();
- }
- });
- }
- private void execute() {
- try {
- MyApplication app = (MyApplication) this.getApplication(); // 获取MyApplication实例
- HttpClient client = app.getHttpClient(); // 获取HttpClient实例
- HttpGet get = new HttpGet(
- "http://192.168.1.57:8080/web/TestServlet?id=1001&name=john&age=60");
- HttpResponse response = client.execute(get);
- if (response.getStatusLine().getStatusCode() == HttpStatus.SC_OK) {
- InputStream is = response.getEntity().getContent();
- String result = inStream2String(is);
- Toast.makeText(this, result, Toast.LENGTH_LONG).show();
- }
- } catch (Exception e) {
- e.printStackTrace();
- }
- }
- // 将输入流转换成字符串
- private String inStream2String(InputStream is) throws Exception {
- ByteArrayOutputStream baos = new ByteArrayOutputStream();
- byte[] buf = new byte[1024];
- int len = -1;
- while ((len = is.read(buf)) != -1) {
- baos.write(buf, 0, len);
- }
- return new String(baos.toByteArray());
- }
- }