HttpClient使用详解

最新推荐文章于 2025-10-07 21:25:01 发布
原创 最新推荐文章于 2025-10-07 21:25:01 发布 · 707 阅读 · 0 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。

本文详细介绍了Apache HttpClient的功能特性，包括其在Android平台上的集成与使用方法。HttpClient是一个强大的HTTP客户端工具，支持多种HTTP方法，并能处理HTTPS协议及认证方案。
部署运行你感兴趣的模型镜像

一、简介

HttpClient是Apache开源组织提供的HTTP网络访问接口，它是一个简单的HTTP客户端（并不是浏览器），可以发送HTTP请求，接收HTTP响应，但是不会缓存服务器的响应，不能执行HTTP页面中嵌入的JS代码，自然也不会对页面内容进行任何解析、处理，这些都是需要开发人员来完成的。

现在Android已经成功集成了HttpClient，所以开发人员在Android项目中可以直接使用HttpClient来向Web站点提交请求以及接受响应，如果使用其他的Java项目则需要引入相应的Jar包。HttpClient可以在官网上下载，官网链接：http://hc.apache.org/downloads.cgi

HttpClient其实是一个interface类型，它封装了对象需要执行的HTTP请求、身份验证、连接管理和其它特性。由于HttpClient是一个接口，因此无法创建它的实例，但是HttpClient有三个已知的实现类分别是：AbstractHttpClient、AndroidHttpClient、DefaultHttpClient，会发现有一个专门为Android应用准备的实现类AndroidHttpClient，当然使用常规的DefaultHttpClient也可以实现功能。

从两个类包所在位置就可以看出区别：AndroidHttpClient定义在android.net.http.AndroidHttpClient包下，属于Android原生的HTTP访问；而DefaultHttpClient定义在org.apache.http.impl.client.DefaultHttpClient包下，属于对Apache项目的支持。而AndroidHttpClient没有公开的构造函数，只能通过静态方法newInstance()方法来获得AndroidHttpClient对象。

二、特性

  1. 基于标准、纯净的Java语言，实现了Http1.0和Http1.1；
  2. 以可扩展的面向对象结构实现了HTTP全部的方法（GET、POST、PUT、DELETE、HEAD、OPTIONS、TRACE）；
  3. 支持HTTPS协议；
  4. 通过HTTP代理建立透明的连接；
  5. 利用CONNECT方法通过HTTP代理建立隧道的HTTPS连接；
  6. Basic、Digest、NTLMv1、NTLMv2、NTLM2 Session、SNPNEGO/Kerberos认证方案；
  7. 插件式的自定义认证方案；
  8. 便携可靠的套接字工厂使它更容易的使用第三方解决方案；
  9. 连接管理器支持多线程应用，支持设置最大连接数，同时支持设置每个主机的最大连接数，发现并关闭过期的连接；
  10. 自动处理Set-Cookie中的Cookie；
  11. 插件式的自定义Cookie策略；
  12. Request的输出流可以避免流中内容直接缓冲到Socket服务器；
  13. Response的输入流可以有效的从Socket服务器直接读取相应内容；
  14. 在Http1.0和Http1.1中利用KeepAlive保持持久连接；
  15. 直接获取服务器发送的response code和headers；
  16. 设置连接超时的能力；
  17. 实验性的支持http1.1 response caching；
  18. 源代码基于Apache License可免费获取；

三、集成

在Eclipse或Android Studio开发过程中，设置Android SDK的编译版本为23且使用了HttpClient相关类的方法时会出现有一些类找不到的错误。

  1. 原因
    Android 6.0(API 23)SDK不再提供org.apache.http.*(只保留几个类)。

  2. 解决方法
    2.1 Eclipse：在项目libs中加入：org.apache.http.legacy.jar
    上面的jar包在：**\android-sdk-windows\platforms\android-23\optional下（需要下载Android 6.0的SDK）。

    2.2 Android Studio：在项目相应module的build.gradle中加入：

    android {
    useLibrary 'org.apache.http.legacy'
}

四、权限

在AndroidManifest.xml文件添加网络权限

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

五、混淆

#不混淆android-async-http(这里混淆由你使用的HttpClient框架决定)  
-keep class com.loopj.android.http.**{*;}  

#不混淆org.apache.http.legacy.jar   
-dontwarn android.net.compatibility.**  
-dontwarn android.net.http.**  
-dontwarn com.android.internal.http.multipart.**  
-dontwarn org.apache.commons.**  
-dontwarn org.apache.http.**  
-keep class android.net.compatibility.**{*;}  
-keep class android.net.http.**{*;}  
-keep class com.android.internal.http.multipart.**{*;}  
-keep class org.apache.commons.**{*;}  
-keep class org.apache.http.**{*;}

六、使用

简单来说，使用HttpClient发送请求、接收响应都很简单，只需要五大步骤即可：

  1. 创建客户端的HttpClient对象；
  2. 创建请求的对象。如果需要发送GET请求，则创建HttpGet对象；如果需要发送POST请求，则创建HttpPost对象。注：对于发送请求的参数而言GET和POST的使用方式略有不同，GET方式可以使用拼接字符串的方式将参数拼接在URL末尾；POST方式则需要使用setEntityHttpEntity entity)方法来设置请求参数；
  3. 调用HttpClient对象的execute(HttpUriRequest request)发送请求，执行该方法后将获得服务器返回的HttpResponse对象。服务器返回给我们的数据就在这个HttpResponse相应当中，调用HttpResponse的对应方法可以获取服务器的响应头、响应内容等；
  4. 检查响应状态是否正常。服务器返回给客户端的响应有一个响应码：相应码为200时表示正常返回；相应码为404时表示客户端错误；相应码为505时表示服务器端错误；
  5. 获得响应对象当中的数据。

七、调用

主线程中访问网络时异常：NetworkOnMainThreadException

  1. 原因
    Android在4.0之前的版本支持在主线程中访问网络，但是在4.0以后对这部分程序进行了优化，也就是说访问网络的代码不能写在主线程中了。
  2. 解决方法
    采用多线程、异步加载的方式加载数据。

八、示例

    public static final int CONNECTION_TIME_OUT = 1000 * 20;//连接超时
    public static final int SO_TIMEOUT = 1000 * 20;//Socket 超时
    public static final String ENCODING = "UTF-8";//编码格式

    /**
     * HttpClient Post 请求
     *
     * @param apiUrl    接口地址
     * @param paramsMap 接口参数
     * @return
     */
    public static ResultDesc postRequest(String apiUrl, Map<String, String> paramsMap) {
        // 创建表单
        List<NameValuePair> params = new ArrayList<NameValuePair>();
        if (paramsMap != null && paramsMap.size() != 0) {
            for (String key : paramsMap.keySet()) {
                params.add(new BasicNameValuePair(key, paramsMap.get(key)));
            }
        }

        //创建HttpClient对象
        HttpClient httpClient = getHttpClient();
        //创建请求对象,参数是访问的服务器地址
        HttpPost httpPost = new HttpPost(apiUrl);

        HttpResponse httpResponse;
        ResultDesc resultDesc = null;
        try {
            UrlEncodedFormEntity encode = new UrlEncodedFormEntity(params, ENCODING);
            httpPost.setEntity(encode);

            //执行请求，获取服务器返回的相应对象
            httpResponse = httpClient.execute(httpPost);
            //检查相应的状态是否正常，状态码返回值为200表示正常
            if (httpResponse.getStatusLine().getStatusCode() == HttpStatus.SC_OK) {
                //从相应对象当中取出数据放到entity当中
                HttpEntity entity = httpResponse.getEntity();
                //将entity当中的数据转换为字符串
                String response = EntityUtils.toString(entity, ENCODING);

                LogUtil.e(Constant.LOG_TAG, "接口地址:" + apiUrl + "\n请求返回:" + response);

                resultDesc = getReturnData(response);
            } else {
                resultDesc = dataRestructuring(-1, UIUtils.getString(R.string.back_abnormal_results), "");
            }
        } catch (Exception e) {
            resultDesc = dataRestructuring(-1, ExceptionCode(e), "");
        }

        return resultDesc;
    }

    /**
     * HttpClient Get 请求
     *
     * @param apiUrl    接口地址
     * @param paramsMap 接口参数
     * @return
     */
    public static ResultDesc getRequest(String apiUrl, Map<String, String> paramsMap) {
        //创建表单
        List<NameValuePair> params = new ArrayList<NameValuePair>();
        if (paramsMap != null && paramsMap.size() != 0) {
            for (String key : paramsMap.keySet()) {
                params.add(new BasicNameValuePair(key, paramsMap.get(key)));
            }
            //对参数编码
            String param = URLEncodedUtils.format(params, ENCODING);
            apiUrl += "?" + param;
        }

        //创建HttpClient对象
        HttpClient httpClient = getHttpClient();
        //创建请求对象,参数是访问的服务器地址
        HttpGet httpGet = new HttpGet(apiUrl);

        HttpResponse httpResponse;
        ResultDesc resultDesc = null;
        try {
            //执行请求，获取服务器返回的相应对象
            httpResponse = httpClient.execute(httpGet);
            //检查相应的状态是否正常，状态码返回值为200表示正常
            if (httpResponse.getStatusLine().getStatusCode() == HttpStatus.SC_OK) {
                //从相应对象当中取出数据放到entity当中
                HttpEntity entity = httpResponse.getEntity();
                //将entity当中的数据转换为字符串
                String response = EntityUtils.toString(entity, ENCODING);

                LogUtil.e(Constant.LOG_TAG, "接口地址:" + apiUrl + "\n请求返回:" + response);

                resultDesc = getReturnData(response);
            } else {
                resultDesc = dataRestructuring(-1, UIUtils.getString(R.string.back_abnormal_results), "");
            }
        } catch (Exception e) {
            resultDesc = dataRestructuring(-1, ExceptionCode(e), "");
        }

        return resultDesc;
    }

    /**
     * HttpClient 配置
     *
     * @return
     */
    public static HttpClient getHttpClient() {
        //创建HttpParams以用来设置HTTP参数（这一部分不是必需的）
        BasicHttpParams httpParams = new BasicHttpParams();
        //设置连接超时
        HttpConnectionParams.setConnectionTimeout(httpParams, CONNECTION_TIME_OUT);
        //设置Socket超时
        HttpConnectionParams.setSoTimeout(httpParams, SO_TIMEOUT);
        //设置Socket缓存大小
        HttpConnectionParams.setSocketBufferSize(httpParams, 8192);
        //设置userAgent
        String userAgent = "Mozilla/5.0 (Windows; U; Windows NT 5.1; zh-CN; rv:1.9.2) Gecko/20100115 Firefox/3.6";
        HttpProtocolParams.setUserAgent(httpParams, userAgent);

        //设置重定向，缺省为true
        //HttpClientParams.setRedirecting(httpParams, true);
        //设置HttpClient支持HTTP和HTTPS两种模式
        //SchemeRegistry schReg = new SchemeRegistry();
        //schReg.register(new Scheme("http", PlainSocketFactory.getSocketFactory(), 80));
        //schReg.register(new Scheme("https", SSLSocketFactory.getSocketFactory(), 443));
        //使用线程安全的连接管理来创建HttpClient
        //ClientConnectionManager conMgr = new ThreadSafeClientConnManager(httpParams, schReg);
        //创建HttpClient对象
        //HttpClient httpClient = new DefaultHttpClient(conMgr, httpParams);

        //创建HttpClient对象
        HttpClient httpClient = new DefaultHttpClient(httpParams);
        return httpClient;
    }

项目地址 ☞ 传送门

您可能感兴趣的与本文相关的镜像

Stable-Diffusion-3.5

Stable-Diffusion-3.5

图片生成
Stable-Diffusion

Stable Diffusion 3.5 (SD 3.5) 是由 Stability AI 推出的新一代文本到图像生成模型，相比 3.0 版本，它提升了图像质量、运行速度和硬件效率

谈谈HttpClient使用详解
09-03
给大家介绍HttpClient使用，httpClient是一个客户端的http通信实现库，HttpClient的目标是发送和接收HTTP报文。本文讲解的非常详细，对HttpClient使用感兴趣的朋友可以参考下
httpclient使用详解共8页.pdf.zip
10-29
《HttpClient使用详解》 HttpClient是Apache软件基金会的 HttpClient项目提供的一款强大的HTTP客户端工具，它允许开发者在Java应用程序中实现复杂的HTTP通信。这份8页的PDF文档深入解析了HttpClient的使用方法，...
httpClient 使用详解
weixin_30621919的博客
07-02 217
一、 HttpClient:是一个接口 首先需要先创建一个DefaultHttpClient的实例 HttpClient httpClient=new DefaultHttpClient(); 或者 CloseableHttpClienthttpclient = HttpClients.createDefault(); 1、发送GET请求 HttpGet httpget = ...
HttpClient设置HTTP请求头Header
最新发布
Made In SQL
10-07 1077
HttpClient是Apache Jakarta Common下的子项目，用来提供高效的、最新的、功能丰富的支持HTTP协议的客户端编程工具包。它支持HTTP协议最新的版本和建议，实现了HTTP协议的所有方法（GET、POST、PUT、DELETE等），并且支持HTTPS协议。HttpClient是发送HTTP请求的核心接口，负责执行请求并返回响应。它提供了线程安全的实现，可以共享使用。表示HTTP请求，包含请求方法、URI、协议版本、请求头和请求体等信息。表示HTTP响应，包含状态码、响应头和响应体等信
httpclient使用详解
08-11
- *1* *2* *3* [HttpClient使用和详解](https://blog.youkuaiyun.com/swadian2008/article/details/105112570)[target="_blank" data-report-click={"spm":"1018.2226.3001.9630","extra":{"utm_source":"vip_chatgpt_...
HttpClient使用详解与最佳实践
"HttpClient使用指南最新版" HttpClient是一个广泛应用于Java开发中的组件，用于处理HTTP请求和响应。本指南旨在提供HttpClient的基本使用方法和高级特性，帮助开发者更有效地使用该工具。 1. 请求执行基础 - ...
Httpclient使用jar包三合一，基本使用方法
12-14
Http协议使用封装jar包（commons-codec-1.3.jar、commons-httpclient-3.1.jar、commons-logging-1.1.jar） 简单使用方法： public static void main(String[] args) { // String str1 = "http://dev.d-smart.cn/Login"; // http协议路径 String str1 = ""; HttpClient httpClient = new HttpClient(); PostMethod method = new PostMethod(str1); try { // 需要添加的header数据 List<Header> headers = new ArrayList<Header>(); headers.add(new Header("", "")); headers.add(new Header("", ""));
HttpClient使用和详解
swadian2008的博客
04-02 9400
目录 一、关于HttpClient 二、HttpClient使用步骤详解 1、创建一个HttpClient对象 A、HttpCLientConnectionManager B、HttpRoutePlanner C、RequestConfig 2、创建一个Request对象 3、执行Request请求 4、处理response 1）关闭和entity相关的content stre...
HttpClient使用详解总结大全①
以梦为马，不负韶华。
11-03 5141
Http协议的重要性相信不用我多说了，HttpClient相比传统JDK自带的URLConnection，增加了易用性和灵活性（具体区别，日后我们再讨论），它不仅是客户端发送Http请求变得容易，而且也方便了开发人员测试接口（基于Http协议的），即提高了开发的效率，也方便提高代码的健壮性。因此熟练掌握HttpClient是很重要的必修内容，掌握HttpClient后，相信对于Http协议的了解会
HttpClient使用详解总结大全
m0_37846887的博客
06-06 249
参考地址：https://blog.youkuaiyun.com/kunge_/article/details/78432455点击打开链接
HttpClient的介绍与使用
zyxzyx666的博客
01-14 5197
HttpClient的介绍与使用
Httpclient的使用
热门推荐
weixin_40144050的博客
01-03 2万+
1.1 Httpclient的使用 1.1.1 什么是httpclient HttpClient 是 Apache Jakarta Common 下的子项目，用来提供高效的、最新的、功能丰富的支持 HTTP 协议的客户端编程工具包，并且它支持 HTTP 协议最新的版本和建议。 下载地址： http://hc.apache.org/     1.1.2 添加依赖   需要把h
httpclient Post请求
不曾走过，怎会懂得
12-18 295
1、使用httpclient请求服务  2、需要的java包 private static Logger log = Logger.getLogger(ServiceLink.class); private static HttpClient client = new HttpClient(); private static boolean flog=true; ...
httpClient调用第三方外部接口
风一样的男子
07-30 3211
1.添加httpClient架包 2. package com.zcl.quatrz; import java.io.IOException; import org.apache.http.HttpEntity; import org.apache.http.HttpStatus; import org.apache.http.client.config.RequestConfig;...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值