android 网络编程 - HttpURLConnection与HttpClient

最新推荐文章于 2024-03-30 10:40:09 发布

原创最新推荐文章于 2024-03-30 10:40:09 发布 · 550 阅读

1 ·

CC 4.0 BY-SA版权

文章标签：

#android #apache #网络编程 #HttpClient #httpurlconnection-线程

Android 专栏收录该内容

20 篇文章

订阅专栏

安卓和Java应用开发少不了要提交HTTP请求，而基本上目前有两个实现方式：HttpUrlConnection（即URL.openConnection）和HttpClient。 HttpClient是apache的开源实现，而HttpUrlConnection是安卓标准实现。

1. HttpURLConnection

Android 2.2版本之前，HttpURLConnection一直存在着一些令人厌烦的bug。比如说对一个可读的InputStream调用close()方法时，就有可能会导致连接池失效了。那么我们通常的解决办法就是直接禁用掉连接池的功能。所以在Android 2.2版本以及之前的版本使用HttpClient是较好的选择，而在Android 2.3版本及以后，HttpURLConnection则是最佳的选择，它的API简单，体积较小，因而非常适用于Android项目。压缩和缓存机制可以有效地减少网络访问的流量，在提升速度和省电方面也起到了较大的作用。另外在Android 6.0版本中，HttpClient库被移除了。

1.1 Get

首先需要获取到 HttpURLConnection 的实例，一般只需 new 出一个 URL 对象，并传入目标的网络地址，然后调用一下 openConnection()方法即可。得到了 HttpURLConnection 的实例之后，我们可以设置一下 HTTP 请求所使用的方法。常用的方法主要有两个，GET 和 POST。GET 表示希望从服务器那里获取数据，而 POST 则表示希望提交数据给服务器。接下来就可以进行一些自由的定制了，比如设置连接超时、读取超时的毫秒数，以及服务器希望得到的一些消息头等。这部分内容根据自己的实际情况进行编写。之后再调用 getInputStream()方法就可以获取到服务器返回的输入流了，剩下的任务就是对输入流进行读取。接着利用 BufferedReader 对服务器返回的流进行读取，并将结果存放到了一个 Message 对象中。这里为什么要使用 Message 对象呢?当然是因为子线程中无法对 UI 进行操作了。我们希望可以将服务器返回的内容显示到界面上，所以就创建了一个 Message 对象，并使用 Handler 将它发送出去。之后又在 Handler 的 handleMessage()方法中对这条 Message 进行处理。最后可以调用 disconnect()方法将这个 HTTP 连接关闭掉。


private void connectWithHttpURLConnection() {
    new Thread( new Runnable() {
        @Override
        public void run() {
            HttpURLConnection connection = null;
            try {
                // 调用URL对象的openConnection方法获取HttpURLConnection的实例
                URL url = new URL("http://www.cnblogs.com/gzdaijie");
                connection = (HttpURLConnection) url.openConnection();
                // 设置请求方式，GET或POST
                connection.setRequestMethod("GET");
                // 设置连接超时、读取超时的时间，单位为毫秒（ms）
                connection.setConnectTimeout(8000);
                connection.setReadTimeout(8000);
                // getInputStream方法获取服务器返回的输入流
                InputStream in = connection.getInputStream();
                // 使用BufferedReader对象读取返回的数据流
                // 按行读取，存储在StringBuider对象response中
                BufferedReader reader = new BufferedReader(new InputStreamReader(in));
                StringBuilder response = new StringBuilder();
                String line;
                while ((line = reader.readLine()) != null) {
                    response.append(line);
                }
                Message message = new Message(); 
                message.what = SHOW_RESPONSE;
                // 将服务器返回的结果存放到Message中 
                message.obj = response.toString();
                handler.sendMessage(message);
            } catch (Exception e){
                e.printStackTrace();
            } finally {
                if (connection != null){
                    // 结束后，关闭连接
                    connection.disconnect();
                }
            }
        }
    }).start();
}

1.2 Post

注意需要对中文进行设置编码格式

URLEncoder.encode(nickname.getText().toString(), “utf-8”)

public void send() {
        String target = "http://192.168.1.66:8081/blog/dealPost.jsp";   //要提交的目标地址
        URL url;
        try {
            url = new URL(target);
            HttpURLConnection urlConn = (HttpURLConnection) url.openConnection(); // 创建一个HTTP连接
            urlConn.setRequestMethod("POST"); // 指定使用POST请求方式
            urlConn.setDoInput(true); // 向连接中写入数据
            urlConn.setDoOutput(true); // 从连接中读取数据
            urlConn.setUseCaches(false); // 禁止缓存
            urlConn.setInstanceFollowRedirects(true);   //自动执行HTTP重定向

            DataOutputStream out = new DataOutputStream(urlConn.getOutputStream()); // 获取输出流
            String param = "nickname="
                    + URLEncoder.encode(nickname.getText().toString(), "utf-8")
                    + "&content="
                    + URLEncoder.encode(content.getText().toString(), "utf-8"); //连接要提交的数据
            out.writeBytes(param);//将要传递的数据写入数据输出流
            out.flush();    //输出缓存
            out.close();    //关闭数据输出流
            // 判断是否响应成功
            if (urlConn.getResponseCode() == HttpURLConnection.HTTP_OK) {
                InputStreamReader in = new InputStreamReader(urlConn.getInputStream()); // 获得读取的内容
                BufferedReader buffer = new BufferedReader(in); // 获取输入流对象
                String inputLine = null;
                while ((inputLine = buffer.readLine()) != null) {
                    result += inputLine + "\n";
                }
                in.close(); //关闭字符输入流
            }
            urlConn.disconnect();   //断开连接
        } catch (MalformedURLException e) {
            e.printStackTrace();
        } catch (IOException e) {
            e.printStackTrace();
        }
    }

2. HttpClient

HttpClient是Apache提供的库，提供了高效的、最新的支持HTTP协议的工具包，封装了众多的http请求、响应等方法，但有个缺点就是太重量级了，API太多了。

2.1 Get

首先你需要知道，HttpClient 是一个接口，因此无法创建它的实例，通常情况下都会创建一个 DefaultHttpClient 的实例。接下来如果想要发起一条 GET 请求，就可以创建一个 HttpGet 对象，并传入目标的网络地址，然后调用 HttpClient 的 execute()方法即可。执行 execute()方法之后会返回一个 HttpResponse 对象，服务器所返回的所有信息就会包含在这里面。通常情况下我们都会先取出服务器返回的状态码，如果等于 200 就说明请求和响应都成功了。接下来在这个 if 判断的内部取出服务返回的具体内容，可以调用 getEntity()方法获取到一个 HttpEntity 实例，然后再用 EntityUtils.toString()这个静态方法将 HttpEntity 转换成字符串即可。注意如果服务器返回的数据是带有中文的，直接调用 EntityUtils.toString()方法进行转换会有乱码的情况出现，这个时候只需要在转换的时候将字符集指定成 utf-8 就可以了。

    // 创建DefaultHttpClient实例
    HttpClient httpClient = new DefaultHttpClient();      
    //传入网址，然后执行
    HttpGet httpGet = new HttpGet("http://www.cnblogs.com/gzdaijie");
    HttpResponse httpResponse = httpClient.execute(httpGet); 
    // 由状态码判断请求结果，
    // 常见状态码 200 请求成功，404 页面未找到，关于HTTP的更多状态码直接GOOGLE
    if (httpResponse.getStatusLine().getStatusCode() == HttpStatus.SC_OK) {       
        // 请求成功，使用HttpEntity获得返回数据
        // 使用EntityUtils将返回数据转换为字符串
        HttpEntity entity = httpResponse.getEntity(); 
        String response = EntityUtils.toString(entity);
        //如果是中文，指定编码 
        //==>String response = EntityUtils.toString(entity, "utf-8"); 

        //或者生成一个BufferedReader
        BufferedReader reader = new BufferedReader(new InputStreamReader(httpResponse.getEntity().getContent()));
    }

2.2 Post

    HttpClient httpClient = new DefaultHttpClient();
    HttpPost httpPost("http://www.cnblogs.com/gzdaijie");  
    // 使用NameValuePair（键值对）存放参数
    List<NameValuePair> data = new ArrayList<NameValuePair>();
    // 添加键值对
    data.add(new BasicNameValuePair("stu_no", 12345));
    data.add(new BasicNameValuePair("stu_name", "Tom"));
    // 使用setEntity方法传入编码后的参数
    httpPost.setEntity(new UrlEncodedFormEntity(data, "utf-8")); 
    // 执行该POST请求
    HttpResponse httpResponse = httpClient.execute(httpPost);
    // .....省略处理httpResponse的代码，与GET方式一致

3. 用回调函数实现网络编程

3.1 定义接口HttpCallbackListener，为了实现回调

在接口中定义了两个方法，onFinish()方法表示当服务器成功响应我们请求的时候调用，onError()表示当进行网络操作出现错误的时候调用。这两个方法都带有参数， onFinish()方法中的参数代表着服务器返回的数据，而 onError()方法中的参数记录着错误的详细信息。

// 定义HttpCallbackListener接口
// 包含两个方法，成功和失败的回调函数定义
public interface HttpCallbackListener {
    void onFinish(String response);
    void onError(Exception e);
}

3.2 定义类HttpUtil，为了网络助手类

先给 sendHttpRequest()方法添加了一个 HttpCallbackListener 参数，并在方法的内部开启了一个子线程，然后在子线程里去执行具体的网络操作。注意子线程中是无法通过 return 语句来返回数据的，因此这里我们将服务器响应的数据传入了 HttpCallbackListener 的 onFinish()方法中，如果出现了异常就将异常原因传入到 onError()方法中。

/* 创建一个新的类 HttpTool，将公共的操作抽象出来
 * 为了避免调用sendHttpRequest方法时需实例化，设置为静态方法
 * 传入HttpCallbackListener对象为了方法回调
 * 因为网络请求比较耗时，一般在子线程中进行，
 * 为了获得服务器返回的数据，需要使用java的回调机制 */

public class HttpTool {
    public static void sendHttpRequest(final String address, final HttpCallbackListener listener) {
        new Thread(new Runnable() {
            @Override
            public void run() {
                HttpURLConnection connection = null;

                try {
                    URL url = new URL(address);
                    connection = (HttpURLConnection) url.openConnection();
                    connection.setRequestMethod("GET");
                    connection.setConnectTimeout(8000);
                    connection.setReadTimeout(8000);
                    InputStream in = connection.getInputStream();
                    BufferedReader reader = new BufferedReader(new InputStreamReader(in));
                    StringBuilder response = new StringBuilder();      
                    String line;
                    while ((line = reader.readLine()) != null) {
                        response.append(line);
                    }
                    if (listener != null) {
                        // 回调方法 onFinish()
                        listener.onFinish(response.toString());
                    }
                } catch (Exception e) {
                    if (listener != null) {
                        // 回调方法 onError()
                        listener.onError(e);
                    }
                } finally {
                    if (connection != null) {
                        connection.disconnect();
                    }
                }
            }
        }).start();
    }
}

3.3 调用网络助手类

这样的话，当服务器成功响应的时候我们就可以在 onFinish()方法里对响应数据进行处理了，类似地，如果出现了异常，就可以在 onError()方法里对异常情况进行处理。如此一来，我们就巧妙地利用回调机制将响应数据成功返回给调用方了。
另外需要注意的是，onFinish()方法和 onError()方法最终还是在子线程中运行的，因此我们不可以在这里执行任何的 UI 操作，如果需要根据返回的结果来更新 UI，则仍然要使用异步消息处理机制（Handler）。

//使用该HttpTool发起GET请求
String url = "http://www.cnblogs.com/gzdaijie";
HttpTool.sendHttpRequest(url,new HttpCallbackListener(){
    @Override  
    public void onFinish(String response) {
        // ...省略对返回结果的处理代码  
    }  

    @Override  
    public void onError(Exception e) {   
        // ...省略请求失败的处理代码
    } 
});