首页 > 代码库 > AndroidHttpClient详解
AndroidHttpClient详解
AndroidHttpClient结构：
public final classAndroidHttpClientextends Objectimplements HttpClient
前言：这类其实是Google对阿帕奇的HttpClient的一个封装，一些默认属性有android做了一些优化。
然后阿帕奇的HttpClient是对java中HttpUrlConnection的一个封装，感觉阿帕奇封装的还是不错的，
特别是其中的HttpEntity，很强大也很好用，能在android手机上上传百M的文件到服务器，还是不错的。
一：AndroidHttpClient的使用方式
1.创建AndroidHttpClient对象
AndroidHttpClient c = AndroidHttpClient.newInstance(""); AndroidHttpClient只能通过以上方法建立，其中的参数好像是设置代理的，如果没有置空即可。
2.使用开启cookies
AndroidHttpClient默认情况下是关闭cookies的，开启的方法如下
AndroidHttpClient c = AndroidHttpClient.newInstance("");
BasicHttpContext context = new BasicHttpContext();
context.setAttribute(ClientContext.COOKIE_STORE, new BasicCookieStore());
try {
c.execute(null, context);
} catch (IOException e) {
// TODO Auto-generated catch block
e.printStackTrace();
}
其中的context在client发送的请求的时候，同时发送即可。发送请求方法的第一个参数，很重要，下面详解。
二：HttpUriRequest使用
1.上面的c.execute(null, context);第一个参数即为HttpUriRequest，用于封装请求信息的。
HttpUriRequest提供了两个使用的子类，相信你闭着眼睛也能猜到，没错！就是HttpGet和HttpPost。
2.ok，我们先来看看，HttpGet是怎么用的。
题外话，其实从这个方法的名字上就能看出来，get嘛，
就是获取的得到的意思，所以如果你想从服务器获取什么数据，就多用用他吧。
HttpGet提供了三个构造函数：
——HttpGet()
——HttpGet(URI uri)
——HttpGet(String uri)
看上面的最后两个构造方法，你应该能猜到那个参数的意义了，就是想要
获取文件的地址！其实第一个虽然没有提供一个地址，但是HttpGet有个
方法可以设置资源地址：HttpGet.setURI(URI uri);
看下他的具体初始化方式：
方式一：
try { final String _URI = "www.baidu.com"; HttpGet requestGet = new HttpGet(); requestGet.setURI(new URI(_URI)); } catch (URISyntaxException e) { // TODO Auto-generated catch block e.printStackTrace(); }
方式二：
try { final String _URI = "www.baidu.com"; HttpGet requestGet = new HttpGet(new URI(_URI)); } catch (URISyntaxException e) { // TODO Auto-generated catch block e.printStackTrace(); }
方式三：
final String _URI = "www.baidu.com"; HttpGet requestGet = new HttpGet(_URI);
3.好了，当创建好了HttpGet对象之后，就可以将其放入AndroidHttpClient访问了。
有人说使用Get方式访问的时候，能不能在后面添加用户名和密码什么的，其实加不加
都可以，因为在服务器那边获取的方式是一样的，但是我觉得如果有参数的话，还是不要
直接加在资源地址后面吧，因为我感觉太难看了。。。看起来不整洁，哈哈。
那有人说了，那怎么有参数的时候怎么办呢？下面就给你解决的方案，HttpPost闪亮登场！
4.HttpPost这个东西，其实最NB的地方是他能放入一个实体（Entity）发送到服务器，这个
实体能够封装各种数据，将想发送的数据封装到Entity中，然后调用HttpPost的setEntity方法
将实体放入其中，然后发送请求就行了。所以下面就好讲解一下Entity的都能封装什么类型的数据。
HttpPost的初始化方式和HttpGet一样的，就是将HttpGet换成HttpPost就行了。
三：HttpEntity讲解（本博文的重点）
1.有的同学可能会觉得，看博文文字太多看的很是无聊，来张图片多好。既然大家有着要求，那就满足你。
要是觉得图片看着不是清晰，可以将图片拖拽到桌面，慢慢欣赏。
2.上面的图片显示了HttpEntity的大致结构，interface和abstract我就不多说了，
其实也没什么说的，就是定义了一些方法，但是还没实现，等着之后的class来具体实现的，
打个比喻，interface就是项目经理，class就是咱们这些**了，所以还是来说说我们吧。
——InputStreamEntity：他就是将一个IO流封装到实体中，这个东西很NB，经过我的实测，
能发送百M的数据到服务器，而且不是OOM(内存溢出)，之前做一个视频拍摄，然后上传的
项目的时候，就遇到过视频上传的时候会有OOM问题，后来用分割上传的方式解决了，但是直
到发现这个方法的时候，发现阿帕奇已经给准备好了，还得多看书啊。
我这里是读取的assets下的一个文件，将其转换为io流，然后放入了实体中。在new这个实体的
时候，需要提供一个int参数，这个参数的数值可以小于或等于IO流的大小，否则会报错，当参数
的数值小于IO的大小时，会截取上传IO，比如IO流的内容是阿拉伯数字 1到10，而参数数值你用了5
那服务器只能接收到1 2 3 4 5.
try { // 读取assets中的文件将其转换为io流 InputStream is = getActivity().getAssets().open("Text.xml"); mEntitys.add(new InputStreamEntity(is, is.available())); } catch (IOException e) { // TODO Auto-generated catch block e.printStackTrace(); }
——ByteArrayEntity：将byte数组封装到实体中，有的时候你可能获取到了一个byte对象，而不是io对象，
所以直接使用这个方法就可以将byte封装到实体中，而不用转换一下。
try { // 读取assets中的文件将其转换为io流 InputStream is = getActivity().getAssets().open("Text.xml"); // 定义一个字节数组封装io流 byte[] b = new byte[is.available()]; // 将io读入到数组中 is.read(b); mEntitys.add(new ByteArrayEntity(b)); } catch (IOException e) { // TODO Auto-generated catch block e.printStackTrace(); }
——StringEntity：这个实体还是比较使用的，他能直接将一个字符串封装到实体中，我看过
有人用这个东西去发送图片，就是将图片转成byte，然后在转成Base64编码的数据，再添加到
这个实体中，其实我感觉这个就是放字符串的，就不要将图片什么的，放进来了，毕竟还有专门
放文件的实体呢对吧？
try { // 创建一个字符串 String str = "Hello world"; mEntitys.add(new StringEntity(str)); } catch (UnsupportedEncodingException e) { // TODO Auto-generated catch block e.printStackTrace(); }
——UrlEncodedFormEntity：将请求的内容进行格式化了，其实这个方法同时简化的客户端发送，
也简化了服务器端获取，服务器通过getParameters（String name）即可获取到传送来的信息。
方便的原因是将发送的信息键值对化了，键值对，你懂得，就是一个Key对应一个Value呗，所以客户端
需要创建一个键值对对象即：NameValuePair。而UrlEncodedFormEntity为了一次能发送多个键值对，
参数采用了集合的方式：List<NameValuePair>。
/** * 服务器端，只需要使用getParameters（String name）即可获得属性值 */ try { // post请求，需要一个K-V集合数组，来保存请求的信息，并将其放去请求实体中 List<NameValuePair> postParameters = new ArrayList<NameValuePair>(); // 添加属性对 postParameters.add(new BasicNameValuePair("name", "android")); mEntitys.add(new UrlEncodedFormEntity(postParameters)); } catch (UnsupportedEncodingException e) { // TODO Auto-generated catch block e.printStackTrace(); }
——SerializableEntity：这个东西JB太强大了，不好意思爆粗口了，因为真的很NB，相信很多朋友在获取服务器，
或是上传东西到服务器的时候，都遇到这样的问题，比如获取用户列表，有很多用户，通常是服务器返回xml或是json，
然后我们再去解析，生成一个JavaBean对象，对吧，然后在创建一个集合将这些对象放进去，很是繁琐，特别是解析的时候，
可是如果你使用SerializableEntity这个实体的时候，你会发现，生活原来如此美好，因为你可以直接将序列化的对象放入实体中，
然后发送，客户端或是服务器可以直接接受这个对象！听明白了吗？你不需要解析什么xml或是json，直接就能获取到这个对象了！
是不是很NB，但是NB需要有前提的，就是你的服务器得是Java的，所以和IOS平台交互的时候，还得需要json什么的。。。。
*有一点一定要注意，使用他的时候，被序列化的对象所在包的包名，服务器和客户端必须一致，必须哦，其实可以做一个jar包，然后
服务器和客户端一起使用。
package com.xhm.Test.Http;import java.io.Serializable;public class Student implements Serializable { private static final long serialVersionUID = 1L; private String name; private int age; public String getName() { return name; } public void setName(String name) { this.name = name; } public int getAge() { return age; } public void setAge(int age) { this.age = age; }}
/** * 在使用这个实体的时候要注意，对象的bean所在的包名要是服务器上的一致，否则会有问题。 */ try { // 创建对象 Student student = new Student(); student.setName("Name"); student.setAge(11); mEntitys.add(new SerializableEntity(student, true)); } catch (IOException e) { // TODO Auto-generated catch block e.printStackTrace(); }
——FileEntity：这个也真心NB，直说吧，我将一个450M的rmvb的电影成功上传的服务器上了，服务器正常打开观看。
妈妈再也不同担心我的OOM问题了。而且这个使用起来还很简单，只要提供文件的路径和文件类型就行了。
/** * 这个实体，能够封装一些比较大的实体，比如上百M的文件等 * * 上传的时候，注意本demo没有做进度条，在成功上传之后，会返回上传文件的大小 */ // 创建文件路径，这个视频是在SD卡中的，大概有50M大小 File file = new File("/sdcard/DCIM/dashipin.mp4"); mEntitys.add(new FileEntity(file, "*/*"));
——EntityTemplate：说实话，这个实体我还不清楚，究竟怎么去使用，或是应用什么场景，反正他有点
特别，因为需要一个ContentProducer对象来初始化。
// 创建ContentProducer对象 ContentProducer producer = new ContentProducer() { @Override public void writeTo(OutputStream outstream) throws IOException { // TODO Auto-generated method stub Writer writer = new OutputStreamWriter(outstream); writer.write("hello"); writer.write("world"); writer.flush(); writer.close(); } }; mEntitys.add(new EntityTemplate(producer));
好了上面就是HttpEntity的一些东西，有什么不对的地方，希望批评指正！谢谢。
四：里面使用到的一些方法
1.执行请求和解析反馈的结果
/** * 执行post网络访问 * * @param entity * 请求实体 */ private void executePost(final HttpPost request, final HttpEntity entity) { try { request.setEntity(entity); // 连接服务器，并获得反馈的response mResponse = mClient.execute(request); // 从反馈的response中获得输入流 BufferedReader mReader = new BufferedReader(new InputStreamReader( mResponse.getEntity().getContent())); Message msg = new Message(); msg.obj = "UpLoad请求\n" + BR2SB(mReader).toString(); mHandler.sendMessage(msg); } catch (ClientProtocolException e) { // TODO Auto-generated catch block e.printStackTrace(); } catch (IOException e) { // TODO Auto-generated catch block e.printStackTrace(); }
/** * 将BufferedReader转换为StringBuffer * * @param br * @throws IOException */ protected StringBuffer BR2SB(BufferedReader br) throws IOException { StringBuffer sb = new StringBuffer(""); String line = null; while ((line = br.readLine()) != null) { sb.append(line + "\n"); } return sb; }
mHandler = new Handler(new Callback() { @Override public boolean handleMessage(Message msg) { // TODO Auto-generated method stub mTextView.setText(msg.obj.toString()); return false; } });
提示：因为android为了安全在3.0之后不允许将HTTP请求放在主线程中，所以必须使用Thread，所以这里也使用的handler来发送http反馈的信息！