谈谈网络库和Retrofit

本文目录如下

  1. 网络模块需要具备什么能力
  2. 为什么Retrofit是个好选择
  3. Retrofit业务分析
  4. Retrofit技术点
  5. 设计模式

一.网络模块需要具备什么能力?

常见的需求下图:

下面解释一下重要的部分.

1.支持缓存

为了让页面快速展现,很多页面需要先加载缓存.
通用策略是

1.先加载缓存;
2.然后做网络请求
3.网络请求成功后刷新页面,并且更新缓存数据

这里涉及到,缓存要存在哪里. 一般也是两种方案:

  1. 业务侧做缓存. 每个页面自己维护缓存,一般存在db/sp/文件系统中
  2. 网络侧做缓存, 业务做网络请求的时候,可以要求返回缓存数据.

方案1:适用于存储需要检索数据的情况. 比如数据存在db中,可以用sql查询. 缺点是业务侧需要实现缓存策略,较麻烦.
方案2: 业务侧调用简单,适用场景非常广泛.

所以在网路侧支持缓存, 是一个很普遍的方案.

2.AccessToken失效后重发失败请求

这个是基于这几种前提.

App有登录功能
App登录通过 AccessToken/RefreshToken实现

简单说明 AccessToken失效后会发生什么:

  1. AccessToken失效
  2. 做网络请求,服务端会返回结果说AccessToken失效
  3. 此时网络请求是失败了
  4. 客户端利用RefreshToken 重新换AccessToken.
  5. 拿着新AccessToken 重发网络请求.
  6. 业务侧拿到正确结果

一般AccessToken失效是比较频繁的, 如果没有自动重新请求机制, 每次AccessToken失效用户都能感知到,这样体验很不好. 所以一般要在网络库/登录模块之间或者上层做一个封装解决这个问题..

3. 多级别取消网络请求

最好是能:

  1. 取消一次网络请求
  2. 某个页面退出时,能取消整个页面对应的网络请求.

资源吗,能省点就省点

4. 支持"同步/异步"请求

5. 支持选中在"异步线程/UI线程"回调

很多请求是需要需要刷UI的, 这样就不需要主动post到UI线程了.

二.为什么Retrofit是个好选择

Retrofit-Github

选开源库,有几个点很重要.

1.开源库要稳定,优先选择有人维护,用户量大的库

成熟的项目明显的坑少. 所以一个应用广泛的库是一个稳妥的选择.

Retrofit: Square出品, 2万+ star,一直在更新

2.开源库的代码结构不能太庞大,太复杂.

是代码总会有bug的, 有问题要能看明白,可以选择规避或者自行解决. 代码庞大或者逻辑复杂时,排查问题就是一个很痛苦的过程

Retrofit 代码量少,结构清晰

3.拓展性好

业务是变化的, 要在预期的业务变化内, 当前库要能cover住, 如果开发几版发现不能满足拓展的需求, 临时换库,那会带来很多工作量和bug

Retrofit 在解耦上做的很棒,拓展性高

4.开源库自身的依赖库不能太多

在这点上很重要,引入一个库如果要一并带入很多它的依赖库,会有很大的问题:
1. 会增大包的体积
2. 会让库变得不好维护,链条上的每个库都可能有问题.
3. 最大的问题是, 这些依赖库可能会和App的其他依赖库冲突. 会产生类冲突,版本冲突. 排查这些冲突是一个很痛苦的过程.(在这点上, 集团的依赖库这个问题尤为严重)

Retrofit目前依赖于Okhttp3, 考虑到OKhttp3也很流行,可以一并引入

三. Retrofit业务分析

做为一个网络库Okhttp的封装, Retrofit需要处理3部分问题:

  1. 允许业务拓展哪些环节.
  2. 这些拓展的注册,和什么情况下生效
  3. 拓展是否灵活

1.拓展性

Retrofit允许配置的是 CallAdapter,RequestBodyConverter,ResponseConvert.

CallAdapter: 负责调用OkHttpCall发起请求,处理回调分发
RequestBodyConverter: 在构建Request的时候, 构建body
ResponseConverter: 转换网络请求结果.

Retrofit发起网络请求最终走的的OKHttpCall.
网络请求的流程套路大家都一样, 都是:
"业务发起请求"->"构建Request"->"发起请求"->"解释请求"->"回调业务".
下面是他的调用流程, 蓝色部分是自定义模块.

2. 功能的注册和获取

注册

在Retrofit初始化的时候, 允许添加CallAdapterFactory和ConverterFactory.

Retrofit retrofit = new Retrofit.Builder()
    .baseUrl("http://httpbin.org")
    .addCallAdapterFactory(new ErrorHandlingCallAdapterFactory())
    .addConverterFactory(GsonConverterFactory.create())
    .build();

获取

注册和获取的流程如下.
按注册的顺序获取,只要找到了就就结束查找.

3.灵活的处理能力

每一个请求声明是一个函数, 他包含3部分信息:

  1. Return Type
  2. Method Annotation
  3. Parameter Annotation

对于CallAdapter/RequestBodyConverter/ResponseConvert可以获取到这3部分信息.然后做相应操作,过程是非常灵活.

//CallAdapter.Fatory 可以获取到
//ReturnType,Method Annotation
public abstract @Nullable CallAdapter<?, ?> get(Type returnType, Annotation[] annotations,
        Retrofit retrofit);

//Response Convert可以获取到
//Type,Method Annotation
Converter<ResponseBody, ?> responseBodyConverter(Type type, Annotation[] annotations,
        Retrofit retrofit);

//Request Convert可以获取到
//Type,Method Annotation,Parameter Annotation
Converter<?, RequestBody> requestBodyConverter(Type type,
        Annotation[] parameterAnnotations, Annotation[] methodAnnotations, Retrofit retrofit) ;

四.Retrofit技术点

1.大量泛型/反射的操作

关于Type下面这个文章讲的比较好
Retrofit完全解析(三):Type<基础详解>

对于方法

@GET("/repos/{owner}/{repo}/contributors")
Call<List<Contributor>> contributors(
            @Path("owner") String owner,
            @Path("repo") String repo);

方法有三部分信息

  1. 函数返回值
  2. 方法体上的Annotaion
  3. 参数中的Annotation

Retrofit中根据这3部分信息, 匹配CallAdapter/Converter,生成ServiceMethod, 中间用了大量的泛型解释.代码集中体现在 Utils/ServiceMethod/CallAdapter/Converter上.

用到类型示例:
-Type
-ParameterizedType
-TypeVariable
-GenericArrayType
-WildcardType
-Class.isAssignableFrom
-Class.isInterface()
-Class<?>[] getInterfaces()
-Type[] Method.getGenericParameterTypes()
-Annotation[][] Method.getParameterAnnotations()
-Method.getGenericReturnType()

2.类和参数保护

1.不能修改的类用final修饰
2.new ConcurrentHashMap<>()处理并发,取得时候加上synchronized判断
3.adapterFactories = unmodifiableList(adapterFactories); // Defensive copy at call site. 做参数保护

3.类中自定义static实例化方法

public final class GsonConverterFactory extends Converter.Factory {

 public static GsonConverterFactory create() {
    return create(new Gson());
  }
}

4.网络模拟服务MockWebServer

MockWebServer-github
com.squareup.okhttp3:mockwebserver
比较强大的网络模拟工具, 配合Okhttp用很方便

MockWebServer server = new MockWebServer();
server.start();
server.enqueue(new MockResponse().setBody("{\"name\": \"Jason\"}"));
server.enqueue(new MockResponse().setBody("<user name=\"Eximel\"/>"));

Retrofit retrofit = new Retrofit.Builder()
    .baseUrl(server.url("/"))
    .addConverterFactory(new QualifiedTypeConverterFactory(
        GsonConverterFactory.create(),
        SimpleXmlConverterFactory.create()))
    .build();
Service service = retrofit.create(Service.class);

User user1 = service.exampleJson().execute().body();

5.对Object进行Array操作

Object values;
(T) Array.get(values, i);
Array.getLength(values);

6.利用了方法上的各种信息

7.Retrofit业务流程图

转自:Retrofit分析-漂亮的解耦套路

五.设计模式

摘在:Retrofit分析-经典设计模式案例,
作者: stay4it

1.外观模式

Retrofit给我们暴露的方法和类不多。核心类就是Retrofit,我们只管配置Retrofit,然后做请求。剩下的事情就跟上层无关了,只需要等待回调。这样大大降低了系统的耦合度。对于这种写法,我们叫外观模式(门面模式)。

几乎所有优秀的开源library都有一个门面。比如Glide.with(), ImageLoader.load(), Alamofire.request()。有个门面方便记忆,学习成本低,利于推广品牌。 Retrofit的门面就是retrofit.create()

当我们自己写的代码的时候尽量也要这样来做。

比如我们有一个独立并公用的模块,需要供其他模块来调用。比如download,location,socialshare等

最好我们写一个module,将所有相关的代码都放在这个module中。这是第一步。

第二步,为你的module提供一个漂亮的门面。比如下载的DownloadManager, 经纬度的LocationTracker, 社交分享的SocialManager。它们做为功能模块的入口,要尽量的简洁,方法命名好记易理解,类上要有完整的示例注释

第三步,闭门造车。不管你在里面干什么,外面都是不知道的,就像薛定谔的那只猫,外层不调用它,永远不知道它是否好用。
不过为了以后好维护,不给他人留坑,还是尽量写的工整一些。

2.建造者模式

 Retrofit retrofit = new Retrofit.Builder()
    .baseUrl(server.url("/"))
    .addConverterFactory(new StringConverterFactory())
    .addCallAdapterFactory(RxJava2CallAdapterFactory.create())
    .build();

3.动态代理

Java静态代理和动态代理介绍

再来说动态代理。以往的动态代理和静态代理使用的场景是类似的。都想在delegate调用方法前后做一些操作。如果我的代理类有很多方法,那我得额外写很多代码,所以这时候就引入了动态代理。通过动态设置delegate,可以处理不同代理的不同方法。看不懂没关系,直接上代码:

Proxy.newProxyInstance(service.getClassLoader(), new Class<?>[] { service },
     new InvocationHandler() {
          ....
          //为方法生成ServiceMethod
          ServiceMethod<Object, Object> serviceMethod =
                (ServiceMethod<Object, Object>) loadServiceMethod(method);
            OkHttpCall<Object> okHttpCall = new OkHttpCall<>(serviceMethod, args);
            //ServiceMethod返回真正可以进行请求的CallAdapter
            return serviceMethod.callAdapter.adapt(okHttpCall);
          }
        });
  }

4.抽象工厂模式

内部Converter,CallAdapter都用了抽象工厂模式, InterfaceFactory放到了一个类中,减少类文件的数量, Factory生成对应Interface的类,明确匹配关系.

 public interface Converter<F, T> {
  T convert(F value) throws IOException;

  abstract class Factory {

    public @Nullable Converter<ResponseBody, ?> responseBodyConverter(Type type,
        Annotation[] annotations, Retrofit retrofit) {
      return null;
    }
}

5.适配器模式

如果你已经看过retrofit源码,很可能被CallAdapter玩坏。这个CallAdapter不是那么好理解。先抛开代码,我们来看看适配器模式。

Adapter简单来说,就是将一个已存在的东西转换成适合我们使用的东西。就比方说电源Adapter。出国旅游都要带转接头。比方说,RecyclerView里的Adapter是这么定义的。 Adapters provide a binding from an app-specific data set to views

再回来看看Retrofit,为什么我们需要转接头呢。那个被转换的是谁?我们看看CallAdapter的定义。Adapts a {@link Call} into the type of {@code T}. 这个CallOkHttpCall,它不能被我们直接使用吗?被转换后要去实现什么特殊的功能吗?

我们假设下。一开始,retrofit只打算在android上使用,那就通过静态代理ExecutorCallbackCall来切换线程。但是后来发现rxjava挺好用啊,这样就不需要Handler来切换线程了嘛。想要实现,那得转换一下。将OkHttpCall转换成rxjava(Scheduler)的写法。再后来又支持java8(CompletableFuture)甚至居然还有iOS支持。大概就是这样一个套路。当然我相信square的大神肯定一开始就考虑了这种情况,从而设计了CallAdapter。

适配器模式就是,已经存在的OkHttpCall,要被不同的标准,平台来调用。设计了一个接口CallAdapter,让其他平台都是做不同的实现来转换,这样不花很大的代价就能再兼容一个平台。666。

6.装饰模式

装饰模式跟静态代理很像。

每次一说装饰模式,就想成decorator,实际上叫wrapper更直观些。既然是wrapper,那就得有源的句柄,在构造wrapper时得把source作为参数传进来。wrapper了source,同样还wrapper其他功能。

代理模式,Proxy Delegate,实际上Delegate也不知道自己被代理了,Proxy伪装成Delegate来执行,既然是proxy,那proxy不应该提供delegate没有的public方法,以免被认出来。

抛开理论的描述,我们直接来看下面的代码。

你可以将ExecutorCallbackCall当作是Wrapper,而真正去执行请求的源Source是OkHttpCall。之所以要有个Wrapper类,是希望在源Source操作时去做一些额外操作。这里的操作就是线程转换,将子线程切换到主线程上去。

分析好文

Retrofit分析-漂亮的解耦套路
Retrofit分析-经典设计模式案例
Android主流网络请求开源库的对比(Android-Async-Http、Volley、OkHttp、Retrofit)
Android:手把手带你深入剖析 Retrofit 2.0 源码

时间: 2024-10-29 23:05:37

谈谈网络库和Retrofit的相关文章

网络请求框架 Retrofit 2 使用入门

本文讲的是网络请求框架 Retrofit 2 使用入门, 你将要创造什么 Retrofit 是什么? Retrofit 是一个用于 Android 和 Java 平台的类型安全的网络请求框架.Retrofit 通过将 API 抽象成 Java 接口而让我们连接到 REST web 服务变得很轻松.在这个教程里,我会向你介绍如何使用这个 Android 上最受欢迎和经常推荐的网络请求库之一. 这个强大的库可以很简单的把返回的 JSON 或者 XML 数据解析成简单 Java 对象(POJO).GE

SQL Server 2005中的客户端网络库

SQL Server中的客户端网络库可以使客户端应用程序与SQL Server系统进行连接沟通.本文为大家简 单介绍一些关于SQL Server 2005客户端网络库及其使用的知识,包括四个方面:共享内存.虚拟接口适 配器.命名管道和TCP/IP协议. 在SQL Server中,客户端网络库(Client network library)至关重要,是客户端应用程序和SQL Server系统之间连接沟通的桥梁.客户端必须使用和它需要连接的SQL Server系统相同的客户端网络库. 当客户端通过局

基于AFNetworking封装网络库

阅读原文 基于AFNetworking封装网络库 对于开发人员来说,学习网络层知识是必备的,任何一款App的开发,都需要到网络请求接口.很多朋友都还在使用原生的NSURLConnection一行一行地写,代码到处是,这样维护起来更困难了. 对于使用AFNetworking的朋友来说,很多朋友都是直接调用AFNetworking的API,这样不太好,无法做到全工程统一配置. 最好的方式就是对网络层再封装一层,全工程不允许直接使用AFNetworking的API,必须调用我们自己封装的一层,如此一来

windows ndk 编译 boost网络库

问题描述 windows ndk 编译 boost网络库 求指教,小弟,不会弄那个路径,不知道咋配置BOOST路径就指教 解决方案 参考:http://blog.csdn.net/ly131420/article/details/46648125 解决方案二: 在windows下编译boost库如何在WINDOWS下编译BOOST C++库ndk 编译 boost 库

利用百度词典API和Volley网络库开发的android词典应用

 关于百度词典API的说明,地址在这里:百度词典API介绍 关于android网络库Volley的介绍说明,地址在这里:Android网络通信库Volley 首先我们看下大体的界面布局! 再帖张最终的效果图 看到效果图,应该知道布局很简单了对吧: 布局xml文件如下: <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" xmlns:tools="http://schemas.a

我对开源C++网络库简单应用总结

网上有篇文章<开源免费的C/C++网络库(c/c++ sockets library) 七剑下天山>,看了之后觉得每个库都不错,这里我具体下载这些库看一下,简单总结一下: 顺便添加一些我找到的网络库:     (1)ACE 庞大.复杂,适合大型项目.开源.免费,不依赖第三方库,支持跨平台. http://www.cs.wustl.edu/~schmidt/ACE.html 注:除非特别需要,否则不建议:   (2)Asio Asio基于Boost开发的异步IO库,封装了Socket,简化基于s

开源免费的C/C++网络库(c/c++ sockets library)

(1)ACE 庞大.复杂,适合大型项目.开源.免费,不依赖第三方库,支持跨平台. http://www.cs.wustl.edu/~schmidt/ACE.html   (2)Asio Asio基于Boost开发的异步IO库,封装了Socket,简化基于socket程序的开发. 开源.免费,支持跨平台. http://think-async.com/   (3)POCO POCO C++ Libraries 提供一套 C++ 的类库用以开发基于网络的可移植的应用程序,功能涉及线程.线程同步.文件

开源免费的C/C++网络库(c/c++ sockets library) 七剑下天山

(1)ACE 庞大.复杂,适合大型项目.开源.免费,不依赖第三方库,支持跨平台. http://www.cs.wustl.edu/~schmidt/ACE.html   (2)Asio Asio基于Boost开发的异步IO库,封装了Socket,简化基于socket程序的开发. 开源.免费,支持跨平台. http://think-async.com/   (3)POCO POCO C++ Libraries 提供一套 C++ 的类库用以开发基于网络的可移植的应用程序,功能涉及线程.线程同步.文件

大数据-一个程序中,TCP协议用的muduo网络库,UDP协议可以用boos.asio吗?

问题描述 一个程序中,TCP协议用的muduo网络库,UDP协议可以用boos.asio吗? 通过TCP协议接收数据,解析好,在用UDP协议转发. UDP转发是后面增加的,muduo网路库不支持Udp协议,自己用socket api写,担心大数据,多并发的时候不可靠.请问大神有什么建议? 解决方案 这个当然可以,只要协议格式客户端,服务端之间处理好. 解决方案二: udp确实不可靠,要解决可以自己实现一套超时和重发机制,比如说每个数据包打上标号,发送方和接收方处理好重发,如果对数据质量要求高的话