教你用builder模式封装网络请求

从今天开始,我决定做一件有意义的事,逐步开源一些我认为很有价值的项目并附带一些深度的原理分析。给那些想要提高android开发技术水平,但又没有思路的同学一些方法上的启迪。同时也可以宏观上扩展个人的技术视野和眼界。下面开始第一个开源项目的深度讲解,大家一起来吧。

项目名称DDNetCore,封装这个框架的主要目的是简化网络数据的获取,解析过程,让业务开发者从处理网络数据获取的复杂事务中解脱出来,将更多的关注点放在业务逻辑的开发上面。

项目git地址:https://github.com/jessie345/DDNetCore

下面我尝试以一种更容易理解的方式说明这个框架的使用方式和工作原理。首先来一张框架流程图,可以从宏观的角度理解下框架内部交互的大体过程。


数据请求框架.png

现在,我们按照流程图描述的执行顺序,逐步阐述框架的使用方式及原理。

发起数据请求的第一步需要实例化请求对象,并塞给RequestManager 执行。原生的方式需要为不同的请求创建不同的Request子类,子类中处理请求相关的逻辑(覆写相关的回掉方法)并实例化。但是这种方式带来一个问题,对于大多数请求,请求及响应结果的处理逻辑基本相同,为了减少创建子类的重复劳动,网络库提供了DataRequestBuilder 构建器,通过他,可以创建通用的对象请求(返回结果可以对等一个bean),列表请求实例(返回结果可以对比成List<Bean>)。这个模式极大的简化了发起请求需要执行的前期工作,让你编写数据接口的工作相当简单,我举个例子:

  Request request = DataRequestBuilder.asArrayRequest("/products")
                .requestId(REQUEST_FETCH_PRODUCTS)
                .requestDefaultStrategy(Constants.STRATEGY_LEVEL3_CACHE)
                .requestExpireStrategy(Constants.STRATEGY_REFRESH_CACHE)
                .memoryCache()
                .dbCache()
                .dataClass(ProductBean.class)
                .httpMethod(Constants.HTTP_METHOD_GET)
                .build();

上面几行代码创建了一个获取产品列表的数据请求,第一行代码指定了创建一个路径为/products的数组请求,即服务器返回的数据是个列表。第二行代码为请求指定了id,通过这个id,我在响应回调里可以非常容易的区分哪个请求的结果返回了。第三第四行代码分别指明了默认情况和请求响应结果过期情况的请求执行策略,框架提供三种数据请求策略,分别为:Constants.STRATEGY_LEVEL3_CACHE(三级缓存策略),Constants.STRATEGY_REFRESH_CACHE(强制刷新缓存策略),Constants.STRATEGY_ONLY_NET(强制请求网络策略)。第五行第六行指定请求是否使用内存和数据库缓存。第七行指定用哪个class反序列化服务器返回的数据。倒数第二行指定了请求的执行方式为get,框架同时内置了对两种基本请求方式的支持,Constants.HTTP_METHOD_GET(基本get请求方式),Constants.HTTP_METHOD_POST(post 请求方式,post的content-type可以为application/json,www-form-urlencoded)

有了request实例,我们可以将它交给RequestManager执行了。我在BaseActivity中封装了如下代码:

    public void enqueueRequest(Request request) {
        if (!mNetworkControl.isControlListenerRegistered(this)) {
            mNetworkControl.registerControlListener(this);
        }

        mNetworkControl.enqueueRequest(request);
    }

通过NetWorkControl实例,将请求交给RequestManager执行,NetWorkControl中会执行一些与取消请求相关的逻辑。

请求已经提交到线程池执行,那么我们如何接收返回的数据结果呢。NetworkControl 类提供了获取响应结果的监听函数:

    public void registerControlListener(@NonNull NetworkControlListener listener) {
        Preconditions.checkNotNull(listener);
        this.mListenerRef = new WeakReference(listener);
    }

注册监听后,通过如下三个与请求生命周期相关的回调,就可以获取请求及响应的相关信息啦。

    public void handlePreNetRequest(@NonNull Request request) {
    }

    @Override
    public void handleNetRequestError(@NonNull Request request, @NonNull ResponseHeader rb) {
    }

    @Override
    public void handleReceivedResponse(@NonNull EventResponse event) {
    }

handlePreNetRequest 表示某个请求即将添加到请求队列执行。handleNetRequestError 表示某个请求发生了错误。handleReceivedResponse 表示请求的结果正确返回。通过这三个方法就能判断Request的执行状态了。

体会一下,写一个请求接口是不是很简单。

如果想了解更多信息或者对开源项目感兴,请加我的微信公众号,我在那里等你

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

推荐阅读更多精彩内容

  • https://nodejs.org/api/documentation.html 工具模块 Assert 测试 ...
    KeKeMars阅读 6,221评论 0 6
  • iOS网络编程读书笔记 Facade Tester客户端门面模式的实例(被动版本化) 被动版本化,所以硬编码URL...
    melouverrr阅读 1,575评论 3 7
  • AFHTTPRequestOperationManager 网络传输协议UDP、TCP、Http、Socket、X...
    Carden阅读 4,263评论 0 12
  • 今天是第三十三个教师节,收到了孩子们的很多小礼物和和远在外地遥远的祝福,尤其是一些感觉还是四五年前的那个孩子但不经...
    楚言初语阅读 163评论 0 0
  • 你我不过蓦然回首 来不及嫣然一笑 就已各奔东西 不再相见 你我也许轻舟小曲 等得到断桥残雪 却已相敬如宾 不再相念...
    febe01fa282d阅读 109评论 0 1