java|java apache httpclient快速使用 javaapachehttpclient快速使用

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.生成复合型实体: 【java|java apache httpclient快速使用】方法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);

方法2：借助MultipartEntityBuilder，链式调用

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编码及相关细节