关键词：
上篇文章介绍了插件式配置HttpClient，本文将介绍插件式配置Header。
为什么要配置header在前面已经提到了，还里再简单说一下，要使用HttpClient模拟请求，去访问各种接口或者网站资源，都有可能有各种限制，比如说java客户端模拟访问csdn博客，就必须设置User-Agent，否则就报错了。还有各种其他情况，必须的设置一些特定的Header，才能请求成功，或者才能不出问题。
好了就说这么多，本次还是采用构造者模式的级联调用方式，来完成该工具类。在该工具类中，为所有常用的Http Request Header都提供了设置方法。具体参数参考的链接是HTTP Header 详解。
不再多废话了，看具体代码吧：
package com.tgb.ccl.http.common;
import java.util.HashMap;
import java.util.Map;
import org.apache.http.Consts;
import org.apache.http.Header;
import org.apache.http.message.BasicHeader;
/**
* 创建HttpReqHead
*
* @author arron
* @date 2015年11月9日 上午10:37:23
* @version 1.0
*/
public class HttpHeader
private HttpHeader() ;
public static HttpHeader custom()
return new HttpHeader();
//记录head头信息
private Map<String, Header> headerMaps = new HashMap<String, Header>();
/**
* 指定客户端能够接收的内容类型
* 例如：Accept: text/plain, text/html
*
* @param accept
*/
public HttpHeader accept(String accept)
headerMaps.put(HttpReqHead.ACCEPT,
new BasicHeader(HttpReqHead.ACCEPT, accept));
return this;
/**
* 浏览器可以接受的字符编码集
* 例如：Accept-Charset: iso-8859-5
*
* @param acceptCharset
*/
public HttpHeader acceptCharset(String acceptCharset)
headerMaps.put(HttpReqHead.ACCEPT_CHARSET,
new BasicHeader(HttpReqHead.ACCEPT_CHARSET, acceptCharset));
return this;
/**
* 指定浏览器可以支持的web服务器返回内容压缩编码类型
* 例如：Accept-Encoding: compress, gzip
*
* @param acceptEncoding
*/
public HttpHeader acceptEncoding(String acceptEncoding)
headerMaps.put(HttpReqHead.ACCEPT_ENCODING,
new BasicHeader(HttpReqHead.ACCEPT_ENCODING, acceptEncoding));
return this;
/**
* 浏览器可接受的语言
* 例如：Accept-Language: en,zh
*
* @param acceptLanguage
*/
public HttpHeader acceptLanguage(String acceptLanguage)
headerMaps.put(HttpReqHead.ACCEPT_LANGUAGE,
new BasicHeader(HttpReqHead.ACCEPT_LANGUAGE, acceptLanguage));
return this;
/**
* 可以请求网页实体的一个或者多个子范围字段
* 例如：Accept-Ranges: bytes
*
* @param acceptRanges
*/
public HttpHeader acceptRanges(String acceptRanges)
headerMaps.put(HttpReqHead.ACCEPT_RANGES,
new BasicHeader(HttpReqHead.ACCEPT_RANGES, acceptRanges));
return this;
/**
* HTTP授权的授权证书
* 例如：Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==
*
* @param authorization
*/
public HttpHeader authorization(String authorization)
headerMaps.put(HttpReqHead.AUTHORIZATION,
new BasicHeader(HttpReqHead.AUTHORIZATION, authorization));
return this;
/**
* 指定请求和响应遵循的缓存机制
* 例如：Cache-Control: no-cache
*
* @param cacheControl
*/
public HttpHeader cacheControl(String cacheControl)
headerMaps.put(HttpReqHead.CACHE_CONTROL,
new BasicHeader(HttpReqHead.CACHE_CONTROL, cacheControl));
return this;
/**
* 表示是否需要持久连接（HTTP 1.1默认进行持久连接）
* 例如：Connection: close 短链接； Connection: keep-alive 长连接
*
* @param connection
* @return
*/
public HttpHeader connection(String connection)
headerMaps.put(HttpReqHead.CONNECTION,
new BasicHeader(HttpReqHead.CONNECTION, connection));
return this;
/**
* HTTP请求发送时，会把保存在该请求域名下的所有cookie值一起发送给web服务器
* 例如：Cookie: $Version=1; Skin=new;
*
* @param cookie
*/
public HttpHeader cookie(String cookie)
headerMaps.put(HttpReqHead.COOKIE,
new BasicHeader(HttpReqHead.COOKIE, cookie));
return this;
/**
* 请求内容长度
* 例如：Content-Length: 348
*
* @param contentLength
*/
public HttpHeader contentLength(String contentLength)
headerMaps.put(HttpReqHead.CONTENT_LENGTH,
new BasicHeader(HttpReqHead.CONTENT_LENGTH, contentLength));
return this;
/**
* 请求的与实体对应的MIME信息
* 例如：Content-Type: application/x-www-form-urlencoded
*
* @param contentType
*/
public HttpHeader contentType(String contentType)
headerMaps.put(HttpReqHead.CONTENT_TYPE,
new BasicHeader(HttpReqHead.CONTENT_TYPE, contentType));
return this;
/**
* 请求发送的日期和时间
* 例如：Date: Tue, 15 Nov 2010 08:12:31 GMT
*
* @param date
* @return
*/
public HttpHeader date(String date)
headerMaps.put(HttpReqHead.DATE,
new BasicHeader(HttpReqHead.DATE, date));
return this;
/**
* 请求的特定的服务器行为
* 例如：Expect: 100-continue
*
* @param expect
*/
public HttpHeader expect(String expect)
headerMaps.put(HttpReqHead.EXPECT,
new BasicHeader(HttpReqHead.EXPECT, expect));
return this;
/**
* 发出请求的用户的Email
* 例如：From: user@email.com
*
* @param from
*/
public HttpHeader from(String from)
headerMaps.put(HttpReqHead.FROM,
new BasicHeader(HttpReqHead.FROM, from));
return this;
/**
* 指定请求的服务器的域名和端口号
* 例如：Host: blog.csdn.net
*
* @param host
* @return
*/
public HttpHeader host(String host)
headerMaps.put(HttpReqHead.HOST,
new BasicHeader(HttpReqHead.HOST, host));
return this;
/**
* 只有请求内容与实体相匹配才有效
* 例如：If-Match: “737060cd8c284d8af7ad3082f209582d”
*
* @param ifMatch
* @return
*/
public HttpHeader ifMatch(String ifMatch)
headerMaps.put(HttpReqHead.IF_MATCH,
new BasicHeader(HttpReqHead.IF_MATCH, ifMatch));
return this;
/**
* 如果请求的部分在指定时间之后被修改则请求成功，未被修改则返回304代码
* 例如：If-Modified-Since: Sat, 29 Oct 2010 19:43:31 GMT
*
* @param ifModifiedSince
* @return
*/
public HttpHeader ifModifiedSince(String ifModifiedSince)
headerMaps.put(HttpReqHead.IF_MODIFIED_SINCE,
new BasicHeader(HttpReqHead.IF_MODIFIED_SINCE, ifModifiedSince));
return this;
/**
* 如果内容未改变返回304代码，参数为服务器先前发送的Etag，与服务器回应的Etag比较判断是否改变
* 例如：If-None-Match: “737060cd8c284d8af7ad3082f209582d”
*
* @param ifNoneMatch
* @return
*/
public HttpHeader ifNoneMatch(String ifNoneMatch)
headerMaps.put(HttpReqHead.IF_NONE_MATCH,
new BasicHeader(HttpReqHead.IF_NONE_MATCH, ifNoneMatch));
return this;
/**
* 如果实体未改变，服务器发送客户端丢失的部分，否则发送整个实体。参数也为Etag
* 例如：If-Range: “737060cd8c284d8af7ad3082f209582d”
*
* @param ifRange
* @return
*/
public HttpHeader ifRange(String ifRange)
headerMaps.put(HttpReqHead.IF_RANGE,
new BasicHeader(HttpReqHead.IF_RANGE, ifRange));
return this;
/**
* 只在实体在指定时间之后未被修改才请求成功
* 例如：If-Unmodified-Since: Sat, 29 Oct 2010 19:43:31 GMT
*
* @param ifUnmodifiedSince
* @return
*/
public HttpHeader ifUnmodifiedSince(String ifUnmodifiedSince)
headerMaps.put(HttpReqHead.IF_UNMODIFIED_SINCE,
new BasicHeader(HttpReqHead.IF_UNMODIFIED_SINCE, ifUnmodifiedSince));
return this;
/**
* 限制信息通过代理和网关传送的时间
* 例如：Max-Forwards: 10
*
* @param maxForwards
* @return
*/
public HttpHeader maxForwards(String maxForwards)
headerMaps.put(HttpReqHead.MAX_FORWARDS,
new BasicHeader(HttpReqHead.MAX_FORWARDS, maxForwards));
return this;
/**
* 用来包含实现特定的指令
* 例如：Pragma: no-cache
*
* @param pragma
* @return
*/
public HttpHeader pragma(String pragma)
headerMaps.put(HttpReqHead.PRAGMA,
new BasicHeader(HttpReqHead.PRAGMA, pragma));
return this;
/**
* 连接到代理的授权证书
* 例如：Proxy-Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==
*
* @param proxyAuthorization
*/
public HttpHeader proxyAuthorization(String proxyAuthorization)
headerMaps.put(HttpReqHead.PROXY_AUTHORIZATION,
new BasicHeader(HttpReqHead.PROXY_AUTHORIZATION, proxyAuthorization));
return this;
/**
* 只请求实体的一部分，指定范围
* 例如：Range: bytes=500-999
*
* @param range
*/
public HttpHeader range(String range)
headerMaps.put(HttpReqHead.RANGE,
new BasicHeader(HttpReqHead.RANGE, range));
return this;
/**
* 先前网页的地址，当前请求网页紧随其后,即来路
* 例如：Referer: http://www.zcmhi.com/archives/71.html
*
* @param referer
*/
public HttpHeader referer(String referer)
headerMaps.put(HttpReqHead.REFERER,
new BasicHeader(HttpReqHead.REFERER, referer));
return this;
/**
* 客户端愿意接受的传输编码，并通知服务器接受接受尾加头信息
* 例如：TE: trailers,deflate;q=0.5
*
* @param te
*/
public HttpHeader te(String te)
headerMaps.put(HttpReqHead.TE,
new BasicHeader(HttpReqHead.TE, te));
return this;
/**
* 向服务器指定某种传输协议以便服务器进行转换（如果支持）
* 例如：Upgrade: HTTP/2.0, SHTTP/1.3, IRC/6.9, RTA/x11
*
* @param upgrade
*/
public HttpHeader upgrade(String upgrade)
headerMaps.put(HttpReqHead.UPGRADE,
new BasicHeader(HttpReqHead.UPGRADE, upgrade));
return this;
/**
* User-Agent的内容包含发出请求的用户信息
*
* @param userAgent
* @return
*/
public HttpHeader userAgent(String userAgent)
headerMaps.put(HttpReqHead.USER_AGENT,
new BasicHeader(HttpReqHead.USER_AGENT, userAgent));
return this;
/**
* 关于消息实体的警告信息
* 例如：Warn: 199 Miscellaneous warning
*
* @param warning
* @return
*/
public HttpHeader warning(String warning)
headerMaps.put(HttpReqHead.WARNING,
new BasicHeader(HttpReqHead.WARNING, warning));
return this;
/**
* 通知中间网关或代理服务器地址，通信协议
* 例如：Via: 1.0 fred, 1.1 nowhere.com (Apache/1.1)
*
* @param via
* @return
*/
public HttpHeader via(String via)
headerMaps.put(HttpReqHead.VIA,
new BasicHeader(HttpReqHead.VIA, via));
return this;
/**
* 设置此HTTP连接的持续时间（超时时间）
* 例如：Keep-Alive: 300
*
* @param keepAlive
* @return
*/
public HttpHeader keepAlive(String keepAlive)
headerMaps.put(HttpReqHead.KEEP_ALIVE,
new BasicHeader(HttpReqHead.KEEP_ALIVE, keepAlive));
return this;
public String accept()
return get(HttpReqHead.ACCEPT);
public String acceptCharset()
return get(HttpReqHead.ACCEPT_CHARSET);
public String acceptEncoding()
return get(HttpReqHead.ACCEPT_ENCODING);
public String acceptLanguage()
return get(HttpReqHead.ACCEPT_LANGUAGE);
public String acceptRanges()
return get(HttpReqHead.ACCEPT_RANGES);
public String authorization()
return get(HttpReqHead.AUTHORIZATION);
public String cacheControl()
return get(HttpReqHead.CACHE_CONTROL);
public String connection()
return get(HttpReqHead.CONNECTION);
public String cookie()
return get(HttpReqHead.COOKIE);
public String contentLength()
return get(HttpReqHead.CONTENT_LENGTH);
public String contentType()
return get(HttpReqHead.CONTENT_TYPE);
public String date()
return get(HttpReqHead.DATE);
public String expect()
return get(HttpReqHead.EXPECT);
public String from()
return get(HttpReqHead.FROM);
public String host()
return get(HttpReqHead.HOST);
public String ifMatch()
return get(HttpReqHead.IF_MATCH);
public String ifModifiedSince()
return get(HttpReqHead.IF_MODIFIED_SINCE);
public String ifNoneMatch()
return get(HttpReqHead.IF_NONE_MATCH);
public String ifRange()
return get(HttpReqHead.IF_RANGE);
public String ifUnmodifiedSince()
return get(HttpReqHead.IF_UNMODIFIED_SINCE);
public String maxForwards()
return get(HttpReqHead.MAX_FORWARDS);
public String pragma()
return get(HttpReqHead.PRAGMA);
public String proxyAuthorization()
return get(HttpReqHead.PROXY_AUTHORIZATION);
public String referer()
return get(HttpReqHead.REFERER);
public String te()
return get(HttpReqHead.TE);
public String upgrade()
return get(HttpReqHead.UPGRADE);
public String userAgent()
return get(HttpReqHead.USER_AGENT);
public String via()
return get(HttpReqHead.VIA);
public String warning()
return get(HttpReqHead.WARNING);
public String keepAlive()
return get(HttpReqHead.KEEP_ALIVE);
/**
* 获取head信息
*
* @return
*/
private String get(String headName)
if (headerMaps.containsKey(headName))
return headerMaps.get(headName).getValue();
return null;
/**
* 返回header头信息
*
* @return
*/
public Header[] build()
Header[] headers = new Header[headerMaps.size()];
int i = 0;
for (Header header : headerMaps.values())
headers[i] = header;
i++;
headerMaps.clear();
headerMaps = null;
return headers;
/**
* Http头信息
*
* @author arron
* @date 2015年11月9日 上午11:29:04
* @version 1.0
*/
private static class HttpReqHead
public static final String ACCEPT = "Accept";
public static final String ACCEPT_CHARSET = "Accept-Charset";
public static final String ACCEPT_ENCODING = "Accept-Encoding";
public static final String ACCEPT_LANGUAGE = "Accept-Language";
public static final String ACCEPT_RANGES = "Accept-Ranges";
public static final String AUTHORIZATION = "Authorization";
public static final String CACHE_CONTROL = "Cache-Control";
public static final String CONNECTION = "Connection";
public static final String COOKIE = "Cookie";
public static final String CONTENT_LENGTH = "Content-Length";
public static final String CONTENT_TYPE = "Content-Type";
public static final String DATE= "Date";
public static final String EXPECT = "Expect";
public static final String FROM = "From";
public static final String HOST = "Host";
public static final String IF_MATCH = "If-Match ";
public static final String IF_MODIFIED_SINCE = "If-Modified-Since";
public static final String IF_NONE_MATCH = "If-None-Match";
public static final String IF_RANGE = "If-Range";
public static final String IF_UNMODIFIED_SINCE = "If-Unmodified-Since";
public static final String KEEP_ALIVE = "Keep-Alive";
public static final String MAX_FORWARDS = "Max-Forwards";
public static final String PRAGMA = "Pragma";
public static final String PROXY_AUTHORIZATION = "Proxy-Authorization";
public static final String RANGE = "Range";
public static final String REFERER = "Referer";
public static final String TE = "TE";
public static final String UPGRADE = "Upgrade";
public static final String USER_AGENT = "User-Agent";
public static final String VIA = "Via";
public static final String WARNING = "Warning";
/**
* 常用头信息配置
*
* @author arron
* @date 2015年11月18日 下午5:30:00
* @version 1.0
*/
public static class Headers
public static final String APP_FORM_URLENCODED="application/x-www-form-urlencoded";
public static final String TEXT_PLAIN="text/plain";
public static final String TEXT_HTML="text/html";
public static final String TEXT_XML="text/xml";
public static final String TEXT_JSON="text/json";
public static final String CONTENT_CHARSET_ISO_8859_1 = Consts.ISO_8859_1.name();
public static final String CONTENT_CHARSET_UTF8 = Consts.UTF_8.name();
public static final String DEF_PROTOCOL_CHARSET = Consts.ASCII.name();
public static final String CONN_CLOSE = "close";
public static final String KEEP_ALIVE = "keep-alive";
public static final String EXPECT_CONTINUE = "100-continue";
//设置header信息
Header[] headers=HttpHeader.custom().keepAlive("false").connection("close").contentType(Headers.APP_FORM_URLENCODED).build();代码已上传至：https://github.com/Arronlong/httpclientUtil。
httpclientUtil （QQ交流群:548452686 
）
轻松把玩httpclient之封装httpclient工具类，封装输入参数，简化工具类(代码片段)
在写这个工具类的时候发现传入的参数太多，以至于方法泛滥，只一个send方法就有30多个，所以对工具类进行了优化，把输入参数封装在一个对象里，这样以后再扩展输入参数，直接修改这个类就ok... 查看详情
轻松把玩httpclient之封装httpclient工具类，插件式配置header(代码片段)
上篇文章介绍了插件式配置HttpClient，本文将介绍插件式配置Header。 为什么要配置header在前面已经提到了，还里再简单说一下，要使用HttpClient模拟请求，去访问各种接口或者网站资源，都有可能有... 查看详情
轻松把玩httpclient之封装httpclient工具类，新增验证码识别功能(代码片段)
这个HttpClientUtil工具类分享在GitHub上已经半年多的时间了，并且得到了不小的关注，有25颗star，被fork了38次。有了大家的鼓励，工具类一直也在完善中。最近比较忙，两个多月前的修改在今天刚修改测试... 查看详情
轻松把玩httpclient之封装httpclient工具类，添加多文件上传功能(代码片段)
在Git上有人给我提Issue，说怎么上传文件，其实我一开始就想上这个功能，不过这半年比较忙，所以一直耽搁了。这次正好没什么任务了，赶紧完成这个功能。毕竟作为一款工具类，有基本的请求和... 查看详情
轻松把玩httpclient之封装httpclient工具类，单线程调用及多线程批量调用测试(代码片段)
...rl="http://tool.oschina.net/"; //简单调用 Stringresp=HttpClientUtil.send(url); System.out.println("请求结果内容长度："+resp.length()); System.out.println("\\n#################################\\n"); System.out.println("--------加入h... 查看详情
轻松把玩httpclient之封装httpclient工具类，优化启用http连接池策略(代码片段)
写了HttpClient工具类后，有人一直在问我怎么启用http连接池，其实我没考虑过这个问题。不过闲暇的时候，突然间想起了这个问题，就想把这个问题搞一搞。 之前没用过，但是理解起来应该不算难... 查看详情
轻松把玩httpclient之封装httpclient工具类，携带cookie的请求(代码片段)
最近更新了一下HttpClientUtil工具类代码，主要是添加了一个参数HttpContext，这个是用来干嘛的呢？其实是用来保存和传递Cookie所需要的。因为我们有很多时候都需要登录，然后才能请求一些想要的数据。而在... 查看详情
轻松把玩httpclient之配置ssl，采用绕过证书验证实现https
上篇文章说道httpclient不能直接访问https的资源，这次就来模拟一下环境，然后配置https测试一下。在前面的文章中，分享了一篇自己生成并在tomcat中配置ssl的文章《Tomcat配置SSL》，大家可以据此来在本地配置https。我已经配置好... 查看详情
httpclient教程
HttpClient教程2017-03-29官方文档：http://hc.apache.org/httpcomponents-client-ga/ HttpClientTutorial翻译文档：第一章基础第二章连接管理第三章HTTP状态管理第四章HTTP认证第五章HTTP客户端服务第六章高级主题封装HttpClient 轻松把玩HttpClient... 查看详情
轻松把玩httpasyncclient之模拟post请求示例(代码片段)
如果看到过我前些天写过的《轻松把玩HttpClient之模拟post请求示例》这篇文章，你再看本文就是小菜一碟了，如果你顺便懂一些NIO，基本上是毫无压力了。因为HttpAsyncClient相对于HttpClient，就多了一个NIO，... 查看详情
javascript面向对象轻松入门之封装(demobyes5es6typescript)
...默认大家已经看过作者的前一篇文章《JavaScript面向对象轻松入门之抽象》为什么要封装？ 封装（Encapsulation）就是把对象的内部属性和方法隐藏起来，外部代码访问该对象只能通过特定的接口访问，这也是面向接口编程思想... 查看详情
把玩pencil项目之编译并运行(代码片段)
Pencil是个好项目。使用Electron作为运行环境，如同VsCode一样，将JS跨平台桌面应用做了一个好的示范。个人很喜欢这种方式，毕竟多年来关注Web全栈开发，有一种JS一统天下的感觉。我的运行环境是Macbook+vscode。 1.首先是下载Pe... 查看详情
angular22httpclient的使用
1HttpClient介绍 HttpClient时Http的演进，注意：Http在@angular/http中，而HttpClient在@angular/common/http中；使用前需要在模块级别导入HttpClientModule,通常的做法是在核心模块中导入，在将核心模块导入到主模块中 2HttpClient特性说... 查看详情
使用 httpClient 获取 JSON 字符串
】使用httpClient获取JSON字符串【英文标题】：GetJSONstringwithhttpClient【发布时间】：2014-10-0105:02:12【问题描述】：我正在使用XamarinForms，我正在尝试获取位于此处的文件的JSON字符串。但是我似乎无法取出Json字符串。这是我的代码... 查看详情
httpclient和httpurlconnection的区别
...on是java的标准类，什么都没封装，用起来太原始，不方便HttpClient实际上是对Java提供方法的一些封装，在HttpURLConnection中的输入输出流操作，在这个接口中被统一封装成了HttpPost(HttpGet)和HttpResponse，这样，就减少了操作的繁琐性。... 查看详情
xamarin.android之封装个简单的网络请求类
...于是现在将其简单的改写，做了个简单的封装，包含基于HttpClient和HttpWebRequest两种方式的封装。由于对这一块还不是很熟悉，所以可能不是很严谨。二、先上封装 查看详情
httpclient的简单运用(代码片段)
...近在工作中需要在后台调用短信接口，经过研究决定使用HttpClient，自己封装了一个HttpClient工具类，简单轻松的实现get，post，put和delete请求，希望分享给大家。1.什么是HttpClient HTTP协议可能是现在Internet上使用得最多、最重要... 查看详情
xamarin.android之封装个简单的网络请求类
...于是现在将其简单的改写，做了个简单的封装，包含基于HttpClient和HttpWebRe 查看详情