android访问网络：HttpURLConnection和HttpClient

转载请注明出处：http://blog.csdn.net/guolin_blog/article/details/12452307

最近在研究Volley框架的源码，发现它在HTTP请求的使用上比较有意思，在Android 2.3及以上版本，使用的是HttpURLConnection，而在Android 2.2及以下版本，使用的是HttpClient。我也比较好奇这么使用的原因，于是专门找到了一位Google的工程师写的一篇博客，文中对HttpURLConnection和HttpClient进行了对比，下面我就给大家简要地翻译一下。

原文地址：http://android-developers.blogspot.com/2011/09/androids-http-clients.html

大多数的Android应用程序都会使用HTTP协议来发送和接收网络数据，而Android中主要提供了两种方式来进行HTTP操作，HttpURLConnection和HttpClient。这两种方式都支持HTTPS协议、以流的形式进行上传和下载、配置超时时间、IPv6、以及连接池等功能。

Http通信中的POST和GET请求方式的不同。GET可以获得静态页面，也可以把参数放在URL字符串后面，传递给服务器。而POST方法的参数是放在Http请求中。

HttpClient

DefaultHttpClient和它的兄弟AndroidHttpClient都是HttpClient具体的实现类，它们都拥有众多的API，而且实现比较稳定，bug数量也很少。

但同时也由于HttpClient的API数量过多，使得我们很难在不破坏兼容性的情况下对它进行升级和扩展，所以目前Android团队在提升和优化HttpClient方面的工作态度并不积极。

使用Apache提供的HttpClient接口同样可以进行HTTP操作。

HttpClient是一个接口，所以无法new它的实例，通常需要创建一个DefaultHttpClient的实例
    对于GET和POST请求方法的操作有所不同。GET方法的操作代码示例如下：

// http地址  
        String httpUrl = "http://192.168.1.110:8080/httpget.jsp?par=HttpClient_android_Get";  
        //HttpGet连接对象  
        HttpGet httpRequest = new HttpGet(httpUrl);  
         //取得HttpClient对象  
            HttpClient httpclient = new DefaultHttpClient(); // 
            //请求HttpClient，取得HttpResponse  
            HttpResponse httpResponse = httpclient.execute(httpRequest);  
            //请求成功  
            if (httpResponse.getStatusLine().getStatusCode() == HttpStatus.SC_OK)  
            {  
                //取得返回的字符串  
                String strResult = EntityUtils.toString(httpResponse.getEntity());  
                mTextView.setText(strResult);  
            }  
            else 
            {  
                mTextView.setText("请求错误!");  
            }  
        } 

   

创建一个DefaultHttpClient实例。然后创建HttpGet实例并传入url地址，接着调用HttpClient的execute()方法。execute()会返回一个HttpResponse对象，判断服务器返回的状态码，如果等于200就响应成功。 由getEntity()得到一个HttpEntity实例，再用EntityUtiles.toString()方法将entity转化成字符串

 使用POST方法进行参数传递时，需要使用NameValuePair来保存要传递的参数。，另外，还需要设置所使用的字符集。代码如下所示： 

// http地址  
        String httpUrl = "http://192.168.1.110:8080/httpget.jsp";  
        //HttpPost连接对象  
        HttpPost httpRequest = new HttpPost(httpUrl);  
        //使用NameValuePair来保存要传递的Post参数  
        List<NameValuePair> params = new ArrayList<NameValuePair>();  
        //添加要传递的参数  
        params.add(new BasicNameValuePair("par", "HttpClient_android_Post"));  
        //设置字符集  
            HttpEntity httpentity = new UrlEncodedFormEntity(params, "gb2312");  
            //请求httpRequest  
            httpRequest.setEntity(httpentity);  
            //取得默认的HttpClient  
            HttpClient httpclient = new DefaultHttpClient();  
            //取得HttpResponse  
            HttpResponse httpResponse = httpclient.execute(httpRequest);  
            //HttpStatus.SC_OK表示连接成功  
            if (httpResponse.getStatusLine().getStatusCode() == HttpStatus.SC_OK)  
            {  
                //取得返回的字符串  
                String strResult = EntityUtils.toString(httpResponse.getEntity());  
                mTextView.setText(strResult);  
            }  
            else 
            {  
                mTextView.setText("请求错误!");  
            }  
        } 

  

创建一个HttpPost实例并传入目标的网络地址。通过一个NameValuePair的集合存放要提交的数据，并将集合传入到UrlEncodedFormEntity中。调用HttpPost的setEntity()方法把该entity传入，接下来的操作与GET相同了。  

HttpClient实际上是对Java提供方法的一些封装，在HttpURLConnection中的输入输出流操作，在这个接口中被统一封装成了HttpPost(HttpGet)和HttpResponse，这样，就减少了操作的繁琐性。

    另外，在使用POST方式进行传输时，需要进行字符编码。

HttpURLConnection

HttpURLConnection是一种多用途、轻量极的HTTP客户端，使用它来进行HTTP操作可以适用于大多数的应用程序。虽然HttpURLConnection的API提供的比较简单，但是同时这也使得我们可以更加容易地去使用和扩展它。

HttpURLConnection是继承于URLConnection类，二者都是抽象类。其对象主要通过URL的openConnection方法获得

HttpURLConnection默认使用GET方式，例如下面代码所示：

//使用HttpURLConnection打开连接  
                HttpURLConnection urlConn = (HttpURLConnection) url.openConnection(); 
                //得到读取的内容(流)  
                InputStreamReader in = new InputStreamReader(urlConn.getInputStream())
                // 为输出创建BufferedReader  
                BufferedReader buffer = new BufferedReader(in);  
                String inputLine = null;  
                //使用循环来读取获得的数据  
                while (((inputLine = buffer.readLine()) != null))  
                {  
                    //我们在每一行后面加上一个"\n"来换行  
                    resultData += inputLine + "\n";  
                }           
                //关闭InputStreamReader  
                in.close();  
                //关闭http连接  
                urlConn.disconnect(); 

  

创建一个URL实例，并传入目标网址，然后调用他的openConnection，得到HttpURLConnection。调用conn的setRequestMethod设置POST和GET方式;setReadTimeOut设置读取超时；setConnectTimeOut设置连接超时。最后调用getInputStream得到服务器返回的输入流。注意最后要disconnect关闭连接。

  如果需要使用POST方式，则需要setRequestMethod设置。代码如下：

String httpUrl = "http://192.168.1.110:8080/httpget.jsp";  
        //获得的数据  
        String resultData = "";  
        URL url = null;  
        try 
        {  
            //构造一个URL对象  
            url = new URL(httpUrl);   
        }  
        catch (MalformedURLException e)  
        {  
            Log.e(DEBUG_TAG, "MalformedURLException");  
        }  
        if (url != null)  
        {  
            try 
            {  
                // 使用HttpURLConnection打开连接  
                HttpURLConnection urlConn = (HttpURLConnection) url.openConnection(); 
                //因为这个是post请求,设立需要设置为true  
                urlConn.setDoOutput(true);  
                urlConn.setDoInput(true);  
                // 设置以POST方式  
                urlConn.setRequestMethod("POST");  
                // Post 请求不能使用缓存  
                urlConn.setUseCaches(false);  
                urlConn.setInstanceFollowRedirects(true);  
                // 配置本次连接的Content-type，配置为application/x-www-form-urlencoded的  
                urlConn.setRequestProperty("Content-Type","application/x-www-form-urlencoded");  
                // 连接，从postUrl.openConnection()至此的配置必须要在connect之前完成，  
                // 要注意的是connection.getOutputStream会隐含的进行connect。  
                urlConn.connect();  
                //DataOutputStream流  
                DataOutputStream out = new DataOutputStream(urlConn.getOutputStream());  
                //要上传的参数  
                String content = "par=" + URLEncoder.encode("ABCDEFG", "gb2312");  
                //将要上传的内容写入流中  
                out.writeBytes(content);   
                //刷新、关闭  
                out.flush();  
                out.close();  

不过在Android 2.2版本之前，HttpURLConnection一直存在着一些令人厌烦的bug。比如说对一个可读的InputStream调用close()方法时，就有可能会导致连接池失效了。那么我们通常的解决办法就是直接禁用掉连接池的功能：

[java] view plaincopy

1. private void disableConnectionReuseIfNecessary() {  
2.     // 这是一个2.2版本之前的bug  
3.     if (Integer.parseInt(Build.VERSION.SDK) < Build.VERSION_CODES.FROYO) {  
4.         System.setProperty("http.keepAlive", "false");  
5.     }  
6. }  

在Android 2.3版本的时候，我们加入了更加透明化的响应压缩。HttpURLConnection会自动在每个发出的请求中加入如下消息头，并处理相应的返回结果：

Accept-Encoding: gzip

配置你的Web服务器来支持对客户端的响应进行压缩的功能，从而可以在这一改进上获取到最大的好处。如果在压缩响应的时候出现了问题，这篇文档会告诉你如何禁用掉这个功能。

但是如果启动了响应压缩的功能，HTTP响应头里的Content-Length就会代表着压缩后的长度，这时再使用getContentLength()方法来取出解压后的数据就是错误的了。正确的做法应该是一直调用InputStream.read()方法来读取响应数据，一直到出现-1为止。

我们在Android 2.3版本中还增加了一些HTTPS方面的改进，现在HttpsURLConnection会使用SNI(Server Name Indication)的方式进行连接，使得多个HTTPS主机可以共享同一个IP地址。除此之外，还增加了一些压缩和会话的机制。如果连接失败，它会自动去尝试重新进行连接。这使得HttpsURLConnection可以在不破坏老版本兼容性的前提下，更加高效地连接最新的服务器。

在Android 4.0版本中，我们又添加了一些响应的缓存机制。当缓存被安装后(调用HttpResponseCache的install()方法)，所有的HTTP请求都会满足以下三种情况：

所有的缓存响应都由本地存储来提供。因为没有必要去发起任务的网络连接请求，所有的响应都可以立刻获取到。

视情况而定的缓存响应必须要有服务器来进行更新检查。比如说客户端发起了一条类似于 “如果/foo.png这张图片发生了改变，就将它发送给我” 这样的请求，服务器需要将更新后的数据进行返回，或者返回一个304 Not Modified状态。如果请求的内容没有发生，客户端就不会下载任何数据。

没有缓存的响应都是由服务器直接提供的。这部分响应会在稍后存储到响应缓存中。

由于这个功能是在4.0之后的版本才有的，通常我们就可以使用反射的方式来启动响应缓存功能。下面的示例代码展示了如何在Android 4.0及以后的版本中去启用响应缓存的功能，同时还不会影响到之前的版本：

[java] view plaincopy

1. private void enableHttpResponseCache() {  
2.     try {  
3.         long httpCacheSize = 10 * 1024 * 1024; // 10 MiB  
4.         File httpCacheDir = new File(getCacheDir(), "http");  
5.         Class.forName("android.net.http.HttpResponseCache")  
6.             .getMethod("install", File.class, long.class)  
7.             .invoke(null, httpCacheDir, httpCacheSize);  
8.     } catch (Exception httpResponseCacheNotAvailable) {  
9.     }  
10. }  

你也应该同时配置一下你的Web服务器，在HTTP响应上加入缓存的消息头。

哪一种才是最好的？

在Android 2.2版本之前，HttpClient拥有较少的bug，因此使用它是最好的选择。

而在Android 2.3版本及以后，HttpURLConnection则是最佳的选择。它的API简单，体积较小，因而非常适用于Android项目。压缩和缓存机制可以有效地减少网络访问的流量，在提升速度和省电方面也起到了较大的作用。对于新的应用程序应该更加偏向于使用HttpURLConnection，因为在以后的工作当中我们也会将更多的时间放在优化HttpURLConnection上面。

1、HttpClient比HttpURLConnection功能更强大，但是做java建议用前者，安卓建议用后者

2、这两者都支持HTTPS，streaming 上传与下载，配置超时时间，IPv6, 以及连接池。

3.区别

HttpClient是个很不错的开源框架，封装了访问http的请求头，参数，内容体，响应等等，

HttpURLConnection是java的标准类，什么都没封装，用起来太原始，不方便，比如重访问的自定义，以及一些高级功能等。

4、Android5.1之后就废止了HttpClient的相关Api

5、

在一般情况下，如果只是需要Web站点的某个简单页面提交请求并获取服务器响应，HttpURLConnection完全可以胜任。但在绝大部分情况下，Web站点的网页可能没这么简单，这些页面并不是通过一个简单的URL就可访问的，可能需要用户登录而且具有相应的权限才可访问该页面。在这种情况下，就需要涉及Session、Cookie的处理了，如果打算使用HttpURLConnection来处理这些细节，当然也是可能实现的，只是处理起来难度就大了。

HttpClient更方便更强大的解决了HttpURLConnection能做到或者不能做到的事情，HttpClient模块提供的两大类HttpPost和HttpGet实现Http请求：

       HttpPost —— 传送的数据量较大，一般被默认为不受限制。一般用于发送一些表单数据，传输数据更安全

       HttpGet —— 传送的数据量较小，不能大于2KB。一般用于请求获取一些信息，执行效率更高

6、

哪一种才是最好的？

在Android 2.2版本之前、HttpClient拥有较少的bug、因此使用它是最好的选择、而在Android 2.3版本及以后、HttpURLConnection则是最佳的选择、它的API简单、体积较小、因而非常适用于Android项目、压缩和缓存机制可以有效地减少网络访问的流量、在提升速度和省电方面也起到了较大的作用、对于新的应用程序应该更加偏向于使用HttpURLConnection、因为在以后的工作当中我们也会将更多的时间放在优化HttpURLConnection上面、其实我们也可以使用另外一个框架Volley