java apache client_java apache httpclient快速使用

http报文的2个主要项：头部(headers)、实体(entity/body)。

apache httpclient 提供大量builder等链式调用(和静态)方法，因此如果发现不能new一个对象，请查阅相关工具类中是否有静态方法可用。

httpclient文档

httpclient各种MIME实体的文档

httpclient core文档

官方文档比较零散，比如在httpclient文档中经常出现继承自某个类，而这个类没有超链接点击，要自己去httpclient core文档中找。建议maven导入时把文档也给下载下来，IDE中直接看也很方便

基本步骤

CloseableHttpClient httpclient = HttpClients.createDefault();

HttpGet httpget = new HttpGet("https://www.jianshu.com");

CloseableHttpResponse response = httpclient.execute(httpget);

//......

response.close();

1.CloseableHttpClient，反正就是用这个，和HttpClient接口的差异自行查询文档

2.HttpClients，提供了几个很方便的创建CloseableHttpClient的方法。也可用HttpClientBuilder.create().build()，看你喜欢记哪个

3.HttpGet，代表get方式请求。注意看它继承的方法，如：setUrl让你更改url而无需再new和设置；setConfig让你设置超时等设置，详细文档跳转自行查询

4.CloseableHttpResponse代表响应报文，查文档调方法即可

5.复用问题。即上面httpclient.execute是线程安全的，可以调用多次且请求之间不会互相影响。要注意的是其返回的CloseableHttpResponse对象要及时调用close方法关闭，否则可能导致其内部线程池耗尽，无法再发出请求而超时。

6.HttpPost 代表post请求

参数设置

看HttpGet和HttpPost，他们继承的setXXX方法，看单词就能知道要搞什么了。get方式太简单，大不了自己拼装字符串到url再urlencoded什么的，不做解析，下面是post如何设置请求实体：

1.直接new单个实体

httpPost.setEntity(new StringEntity(data));

各种常见可直接new的Entity有：ByteArrayEntity, FileEntity, InputStreamEntity, SerializableEntity, StringEntity。详细见文章开头给出的core文档

2.生成复合型实体:

方法1：new一个MultipartEntity和各个MIME的body，然后MultipartEntity.addPart

其常见的各种body有：ByteArrayBody, FileBody, InputStreamBody, StringBody，和上面的基本对应，详细见文章开头的MIME实体文档

MultipartEntity entity = new MultipartEntity();

StringBody sb=new StringBody("data");

entity.addPart("参数名1",sb);

FileBody fileBody = new FileBody(file);

entity.addPart("参数名2", fileBody);

httpPost.setEntity(entity);

HttpEntity entity = MultipartEntityBuilder.create().addXXXBody(...).addXXXBody(...).setXXX(...).build();

httpPost.setEntity(entity);

3.用List之类的，请右转百度

注意

请确保了解application/x-www-form-urlencoded、multipart/form-data、application/json，了解你自己在做什么，不要出现一些神奇的组合。

1.比如网站接收application/json的MIME格式，那么在httpclient中请手动设置content-type这个header，实体部分直接用StringEntity，不需要url编码

2.application/x-www-form-urlencoded(需要编码)、multipart/form-data(不需要编码)。可以简单理解为有二进制流(文件上传)时必须使用multipart/form-data

可右转unicode和url编码及相关细节