Android OkHttp 史上最优雅的设置baseUrl

前言

本文将在RxHttp的基础上带你们如何优雅的设置BaseUrl，若是您还未了解RxHttp，请移步

RxHttp 一条链发送请求，新一代Http请求神器（一）

RxHttp 一条链发送请求之强大的数据解析功能（二）

RxHttp 一条链发送请求之强大的Param类（三）

RxHttp 一条链发送请求之注解处理器 Generated API（四）

为什么要重复造轮子

RxHttp一经推出，就有人问：难道Retrofit很差用吗？为啥还要本身去封装呢？借此文，跟你们简单聊一聊。 为何要重复造轮子？无非就一个缘由

• 之前的轮子有些功能很差用，用起来不够优雅

Retrofit哪里很差用，用起来不够优雅？

首先，我以为是对文件的操做不是那么的友好，如文件上传/下载、上传/下载进度监听、断点下载，这些都须要咱们进行二次封装，看过Android 史上最优雅的实现文件上传、下载及进度的监听的同窗知道，使用RxHttp是多么的简单；

而后，是对多个baseUrl，或者说动态baseUrl不够友好，Retrofit要求baseUrl 必须是一个final常量，咱们想要动态修改，就只能经过增长拦截器去实现，这也是本文重点要说的；

最后，也是很是重要的一点，那就是Activity/Fragment销毁时，对请求的关闭，一般咱们的作法是为请求设置Tag，而后根据此Tag去关闭一系列请求，又或者拿到Call对象，去关闭单个请求，极其的麻烦，若是你使用RxHttp，在Activity/Fragment中，一行代码就能搞定，而且支持在任意生命周期方法关闭请求，极其简单高效。(注意：Retrofit结合RxJava，依然可以在RxJava中断上下游时，调用Call对象的cancel方法，感谢评论区卓_修武大佬的指正)

以上就是我重复造轮子的主要缘由，欢迎你们交(Da)流(Lian)讨论，下面将进入正题。

单个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)")
        .asString()  //这里返回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() //使用指定的域名
        .asDownload(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";
    
    @Domain(name = "Hao123")
    public static String update = "https://www.hao123.com/";

    @Domain(name = "Update")
    public static String update = "http://update.9158.com";

    @DefaultDomain() //设置为默认域名,对final关键字没有要求
    public static String baseUrl = "http://ip.taobao.com/";
}
复制代码

此时rebuild一下项目，RxHttp类下就会再新增setDomainToBaiduIfAbsent()、setDomainToHao123IfAbsent()这两个方法，故咱们发请求就能够调用setDomainToXXXIfAbsent方法指定baseUrl。

动态baseUrl

某些状况下，咱们的域名可能会被封，又或者其它缘由，致使咱们须要在app启动的时候动态配置域名，若是你使用Retrofit的话，因为Retrofit要求baseUrl必须是final常量，因此咱们就只能经过拦截器去实现，而RxHttp对baseUrl ，没有final关键字的限制，咱们只须要对baseUrl从新赋值便可，并且，能够在代码中屡次赋值，赋值后当即生效。

如：咱们将baseUrl里taobao域名改成baidu,改完当即发送请求。

Url.baseUrl = "http://www.baidu.com";  //更改域名，将taobao域名改成baidu
  RxHttp.get("/service/getIpInfo.php") //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)")
        .asString()  //这里返回Observable<Response> 对象
        .as(RxLife.asOnMain(this))  //感知生命周期，并在主线程回调
        .subscribe(s -> {
            //成功回调
        }, throwable -> {
            //失败回调
        });
复制代码

看一下日志

能够看到，域名成功被更改，并当即生效。因为该接口不存在，因此返回了Html页面代码。

小结

怎么样，是否是最优雅的设置baseUrl？欢迎打脸。 其实，RxHttp远不止本篇文章说的这些优势，更多彩蛋，请查看源码

本文的目的并不在于说Retrofit很差，而是提供一种新的思路与方案，供开发者去选择。曾经有读者问我，有没有打算将RxHttp融入Retrofit，Retrofit的注解请求很好用，并且写在一个类里，很直观。个人回答是 NO ！RxHttp若是融入Retrofit，那RxHttp就是Retrofit，那还有什么区别呢？ 若是你喜欢将请求写在一个类里，RxHttp也是能实现的。以下：

public class Http {

    public static Observable<List<Student>> getStudents(int id, int page, int size) {
        return RxHttp.get("xxx/getStudent")
                .add("id", id).add("page", page).add("size", size)
                .asList(Student.class);
        //后期会增长add(key,value,key,value....)可变参数方法
    }
    
    //其它请求同理
}
复制代码

借此机会，若是你对RxHttp感兴趣，又有本身的想法，欢迎你加入维护的队伍中。

好了，转载请注明出处，🙏🙏🙏。

最后，欢迎你们，加群沟通交流 RxHttp&RxLife 交流群: 378530627，以前忘记建群了😅😅，但愿你们能多给点建议，我会第一时间回复。🙏🙏🙏

若是你以为RxHttp好用，请记得给我star。万分感谢🙏🙏🙏