您现在的位置是：首页 > 移动开发

当前栏目

Android开源框架：Retrofit

Android 开源框架 Retrofit

2023-09-11 14:16:44 时间

1 简述

A type-safe HTTP client for Android and Java.
Retrofit 是基于RESTful风格的 HTTP 网络请求框架的封装。它的底层仍然基于OkHttp实现，算是OkHttp在Android上使用的改良。

// 这是一个例子
Retrofit retrofit = new Retrofit.Builder()
    .baseUrl("https://api.github.com/")
    .addConverterFactory(GsonConverterFactory.create())
    .build();

GitHubService service = retrofit.create(GitHubService.class);
Call<List<Repo>> repos = service.listRepos("halloayu");

repos.enqueue(new Callback<List<Repo>>() {
    @Override
    public void onResponse(Call<List<Repo>> call, Response<List<Repo>> response) {
        Log.e("Main", response.body().get(0).toString());
    }
    
    @Override
    public void onFailure(Call<List<Repo>> call, Throwable t) {
    }
});

2 为什么会有Retrofit框架

OkHttp是安卓官方认证的网络请求框架，非常强大，但是它也有不少缺点，如下。

OkHtt配置网络请求是非常繁琐的，尤其是配置复杂网络请求body、请求头、参数的时候。
数据解析过程需要用户手动拿到ResponseBody进行解析，难以复用。
无法自动进行线程切换。
万一我们存在嵌套网络请求，就会陷入“回调地狱”。

所以为了解决这些缺点，让网络请求在Android开发上易用，诞生了Retrofit框架，它本质上就也就是在OkHttp上套了层“壳子”，里面的请求还是基于OkHttp实现。
同时Retrofit设计的目的有两个方面。

请求前
- 可以统一配置网络请求头
- 可以很方便得复用Request，或创建request
请求后
- 子线程需切换到UI线程，便于界面刷新
- 返回数据可以解析为Java Bean，方便使用

3 主要封装的点

retrofit封装OkHttp主要是以下几点：

build模式创建网络请求基本配置
用注解类组合HTTP网络请求
提供Gson解析返回的json数据
Executor完成线程切换

它请求实现的核心在于“注解”、“动态代理”、“反射”。

4 注解

Http有8种网络请求：GET、POST、PUT、DELETE、PATCH、HEAD、OPTIONS、HTTP

Retrofit通过20多个注解的组合实现了这几种请求。企业微信截图_bbd04297-5bd9-4f56-910b-8d60d495ecb3.png

5 动态代理

熟悉设计模式的都知道，代理模式的思想是通过一个“代理商”，让”用户“通过它处理难以处理的”事情“。
在最上面Retrofit的使用例子中，先是通过建造者模式创建了一个retrofit实例，然后走GitHubService service = retrofit.create(GitHubService.class)，这里面就是一个动态代码，我们来具体看看做了什么。

public <T> T create(final Class<T> service) {
    // 验证接口
    validateServiceInterface(service);
    // 动态代理
    return (T)
        Proxy.newProxyInstance(
        service.getClassLoader(),
        new Class<?>[] {service},
        new InvocationHandler() {
            private final Platform platform = Platform.get();
            private final Object[] emptyArgs = new Object[0];
            
            @Override
            public @Nullable Object invoke(Object proxy, Method method, @Nullable Object[] args)
                throws Throwable {
                // If the method is a method from Object then defer to normal invocation.
                if (method.getDeclaringClass() == Object.class) {
                    return method.invoke(this, args);
                }
                args = args != null ? args : emptyArgs;
                return platform.isDefaultMethod(method)
                    ? platform.invokeDefaultMethod(method, service, proxy, args)
                    : loadServiceMethod(method).invoke(args);
            }
        });
}

从代码中我们可以看出，它代理了传入接口类中的所有接口方法，当我们调，service.listRepos("halloayu")，就会走InvocationHandler中的invoke方法。

// 从缓存中拿，没拿到，ServiceMethod进行处理
ServiceMethod<?> loadServiceMethod(Method method) {
    ServiceMethod<?> result = serviceMethodCache.get(method);
    if (result != null) return result;
    
    synchronized (serviceMethodCache) {
        result = serviceMethodCache.get(method);
        if (result == null) {
            result = ServiceMethod.parseAnnotations(this, method);
            serviceMethodCache.put(method, result);
        }
    }
    return result;
}

ServiceMethod就像是一个中央处理器，传入Retrofit对象和Method对象，调用各个接口和解析器，最终生成一个Request，包含api 的域名、path、http请求方法、请求头、是否有body、是否是multipart等等。最后返回一个Call对象，Call接口的默认实现是OkHttpCall，它默认使用OkHttp3作为底层http请求client。

@Override
final @Nullable ReturnT invoke(Object[] args) {
    Call<ResponseT> call = new OkHttpCall<>(requestFactory, args, callFactory, responseConverter);
    // 使用适配器去转换返回数据
    return adapt(call, args);
}

使用Java动态代理的目的就要拦截被调用的Java方法，然后解析这个Java方法的注解，最后生成Request由OkHttp发送。

// 异步请求源码
@Override
public void enqueue(final Callback<T> callback) {
    Objects.requireNonNull(callback, "callback == null");
    
    ...
    
    call.enqueue(
        new okhttp3.Callback() {
            @Override
            public void onResponse(okhttp3.Call call, okhttp3.Response rawResponse) {
                Response<T> response;
                try {
                    // 解析返回数据，里面用我们配置的GSON解析
                    response = parseResponse(rawResponse);
                } catch (Throwable e) {
                    throwIfFatal(e);
                    callFailure(e);
                    return;
                }
                
                try {
                    // 先走我们定义适配器转换数据，然后走自定义callback
                    callback.onResponse(OkHttpCall.this, response);
                } catch (Throwable t) {
                    throwIfFatal(t);
                    t.printStackTrace(); // TODO this is not great
                }
            }
            
            @Override
            public void onFailure(okhttp3.Call call, IOException e) {
                callFailure(e);
            }
            
            private void callFailure(Throwable e) {
                try {
                    callback.onFailure(OkHttpCall.this, e);
                } catch (Throwable t) {
                    throwIfFatal(t);
                    t.printStackTrace(); // TODO this is not great
                }
            }
        });
}

6 线程切换

Retrofit实现子线程到主线程的切换也是基于Handler。

static final class Android extends Platform {
    Android() {
        super(Build.VERSION.SDK_INT >= 24);
    }
    
    @Override
    public Executor defaultCallbackExecutor() {
        return new MainThreadExecutor();
    }
    
    @Nullable
    @Override
    Object invokeDefaultMethod(
        Method method, Class<?> declaringClass, Object object, Object... args) throws Throwable {
        if (Build.VERSION.SDK_INT < 26) {
            throw new UnsupportedOperationException(
                "Calling default methods on API 24 and 25 is not supported");
        }
        return super.invokeDefaultMethod(method, declaringClass, object, args);
    }
    
    static final class MainThreadExecutor implements Executor {
        // Handler
        private final Handler handler = new Handler(Looper.getMainLooper());
        
        @Override
        public void execute(Runnable r) {
            handler.post(r);
        }
    }
  }

请求后，先走默认的线程切换适配器DefaultCallAdapterFactory，然后走自定义的callback。

@Override
public void enqueue(final Callback<T> callback) {
    Objects.requireNonNull(callback, "callback == null");
    
    // 切换线程
    delegate.enqueue(
        new Callback<T>() {
            @Override
            public void onResponse(Call<T> call, final Response<T> response) {
                callbackExecutor.execute(
                    () -> {
                        if (delegate.isCanceled()) {
                            // Emulate OkHttp's behavior of throwing/delivering an IOException on
                            // cancellation.
                            callback.onFailure(ExecutorCallbackCall.this, new IOException("Canceled"));
                        } else {
                            callback.onResponse(ExecutorCallbackCall.this, response);
                        }
                    });
            }
            
            @Override
            public void onFailure(Call<T> call, final Throwable t) {
                callbackExecutor.execute(() -> callback.onFailure(ExecutorCallbackCall.this, t));
            }
        });
}

7 总结

Retrofit的源码十分优秀，用注解的形式组合HTTP请求，通过代理接口，处理请求的逻辑，最后再执行请求。里面也大量使用反射，工厂方法，抽象接口来实现低耦合和高扩展，非常值得一读的开源框架！

文末

如果要想成为Android架构师，那就不要局限在编码，业务，要会选型、扩展，提升编程思维。此外，良好的职业规划也很重要，学习的习惯很重要，但是最重要的还是要能持之以恒，任何不能坚持落实的计划都是空谈。

如果你没有方向，这里给大家分享一套由阿里高级架构师编写的《Android八大模块进阶笔记》，帮大家将杂乱、零散、碎片化的知识进行体系化的整理，让大家系统而高效地掌握Android开发的各个知识点。
在这里插入图片描述
相对于我们平时看的碎片化内容，这份笔记的知识点更系统化，更容易理解和记忆，是严格按照知识体系编排的。

一、架构师筑基必备技能

1、深入理解Java泛型
2、注解深入浅出
3、并发编程
4、数据传输与序列化
5、Java虚拟机原理
6、高效IO
……

在这里插入图片描述

二、Android百大框架源码解析

1.Retrofit 2.0源码解析
2.Okhttp3源码解析
3.ButterKnife源码解析
4.MPAndroidChart 源码解析
5.Glide源码解析
6.Leakcanary 源码解析
7.Universal-lmage-Loader源码解析
8.EventBus 3.0源码解析
9.zxing源码分析
10.Picasso源码解析
11.LottieAndroid使用详解及源码解析
12.Fresco 源码分析——图片加载流程

在这里插入图片描述

三、Android性能优化实战解析

腾讯Bugly:对字符串匹配算法的一点理解
爱奇艺：安卓APP崩溃捕获方案——xCrash
字节跳动：深入理解Gradle框架之一：Plugin, Extension, buildSrc
百度APP技术：Android H5首屏优化实践
支付宝客户端架构解析：Android 客户端启动速度优化之「垃圾回收」
携程：从智行 Android 项目看组件化架构实践
网易新闻构建优化：如何让你的构建速度“势如闪电”？
…

在这里插入图片描述

四、高级kotlin强化实战

1、Kotlin入门教程
2、Kotlin 实战避坑指南
3、项目实战《Kotlin Jetpack 实战》

从一个膜拜大神的 Demo 开始
Kotlin 写 Gradle 脚本是一种什么体验？
Kotlin 编程的三重境界
Kotlin 高阶函数
Kotlin 泛型
Kotlin 扩展
Kotlin 委托
协程“不为人知”的调试技巧
图解协程：suspend

在这里插入图片描述

五、Android高级UI开源框架进阶解密

1.SmartRefreshLayout的使用
2.Android之PullToRefresh控件源码解析
3.Android-PullToRefresh下拉刷新库基本用法
4.LoadSir-高效易用的加载反馈页管理框架
5.Android通用LoadingView加载框架详解
6.MPAndroidChart实现LineChart（折线图）
7.hellocharts-android使用指南
8.SmartTable使用指南
9.开源项目android-uitableview介绍
10.ExcelPanel 使用指南
11.Android开源项目SlidingMenu深切解析
12.MaterialDrawer使用指南
在这里插入图片描述

六、NDK模块开发

1、NDK 模块开发
2、JNI 模块
3、Native 开发工具
4、Linux 编程
5、底层图片处理
6、音视频开发
7、机器学习

在这里插入图片描述

七、Flutter技术进阶

1、Flutter跨平台开发概述
2、Windows中Flutter开发环境搭建
3、编写你的第一个Flutter APP
4、Flutter开发环境搭建和调试
5、Dart语法篇之基础语法(一)
6、Dart语法篇之集合的使用与源码解析(二)
7、Dart语法篇之集合操作符函数与源码分析(三)
…
在这里插入图片描述

八、微信小程序开发

1、小程序概述及入门
2、小程序UI开发
3、API操作
4、购物商场项目实战……

在这里插入图片描述

全套视频资料：

一、面试合集
在这里插入图片描述
二、源码解析合集

在这里插入图片描述
三、开源框架合集

在这里插入图片描述
欢迎大家一键三连支持，若需要文中资料，直接点击文末CSDN官方认证微信卡片免费领取【保证100%免费】↓↓↓

猜你喜欢

Win7下Powershell 由2.0 升级为 5.1
linux例行性工作 crontab详解
泰克 Tektronix THS720A 示波器显示屏维修记录
IPK僵尸网络看看其传播手法
Java实现蓝桥杯算法提高VIP Substrings（暴力）
Centos8.4 二进制安装配置Mysql5.7.34
恶意代码分析实战 IDA 分析windows恶意程序 lab 7-1 7-2
在OpenCV里车牌识别的方法2
markdown流程图语法
基于粒子群优化的BP神经网络（预测应用） - 附代码
Android 11.0 禁用导航栏Recent键(任务键)

相关主题

android ndk

zl程序教程

当前栏目

Android开源框架：Retrofit

1 简述

2 为什么会有Retrofit框架

3 主要封装的点

4 注解

5 动态代理

6 线程切换

7 总结

文末

一、架构师筑基必备技能

二、Android百大框架源码解析

三、Android性能优化实战解析

四、高级kotlin强化实战

五、Android高级UI开源框架进阶解密

六、NDK模块开发

七、Flutter技术进阶

八、微信小程序开发

全套视频资料：

相关文章