OkHttp 4.x出来已经有一段时间了,根据JCenter的上传记录,早在今年五月份,square就上传了4.X的第一个版本,4.0.0-alpha01。
主要的区别在于之前是基于JAVA,而4.X往后,都将会是用kotlin来写。可以看得出来,kotlin将会是大势所趋。Google了一下,发现还没人写关于OkHttp4的教程。其实我个人也感觉没什么必要。这次的升级还是很平滑,甚至为了和3.X兼容,包名都仍然保持了okhttp3。但我在使用过程中,还是发现了一些不同,所以稍微做一下小结,方便使用的人们理解。
官网上对这次升级做了一些说明,大致翻译一下,语言由java改为kotlin,包名保持不变,通过 japicmp实现二进制兼容,在不更改.kt和.java文件的基础上,从3.x迁移到4.X。还有一些之前不是final的方法现在改成final了。之前的getter和setter也在kotlin里用不到了,balabala等等。以前三条为例子,他说使用了japicmp,而japicmp是一个可以比较两个jar包不同的library,然后再看一下4.X的源码你会发现,为了兼容3.x,square还是花了很多心血的,比如大量的@JvmName。
剩下的也差不多。
看起来好像4.X和3.X在使用上完全没有区别,但并非如此。这里,我以post提交为例子,说明一下不同点
目前在官网上在提交post的请求的时候,任然会告诉你这么写。
现在你想着,我会okhttp3.X,也会kotlin,那么只要把原来的java代码改成kotlin就行了。然而改完运行却是这样的
这样的代码在java里是完全没问题,但在kotlin里,却无法通过编译。这可能就是square在不改动原有.java文件的基础上迁移到okhttp 4.x吧。如果你在.kt文件里用的是3.x版本,那么是完全没问题的。
解决错误也很简单,查看kotlin源码可以得知,现在这个方法被标记为过时方法,我们要使用kotlin里的扩展方法,也即是这么写:
import okhttp3.MediaType.Companion.toMediaType
import okhttp3.RequestBody.Companion.toRequestBody
fun post(){
val okHttpClient=OkHttpClient()
val jsonObject=JSONObject()
jsonObject.put("abc","bcd")
val requestBody=jsonObject.toString().toRequestBody("application/json; charset=utf-8".toMediaType())
val request=Request.Builder().url("https://www.baidu.com").post(requestBody).build()
okHttpClient.newCall(request).enqueue(object :Callback{
override fun onFailure(call: Call, e: IOException) {
}
override fun onResponse(call: Call, response: Response) {
Log.d("onResponse","kt example:"+response.body?.string())
}
})
}
注意这里有个细节,我们必须手动导入okhttp的局部扩展方法,否是是没有办法把string转为requestbody的
如果你用的是java,但想用Okhttp4的话,则那个内部的扩展方法变成了这样
扩展方法本质就是增加一个自身的参数,所以当我们用java调用的时候,会看到一个$开头的参数,这个就是原来kotlin里的扩展方法
GET的话和原来一模一样,没什么改变,就不提了。
最后,我基于okhttp4,写了一个网络请求库,oksimple,欢迎使用和提意见