Android HTTP请求方式:HttpClient

在 Android 开发中，HttpClient 是 Apache 提供的一个 HTTP 客户端库，早期广泛用于网络请求。然而，需要明确的是，HttpClient（具体指 org.apache.http.client.HttpClient）在 Android API 22（Android 5.1）及以上版本中已被废弃，官方推荐使用 HttpURLConnection 或第三方库（如 OkHttp、Retrofit）。尽管如此，了解 HttpClient 的使用对学习历史代码或维护旧项目仍有价值。

以下是关于 Android 中使用 HttpClient 进行 HTTP 请求的详细学习指南，包括请求方式、代码示例、注意事项和替代建议。

一、HttpClient 概述

定义：HttpClient 是 Apache HttpComponents 库的一部分，提供灵活的 HTTP 请求处理功能。
特点：
支持 GET、POST、PUT、DELETE 等 HTTP 方法。
提供丰富的请求头、请求体和响应处理功能。
支持 Cookie 管理、连接池、超时配置。
易于处理复杂请求（如 multipart 表单）。
废弃原因：
Android 5.1（API 22）后，Google 移除 HttpClient 以减少系统库大小。
HttpClient 的性能和维护性不如 HttpURLConnection 或 OkHttp。
适用场景：
维护旧项目（API 21 或更低版本）。
学习 HTTP 协议和网络请求原理。
替代方案：
HttpURLConnection：原生、轻量，适合简单请求。
OkHttp：功能强大，支持连接池、拦截器。
Retrofit：基于 OkHttp，适合 RESTful API 调用。

二、添加 HttpClient 依赖

由于 HttpClient 在 Android API 22+ 中被移除，若需在高版本中使用，必须手动添加 Apache HttpClient 库。

添加依赖（Gradle）：
在 build.gradle（app 模块）中添加：

   implementation 'org.apache.httpcomponents:httpclient-android:4.3.5.1'

或使用旧版：

   implementation 'org.apache.httpcomponents:httpclient:4.5.13'

权限声明：
在 AndroidManifest.xml 中添加网络权限：

   <uses-permission android:name="android.permission.INTERNET" />
   <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

三、HttpClient 的核心使用步骤

以下是使用 HttpClient 执行 HTTP 请求的基本步骤：

创建 HttpClient 实例：
使用 DefaultHttpClient 或 HttpClientBuilder 创建客户端。

   HttpClient client = new DefaultHttpClient();

设置请求：
创建 HttpGet、HttpPost 等请求对象，配置 URL 和请求头。

   HttpGet request = new HttpGet("https://api.example.com/data");
   request.addHeader("Content-Type", "application/json");

执行请求：
使用 HttpClient 执行请求，获取响应。

   HttpResponse response = client.execute(request);

处理响应：
检查状态码，读取响应数据。

   int statusCode = response.getStatusLine().getStatusCode();
   if (statusCode == HttpStatus.SC_OK) {
       HttpEntity entity = response.getEntity();
       InputStream content = entity.getContent();
       // 读取数据
   }

释放资源：
确保关闭响应和客户端。

   EntityUtils.consume(response.getEntity());
   client.getConnectionManager().shutdown();

四、常见 HTTP 请求方式示例

以下是使用 HttpClient 实现 GET 和 POST 请求的详细代码示例。

1. GET 请求

GET 请求用于从服务器获取资源。

import org.apache.http.HttpResponse;
import org.apache.http.HttpStatus;
import org.apache.http.client.HttpClient;
import org.apache.http.client.methods.HttpGet;
import org.apache.http.impl.client.DefaultHttpClient;
import org.apache.http.util.EntityUtils;

public String doGetRequest(String urlString) {
    HttpClient client = new DefaultHttpClient();
    HttpGet request = new HttpGet(urlString);
    try {
        // 设置请求头
        request.addHeader("Accept", "application/json");
        request.addHeader("Authorization", "Bearer your_token_here");

        // 执行请求
        HttpResponse response = client.execute(request);
        int statusCode = response.getStatusLine().getStatusCode();

        if (statusCode == HttpStatus.SC_OK) {
            // 读取响应
            String responseBody = EntityUtils.toString(response.getEntity(), "UTF-8");
            return responseBody;
        } else {
            return "Error: " + statusCode;
        }
    } catch (IOException e) {
        e.printStackTrace();
        return "Exception: " + e.getMessage();
    } finally {
        // 释放资源
        client.getConnectionManager().shutdown();
    }
}

使用示例（在子线程中调用）：

  new Thread(() -> {
      String result = doGetRequest("https://api.example.com/data");
      // 在主线程更新 UI
      runOnUiThread(() -> {
          Log.d("Response", result);
      });
  }).start();

2. POST 请求

POST 请求用于向服务器提交数据，包含请求体。

import org.apache.http.HttpResponse;
import org.apache.http.HttpStatus;
import org.apache.http.client.HttpClient;
import org.apache.http.client.methods.HttpPost;
import org.apache.http.entity.StringEntity;
import org.apache.http.impl.client.DefaultHttpClient;
import org.apache.http.util.EntityUtils;

public String doPostRequest(String urlString, String jsonBody) {
    HttpClient client = new DefaultHttpClient();
    HttpPost request = new HttpPost(urlString);
    try {
        // 设置请求头
        request.addHeader("Content-Type", "application/json");
        request.addHeader("Accept", "application/json");

        // 设置请求体
        StringEntity entity = new StringEntity(jsonBody, "UTF-8");
        request.setEntity(entity);

        // 执行请求
        HttpResponse response = client.execute(request);
        int statusCode = response.getStatusLine().getStatusCode();

        if (statusCode == HttpStatus.SC_OK || statusCode == HttpStatus.SC_CREATED) {
            // 读取响应
            String responseBody = EntityUtils.toString(response.getEntity(), "UTF-8");
            return responseBody;
        } else {
            String errorBody = EntityUtils.toString(response.getEntity(), "UTF-8");
            return "Error: " + statusCode + " - " + errorBody;
        }
    } catch (IOException e) {
        e.printStackTrace();
        return "Exception: " + e.getMessage();
    } finally {
        // 释放资源
        client.getConnectionManager().shutdown();
    }
}

使用示例（在子线程中调用）：

  new Thread(() -> {
      String jsonBody = "{\"username\":\"user\",\"password\":\"pass\"}";
      String result = doPostRequest("https://api.example.com/login", jsonBody);
      // 在主线程更新 UI
      runOnUiThread(() -> {
          Log.d("Response", result);
      });
  }).start();

3. 其他请求方法（PUT、DELETE）

PUT 和 DELETE 的实现与 POST 类似，只需替换请求对象：

HttpPut request = new HttpPut(urlString); // 或 HttpDelete
request.addHeader("Content-Type", "application/json");
request.setEntity(new StringEntity(jsonBody, "UTF-8"));

五、处理请求头与响应头

1. 设置请求头

HttpGet request = new HttpGet("https://api.example.com/data");
request.addHeader("Content-Type", "application/json");
request.addHeader("Authorization", "Bearer your_token_here");
request.addHeader("Accept-Encoding", "gzip");

2. 读取响应头

HttpResponse response = client.execute(request);
Header[] headers = response.getAllHeaders();
for (Header header : headers) {
    Log.d("Header", header.getName() + ": " + header.getValue());
}
// 获取特定头
Header contentType = response.getFirstHeader("Content-Type");
String contentTypeValue = contentType != null ? contentType.getValue() : null;

3. 处理 Cookie

HttpClient 内置 Cookie 管理：

DefaultHttpClient client = new DefaultHttpClient();
client.getCookieStore().addCookie(new BasicClientCookie("name", "value"));
HttpResponse response = client.execute(request);
// 获取服务器返回的 Cookie
List<Cookie> cookies = client.getCookieStore().getCookies();
for (Cookie cookie : cookies) {
    Log.d("Cookie", cookie.getName() + ": " + cookie.getValue());
}

六、异步处理

Android 不允许在主线程执行网络操作，需使用异步机制：

1. 使用 Thread

如上述示例，在子线程中执行请求。

2. 使用 AsyncTask（已废弃）

public class NetworkTask extends AsyncTask<String, Void, String> {
    @Override
    protected String doInBackground(String... params) {
        return doGetRequest(params[0]);
    }

    @Override
    protected void onPostExecute(String result) {
        Log.d("Response", result);
    }
}

3. 使用 Kotlin 协程（需替代库）

由于 HttpClient 已废弃，协程通常与 OkHttp/Retrofit 搭配。若坚持使用 HttpClient，可结合线程池：

Executors.newSingleThreadExecutor().execute(() -> {
    String result = doGetRequest("https://api.example.com/data");
    runOnUiThread(() -> Log.d("Response", result));
});

七、注意事项

废弃警告：

HttpClient 在 Android API 22+ 中不可用，需手动添加依赖。
生产环境建议使用 OkHttp 或 Retrofit。

子线程执行：

网络操作必须在子线程运行，否则抛出 NetworkOnMainThreadException。

资源释放：

调用 EntityUtils.consume(response.getEntity()) 释放响应资源。
调用 client.getConnectionManager().shutdown() 关闭客户端。

错误处理：

检查状态码（如 HttpStatus.SC_OK）。
处理 IOException 和服务器错误：
java if (statusCode >= 400) { String error = EntityUtils.toString(response.getEntity(), "UTF-8"); Log.e("Error", "Code: " + statusCode + ", Message: " + error); }

HTTPS 安全：

HttpClient 支持 HTTPS，但处理自签名证书需自定义 SSLSocketFactory：
java SSLSocketFactory sf = new SSLSocketFactory(new TrustSelfSignedStrategy()); client.getConnectionManager().getSchemeRegistry().register(new Scheme("https", sf, 443));
（生产环境谨慎使用信任所有证书的方案）。

性能优化：

配置超时：
java HttpParams params = client.getParams(); HttpConnectionParams.setConnectionTimeout(params, 5000); HttpConnectionParams.setSoTimeout(params, 5000);
使用 Gzip 压缩：
java request.addHeader("Accept-Encoding", "gzip"); HttpEntity entity = response.getEntity(); if ("gzip".equals(entity.getContentEncoding().getValue())) { content = new GZIPInputStream(entity.getContent()); }

八、学习建议与实践

学习路径：

理解 HTTP 协议基础（请求/响应、方法、头、状态码）。
掌握 HttpClient 的 GET 和 POST 请求实现。
学习请求头和响应头处理（认证、Cookie）。
对比 HttpClient 和 HttpURLConnection，了解其局限性。
迁移到 OkHttp/Retrofit，学习现代网络库。

实践项目：

调用公开 API（如 GitHub API），实现 GET 请求获取数据。
实现登录功能，使用 POST 请求发送 JSON 数据。
处理 Cookie，保存并在后续请求中使用。

调试工具：

使用 Postman 测试 API，验证请求/响应。
使用 Charles 或 Android Studio 的 Network Profiler 分析请求。

推荐资源：

Apache HttpClient 文档：https://hc.apache.org/httpcomponents-client-4.5.x/
MDN HTTP 文档：https://developer.mozilla.org/en-US/docs/Web/HTTP
实践 API：https://api.github.com/ 或 https://openweathermap.org/api

九、与 HttpURLConnection 的对比

特性	HttpClient	HttpURLConnection
依赖	Apache 库，API 22+ 需手动添加	Android 原生，无需额外依赖
易用性	API 丰富，代码较复杂	API 简单，但代码稍冗长
连接池	支持连接复用	有限支持，性能稍逊
Cookie 管理	内置 CookieStore，易于管理	需手动处理或使用 CookieManager
HTTPS 支持	需自定义 SSLSocketFactory	内置支持，较易处理
维护状态	已废弃，社区维护	官方支持，推荐使用
推荐场景	维护旧代码	简单请求、新项目（或用 OkHttp）

十、总结

HttpClient 是 Apache 提供的 HTTP 客户端，适合早期 Android 项目，但已被废弃。
核心步骤：创建客户端、配置请求、执行请求、处理响应、释放资源。
请求方式：
GET：获取数据，设置请求头（如 Accept）。
POST：提交数据，写入请求体（如 JSON）。
注意事项：异步处理、资源释放、错误处理、HTTPS 安全。
建议：新项目使用 OkHttp 或 Retrofit，HttpClient 仅用于学习或维护旧代码。

如果需要更详细的代码示例（如 multipart 上传、处理特定头）或针对某个场景的深入讲解，请告诉我！

一、HttpClient 概述

二、添加 HttpClient 依赖

三、HttpClient 的核心使用步骤

四、常见 HTTP 请求方式示例

1. GET 请求

2. POST 请求

3. 其他请求方法（PUT、DELETE）

五、处理请求头与响应头

1. 设置请求头

2. 读取响应头

3. 处理 Cookie

六、异步处理

1. 使用 Thread

2. 使用 AsyncTask（已废弃）

3. 使用 Kotlin 协程（需替代库）

七、注意事项

八、学习建议与实践

九、与 HttpURLConnection 的对比

十、总结

ContentProvider初探

GridView(网格视图)的基本使用

Bitmap(位图)全解析 Part 1

TableLayout(表格布局)

Android Http请求头与响应头的学习

GridLayout(网格布局)

发表回复取消回复

一、HttpClient 概述

二、添加 HttpClient 依赖

三、HttpClient 的核心使用步骤

四、常见 HTTP 请求方式示例

1. GET 请求

2. POST 请求

3. 其他请求方法（PUT、DELETE）

五、处理请求头与响应头

1. 设置请求头

2. 读取响应头

3. 处理 Cookie

六、异步处理

1. 使用 Thread

2. 使用 AsyncTask（已废弃）

3. 使用 Kotlin 协程（需替代库）

七、注意事项

八、学习建议与实践

九、与 HttpURLConnection 的对比

十、总结

类似文章

发表回复 取消回复

发表回复取消回复