Android-OkHttp- 史上最优雅的设置 baseUrl,安卓 binder
为什么要重复造轮子?无非就一个原因
以前的轮子有些功能不好用,用起来不够优雅
我们先来说说第一条,Retrofit 哪里不好用,用起来不够优雅?
首先
,我觉得是对文件的操作不是那么的友好,如文件上传/下载、上传/下载进度监听、断点下载,这些都需要我们进行二次封装,看过[Android 史上最优雅的实现文件上传、下载及进度的监听](
)的同学知道,使用 RxHttp 是多么的简单;
然后
,是对多个 baseUrl,或者说动态baseUrl
不够友好,Retrofit 要求 baseUrl 必须是一个 final 常量,我们想要动态修改,就只能通过增加拦截器去实现,这也是本文重点要说的;
最后
,也是非常重要的一点,那就是 Activity/Fragment 销毁时,对请求的关闭,通常我们的做法是为请求设置 Tag,然后根据此 Tag 去关闭一系列请求,又或者拿到 Call 对象,去关闭单个请求,极其的麻烦,如果你使用 RxHttp,在 Activity/Fragment 中,一行代码就能搞定,并且支持在任意生命周期方法关闭请求,极其简单高效。
以上就是我重复造轮子的主要原因,欢迎大家交(Da)流(Li
an)讨论,下面将进入正题。
单个 baseUrl
如果你的项目中只有一个 BaseUrl,那么只需要使用@DefaultDomain
注解即可,如下:
public class Url {@DefaultDomain() //设置为默认域名,对 final 关键字没有要求 public static String baseUrl = "http://ip.taobao.com/";}
发送请求,我们就可以这样
String url = "/service/getIpInfo.php";RxHttp.get(url) //Get 请求.add("ip", "63.223.108.42") //添加参数.addHeader("accept", "/") //添加请求头.addHeader("connection", "Keep-Alive").addHeader("user-agent", "Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1;SV1)").fromSimpleParser(String.class) //这里返回 Observable<String> 对象//感知生命周期,并在主线程回调,Activity/fragment 销毁,自动关闭为完成的请求.as(RxLife.asOnMain(this)).subscribe(s -> {//成功回调}, throwable -> {//失败回调});
此时,发送请求前,RxHttp 会对我们传入 url 做判断,如果 url 里已经有 baseUrl,即是一条完成 url 链接,就不会添加@DefaultDomain
注解表明的 baseUrl,否则就会添加,我们通过日志来观察以下结果(过滤 RxHttp)
可以看到,baseUrl 跟 url 成功拼接在了一起,并完成了请求。
注:
注解@DefaultDomain
只能使用一处,多处使用将编译不通过
多个 baseUrl
在上面代码中,我们只需要传入一条完整的 url 链接,其实就已经实现了多个 baseUrl 的问题,然后,大部分开发者都喜欢将 baseUrl 单独写在一个变量里,如果每次发请求,我们都需要以baseUrl+url
的方式去实现,显然不够友好,那么 RxHttp 又是如果去解决的呢?很简单,使用@Domain
注解,如下:
public class Url {@Domain(name = "Update")public static String update = "http://update.9158.com";
@DefaultDomain() //设置为默认域名,对 final 关键字没有要求 public static String baseUrl = "http://ip.taobao.com/";}
此时 rebuild 一下项目,RxHttp 类就会自动生成一个setDomainToUpdateIfAbsent()
方法,此方法的命名规则为setDomainTo
+@Domain注解中指定的name字段的值
+IfAbsent
,见名思议,此方法是会在域名缺席的情况下,添加我们指定的域名,如果没有指定,就会添加@DefaultDomain
注解标记的默认域名。
此时发请求,我们就可以这样:
String destPath = getExternalCacheDir() + "/" + System.currentTimeMillis() + ".apk";RxHttp.get("/miaolive/Miaolive.apk").setDomainToUpdateIfAbsent() //使用指定的域名.download(destPath) //注意这里使用 DownloadParser 解析器,并传入本地路径.as(RxLife.asOnMain(this)) //感知生命周期,并在主线程回调.subscribe(s -> {Log.d("RxHttp", "download success \npath=" + s);//下载成功,回调文件下载路径}, throwable -> {//下载失败});
我们再通过日志来观察一下
可以看到,baseUrl 跟 url 成功拼接在了一起,并完成了下载操作。
@Domain
注解可以使用多处,如下:
public class Url {@Domain(name = "Baidu")public static String update = "http://www.baidu.com";
评论