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)

image

可以看到,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 -> {
            //下载失败
        });

我们再通过日志来观察一下

image

可以看到,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 -> {
            //失败回调
        });

看一下日志

image

可以看到,域名成功被更改,并立即生效。由于该接口不存在,所以返回了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。万分感谢🙏🙏🙏

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 216,372评论 6 498
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 92,368评论 3 392
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 162,415评论 0 353
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 58,157评论 1 292
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 67,171评论 6 388
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 51,125评论 1 297
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 40,028评论 3 417
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,887评论 0 274
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 45,310评论 1 310
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,533评论 2 332
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,690评论 1 348
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,411评论 5 343
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 41,004评论 3 325
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,659评论 0 22
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,812评论 1 268
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,693评论 2 368
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,577评论 2 353

推荐阅读更多精彩内容