代码拉取完成，页面将自动刷新
==============
Java网络框架的另一种选择
==============
easy-okhttp是Java网络框架，简化网络操作，专注于业务处理
** 在GITOSC下不生效 **
easy-okhttp是对OkHttp网络框架封装，提供文件上传和下载，表单(含文件)提交，链式调用，支持HTTPS和自定义签名证书等特性。
OkHttp网络框架的流行始于Android，但是在Java后端仍然是Apache HttpClient网络框架，这个框架功能非常强大，但缺点在于设计非常的复杂且jar的比较大。
所以才有easy-okhttp项目，主要目的希望弃用Apache HttpClient，其次也是为了帮助OkHttp的推广啦。
OkHttp，本项目核心所在，底层依赖了okio框架，框架的大小在500Kb之内mzlion-core，项目依赖的工具类，底层依赖了slf4j-api和gson两个框架，框架的大小在400Kb之内也就是说easy-okhttp整个包的大小在1M左右，相对于Apache HttpClient体积非常的小，而且使用也更为方便。
easy-okhttp需要JDK7及其以上版本的支持，如果您还不是JDK7的话，新项目赶紧升级吧。
maven
<dependency>
<groupId>com.mzlion</groupId>
<artifactId>easy-okhttp</artifactId>
<version>1.1.0</version>
</dependency>
Gradle
compile 'com.mzlion:easy-okhttp:1.1.0'
下载jar
框架会自动读取classpath下的easy-okhttp.properties配置文件，如果没有特别的要求话，一般不需要重载该配置文件。
easy-okhttp.properties配置文件的配置信息
easy-okhttp.properties，框架优先加载项目中的配置文件，超时时间的单位都是秒HttpClient.Instance.setConnectTimeout(int)
HttpClient.Instance.setReadTimeout(int)
HttpClient.Instance.writeTimeout(int)
HttpClient.Instance.customSSL(?)
HttpClient.Instance.setDefaultHeader(?)
HttpClient.Instance.customSSL()
HttpClient.Instance.customSSL(HttpClient.class.getClassLoader().getResourceAsStream("mzlion_com.cer"))
HttpClient.Instance.customSSL(InputStream pfxStream, char[] pfxPwd, InputStream... certificates)
这几天我会提供测试接口，供大家调试使用，敬请期待，期待的来啦： https://project.mzlion.com/easy-okhttp/api
String responseData = HttpClient
// 请求方式和请求url
.get("http://localhost:8080/user-sys/user/list")
.asString();
String responseData = HttpClient
// 请求方式和请求url
.get("http://localhost:8080/user-sys/user/list")
//设置请求参数
.queryString("mobile","18018110018")
.asString();
String responseData = HttpClient
// 请求方式和请求url
.post("http://localhost:8080/user-sys/user/add")
// 表单参数
.param("name","张三")
.param("mobile", "13023614020")
.param("langs", "Java")
.param("langs", "Python")
//url参数
//queryString("queryTime","20160530")
.asString();
一般针对POST提交数据内容较为复杂、接口约定需要POST上传时调用本方法非常有效。这种提交方式也是POST，但是数据内容和格式直接写入请求流中。比如微信接口就是这种模式。
String responseData = HttpClient
// 请求方式和请求url
.textBody("http://localhost:8080/user-sys/user/body1")
.text("设施一串和服务端约定好的数据格式")
//设置编码
//.charset("utf-8")
.asString();
String responseData = HttpClient
// 请求方式和请求url
.textBody("http://localhost:8080/user-sys/user/import")
// post提交json
.json("[{\"name\": \"test-13\",\"mobile\": \"18321001200\",\"programLangs\": \"Java,Pyhton\",\"remark\": \"0\"}]")
//post提交xml
//.xml("<?xml version=\"1.0\" encoding=\"utf-8\" ?>")
//post提交html
//.html("function fun(){}")
//.charset("utf-8")
//设置编码
.asString();
String responseData = HttpClient
// 请求方式和请求url
.textBody("http://localhost:8080/user-sys/user/body2")
//post提交xml
.xml("<?xml version=\"1.0\" encoding=\"utf-8\" ?>")
//post提交html
//.html("function fun(){}")
//post提交一段javascript
//.javascript("function fn(){}")
//设置编码
//.charset("utf-8")
.asString();
String responseData = HttpClient
// 请求方式和请求url
.binaryBody("http://localhost:8080/user-sys/user/body3")
// post提交流
.stream(this.getClass().getClassLoader().getResourceAsStream("avatar.png"))
//设置请求内容类型
.contentType(ContentType.IMAGE_JPG)
//post提交文件
//.file(new File("d:/avatar.png"))
.asString();
//ContentType内置常见的MIME类型，基本上不用自己创建
String responseData = HttpClient
// 请求方式和请求url
.post("http://localhost:8080/user-sys/user/add")
.param("name", "李四")
.param("mobile", "13023614021")
.param("avatarFile", this.getClassLoader().getResourceAsStream("avatar.png"), "avatar.png")
//.param("avatarFile", new File("D:/avatar.png")
.asString();
String responseData = HttpClient
// 请求方式和请求url
.post("http://localhost:8080/user-sys/user/add")
// 表单参数
.param("name","张三")
.param("mobile", "13023614020")
.param("langs", "Java")
.param("langs", "Python")//会多种语言
.asString();
以上展示的代码都是基于同步请求的，并且你会发现示例代码中总是出现asString()方法，这个方法来自HttpResponse类，
目前as***方法已经提升和execute方法级别一样，用法和HttpResponse提供的方法一样。
HttpResponse.isSuccess()表示请求是否成功，只有请求成功才会有后面的功能。HttpResponse.getErrorMessage 请求失败时错误消息。下面就是非常非常非常好用的方法
public String asString() 将响应结果直接转为字符串public <E> E asBean(Class<E> targetClass) 将响应结果转为JavaBeanpublic <E> E asBean(TypeRef<E> typeRef) 也是将响应结果转为JavaBean，和上面的区别在于该方法能够提取到泛型信息public byte[] asByteData() 将响应结果转为二进制内容，这是数据在网络请求的原始数据public void asFile(File saveFile) 将响应结果转为文件存储，当远程是文件时该方法非常有用public void asStream(OutputStream out) 直接将响应结果输出到另外一个流中public <T> T custom(DataHandler<T> dataHandler) 当以上这些方法都满足不了你的话，这个方法可以自己DIY，随你怎么蹂躏下面给出一些简单的代码，这些方法已经非常简单了。
//将响应结果转为字符串输出
String responseData = httpResponse.asString();
//将响应结果转为文件保存
File frc = new File("d:\\web\\save.txt");
httpResponse.asFile(frc);
//json转换器
List<Person> personList = httpResponse.asBean(new TypeToken<List<Person>>(){});
//重载方法
//Person person = httpResponse.asBean(Person.class);
//将响应结果转为输出流中
ByteArrayOutputStream baos = new ByteArrayOutputStream();
httpResponse.asStream(baos);
前面已经提到HTTPS的配置，下面给出一些简单的示例更直观了解用法。
//由信任CA机构发布的，比如GitHub的https，框架不需要你做什么事情，正常使用即可
String githubContent = HttpClient
.get("https://www.mzlion.com")
.asString();
//不管三七二十几，直接忽略HTTPS
String mzlionIndexContent = HttpClient
.get("https://kyfw.12306.cn/otn/")
.customSSL()
.asString();
//自签SSL或程序不认可实际安全的，可以指定客户端证书
String mzlionIndexContent = HttpClient
.get("https://kyfw.12306.cn/otn/")
.customSSL(this.getClass().getClassLoader().getResourceAsStream("SRCA.cer"))
.asString();
这是新版本的新增的一个功能，数据处理器定义接口返回数据处理能力，该接口就只有一个函数
T handle(final okhttp3.Response response) throws IOException;
该函数提供了将原始数据格式转为业务所需数据格式，框架提供了常用接口处理器实现，若以下的处理器无法满足需求可以自己实现一个处理器。
StringDataHandler 字符串处理器，该处理器比较常用，可以直接调用StringDataHandler.create()得到处理器的实例JsonDataHandler<T> JSON处理器，该处理器也比较常用，即将JSON字符串转为JavabeanFileDataHandler 文件处理器，将结果存储到文件中，该处理器有两个构造参数，其中dirPath保存目录必填，filename保存的文件名可选，如果为空时框架自动从header、url中获取，如果获取不到则随机生成一个文件名。异步请求不会阻塞当前线程（特别是网络慢的时候），适用于对返回结果不关心或不需要立即知晓的情况下，比如推送、通知等。 异步请求只有在执行网络请求的时候有一点区别，其他地方和同步请求配置和操作都是一样的。
String githubContent = HttpClient
.get("https://www.github.com")
.execute(new CallbackAdaptor<String>(){
@Override
public DataHandler<String> getDataHandler() {
return StringDataHandler.create();
}
@Override
public void onSuccess(String data) {
//data就是经过处理后的数据，直接在这里写自己的业务逻辑
}
});
Callback是回调定义接口，里面总共定义了6个函数，每个函数被调用的顺序不一样。
onBefore() 第一被调用，主要在请求网络之前，这个函数有返回值，如果返回false则阻止此次请求了；postProgress() 第二被调用，上传进度回调函数onError() 第三被调用，当只有请求失败时才会触发；onComplete() 第四被调用，当请求接口完成后触发该函数；onSuccess() 第五被调用，当请求接口成功（HTTP状态码为200）则会触发该函数，
该函数会依赖另外一个函数getDataHandler()，返回一个指定的数据处理器，处理原始数据。对于数据处理器前面已经了解过了。异步回调接口Callback总共定义了6个函数，但是一般不会关心所有函数处理情况，所以提供了CallbackAdaptor空实现类，想要关注哪个函数的执行结果，重载那个函数即可。
当我们需要对单个请求设置连接超时时间、读取超时时间等属性时，可以在执行execute方法之前调用。主要有如下几个方法可以进行调用。
connectTimeout(int) 连接超时时间readTimeout(int) 读取超时时间writeTimeout(int) 写入超时时间customSSL() 设置https证书一般一个项目只请求一个远程服务，所以这些配置可以在全局配置，共享一个OkHttpClient对象(相当于共享一个浏览器)，
以上这些方法的调用会使得框架创建一个新的OkHttpClient对象(相当于又打开了一个浏览器)。下面给出一个snippet加以说明。
此处可能存在不合适展示的内容，页面不予展示。您可通过相关编辑功能自查并修改。
如您确认内容无涉及 不当用语 / 纯广告导流 / 暴力 / 低俗色情 / 侵权 / 盗版 / 虚假 / 无价值内容或违法国家有关法律法规的内容，可点击提交进行申诉，我们将尽快为您处理。