【开发 12 年码农教你】Android 端简单易用的 SPI 框架 -,写给程序员的 Flutter 详细教程
最后是 Main 模块, 下面的逻辑也可以存在于是 A,B,C 模块中
IPrinterService printer = Spa.getService(IPrinterService.class); //取最高优先级 printer.print(); // 输出: this is c printer service.
APrinterService aprinter = Spa.getFixedService(APrinterService.class);aprinter.print();// 输出: this is a printer service.
BPrinterService bPrinter = Spa.getFixedService(BPrinterService.class);bPrinter.print();// 输出: this is b printer service.
// 和上面的 Spa.getFixedService(BPrinterService.class)等价 IPrinterService pathPrinter = Spa.getService("b_printer"); //是不是有路由的感觉 pathPrinter.print(); // 输出: this is b printer service.
复制代码
这就是 SPA 最基本的用法,到目前为止他已经有了 SPI 机制的能力了,是不是很简单!!! 难道 SPA 只有这点内容吗, 当然不是!
SPA 创建的对象的生命周期是怎样的?
对于上面的示例大家有没有一个疑问, bPrinter 和 pathPrinter 都是实现类 BPrinterService 对象,那么这两个对象相等吗, bPrinter == pathPrinter?
下面介绍一下 @Service 注解的 scope 属性
scope 定义一个对象的生命周期,SPA 内置的 scope 有
normal, 普通对象,每次都返回一个新创建对象, 默认 scope
global, 全局对象,可以看做是一个单例,每次返回的都是同一个对象, 对象将在第一次被使用时创建
weak, 对象使用弱引用缓存,如果没有被 gc 回收,则不会重新创建
soft, 对象使用软引用缓存,如果没有被 gc 回收,则不会重新创建
custom, 自定义缓存策略, 当 scope 不是上面列出的值时,会被认为是自定义缓存策略,自定义缓存策略将在 Spa 进阶篇中介绍
那么 bPrinter 和 pathPrinter 相等吗? 答案就显而易见了,因为 SPA 对象默认的生命周期是 nornal,也就是每次都会创建一个新对象,所以 bPrinter != pathPrinter。 如果想要 bPrinter == pathPrinter, 只需要将 BPrinterService 的 scope 定义为 global!
@Service(path="b_printer", priority = 2, scope=Spa.Scope.GLOBAL) //scope 设置为 globalpublic class BPrinterService implements IPrinterService {@Overridepublic void print() {System.out.println("this is b printer service.");}}复制代码
SPA 的方法拦截能力
SPA 并不是简单的创建并返回一个对象,SPA 实际返回的是目标对象的代理,通过代理,对象执行方法时,我们就能对该对象实施拦截,
SPA 有灵活的拦截能力,不仅仅可以设置拦截器,还可以设置拦截策略
自定义拦截器,多个拦截器默认按优先级顺序依次执行拦截
自定义拦截策略,多个拦截器时,这些拦截器的执行顺序、执行方式由拦截策略决定
自定义拦截策略放到后面进阶篇,这里先说一下拦截器的用法,我们先看一下 SPA 执行方法的流程图,流程图演示的是上一节示例的 CPrinterService 的 print 方法调用过程
拦截器代码中是如何使用的?
实现 IServiceInterceptor 接口并被 @Service 标记的类会被 SPA 认为是一个方法调用拦截器
先定义一个高优先级的拦截器
@Service(priority = Spa.Priority.MAX)public class MaxPriorityServiceInterceptor implements IServiceInterceptor {@Overridepublic void intercept(Class<? extends IService> originClass, IService source, Method method, Object[] args, IServiceInterceptorCallback callback) {System.out.println("this is a max priority interceptor.")callback.onContinue(method, args);
}}复制代码
再定义一个普通优先级的拦截器
@Servicepublic class NormalServiceInterceptor implements IServiceInterceptor {
@Overridepublic void intercept(Class<? extends IService> originClass, IService source, Method method, Object[] args, IServiceInterceptorCallback callback) {System.out.println("this is a normal priority interceptor.")callback.onContinue(method, args);}}复制代码
再定义一个低优先级的拦截器
@Service(priority = Spa.Priority.MIN)public class MinPriorityServiceInterceptor implements IServiceInterceptor {@Overridepublic void intercept(Class<? extends IService> originClass, IService source, Method method, Object[] args, IServiceInterceptorCallback callback) {System.out.println("this is a min priority interceptor.")if ("chao.sample.c.CPrinterService".equalse(originClass.getName()) && "print".equals(method.getName())) { // 当拦截的是 CPrinterService 的 print 方法时,拦截!callback.onInterrupt(null); //如果方法有返回值,null 可以替换为拦截的值} else {callback.onContinue(method, args);}}}
执行 print 方法
IPrinterService printService = Spa.getService(IPrinterService.class); //cPrinterprintService.print();
最后看输出结果
this is a max priority interceptor.this is a normal priority interceptor.this is a min priority interceptor.
this is c printer service. cPrinter 的 print 被拦截,没有被执行,所以不会有这条输出
再看下整个流程的时序图
SPA 应用实战 1 —— 子模块如何获取主模块的 BuildConfig 信息
多模块开发/组件化开发过程中,主模块(plugin 为 com.android.application 的模块,一般指 app 模块)可以依赖任何模块,但是子模块无法依赖主模块,如果子模块想拿主模块的内容要怎么办呢? 下面演示如何通过 Spa 来获取主模块的 Context 和 BuildConfig 中的内容。 先在接口层定义一个 BuildService
BuildService.java
public interface BuildService extends IService {String buglyId(); // build.gradle 中使用 buildConfigField 定义的 buglyId
boolean debuggable();
String versionName();
int versionCode();
String applicationId();
String buildType();}
在 app 模块中,实现这个 service 接口并使用 @Service 标记
BuildServiceImpl.java
@Service(scope = Spa.Scope.GLOBAL) //Global 可以看做是单例 public class BuildServiceImpl implements BuildService {@Overridepublic String buglyId() {return BuildConfig.BUGLY_ID;}
@Overridepublic boolean debuggable() {return BuildConfig.DEBUG;}
@Overridepublic String versionName() {return BuildConfig.VERSION_NAME;}
@Overridepublic int versionCode() {return BuildConfig.VERSION_CODE;}
@Overridepublic String applicationId() {return BuildConfig.APPLICATION_ID;}
@Overridepublic String buildType() {return BuildConfig.BUILD_TYPE;}}
准备工作已经完成,现在我们在 pages 模块的 BuildInfoActivity 中应用它
BuildInfoActivity.java
public class BuildInfoActivity extends AppCompatActivity
{
@Overrideprotected void onCreate(@Nullable Bundle savedInstanceState) {super.onCreate(savedInstanceState);BuildInfoPageBinding viewBinding = BuildInfoPageBinding.inflate(LayoutInflater.from(this));setContentView(viewBinding.getRoot());
BuildService buildService = Spa.getService(BuildService.class);viewBinding.applicationId.setText("applicationId: " + buildService.applicationId());viewBinding.versionName.setText("versionName: " + buildService.versionName());viewBinding.versionCode.setText("versionCode: " + buildService.versionCode() + "");viewBinding.buildType.setText("buildType: " + buildService.buildType());viewBinding.debuggable.setText("debuggable: " + buildService.debuggable());viewBinding.buglyId.setText("buglyId:" + buildService.buglyId());}}}
评论