ARouter系列三:依赖注入暴露服务

2020-06-15  本文已影响0人  一个追寻者的故事

如果对于 ARouter 不是很了解的,建议先行阅读:
ARouter系列一:Activity跳转原理详解
ARouter系列二:@Autowired属性注入

想要提供服务暴露给其他人使用,ARouter提供了一个接口:IProvider

// Provider interface, base of other interface.
public interface IProvider {
    /**
     * Do your init work in this method, it well be call when processor has been load.
     *
     * @param context ctx
     */
    void init(Context context);
}

IProvider 只有一个方法 init, 参数为 Context。刚看到这接口的时候不是很明白,等把本篇文章看完之后就会明白,参数Context不可或缺。注意IProvider的注释:IProvider是其它 Interface 的基础。可见ARouter推荐的用法是 一个Interface 继承 IProvider。

这里大家可能会有疑问,为什么需要Context参数,为什么推荐是一个接口 继承 IProvider,而不是实体类。带着这些疑问,我们继续探寻

一、使用

新建一个项目,有两个moudle:applocationlocation中封装了地图相关服务,例如:开始定位,获取位置等等。 app 依赖 location

1.1 location模块

LocationService 定义此模块提供的基础服务:开始定位 和 获取地理位置。并且实现了 上述的 IProvider

package com.daddyno1.location;
public interface LocationService extends IProvider {
    //开始定位
    void startLocate();
    //获取经纬度信息
    Point getLocation();
}

BaiduLocationService 是提供服务的最终实现类。此处模拟使用了百度来实现具体功能。并且使用了 @Route(path = "/Loc/LocationService") 来标注真实 Location 服务实现类。

@Route(path = "/Loc/LocationService")
public class BaiduLocationService implements LocationService {

    private static final String TAG = "BaiduLocationService";

    @Override
    public void startLocate() {
        Log.i(TAG, "BaiduLocationService - startLocate");
    }

    @Override
    public Point getLocation() {
        return new Point(11,12);
    }

    @Override
    public void init(Context context) {
        Log.i(TAG, "BaiduLocationService - init");
    }
}

编译一下,我们看一下 apt 帮我们生成了哪些 辅助类
ARouter$$Root$$locationARouter$$Group$$LocARouter$$Providers$$locationARouter系列一:Activity跳转原理详解 的不难理解,ARouter$$Root$$location存储了location module 下所有路由组信息;ARouter$$Group$$Loc 存储了 location module 下 路由组名为 Loc 的路由表信息。

package com.alibaba.android.arouter.routes;
...
/**
 * DO NOT EDIT THIS FILE!!! IT WAS GENERATED BY AROUTER. */
public class ARouter$$Root$$location implements IRouteRoot {
  @Override
  public void loadInto(Map<String, Class<? extends IRouteGroup>> routes) {
    routes.put("Loc", ARouter$$Group$$Loc.class);
  }
}
package com.alibaba.android.arouter.routes;
...
/**
 * DO NOT EDIT THIS FILE!!! IT WAS GENERATED BY AROUTER. */
public class ARouter$$Group$$Loc implements IRouteGroup {
  @Override
  public void loadInto(Map<String, RouteMeta> atlas) {
    atlas.put("/Loc/LocationService", RouteMeta.build(RouteType.PROVIDER, BaiduLocationService.class, "/loc/locationservice", "loc", null, -1, -2147483648));
  }
}

ARouter$$Providers$$location 这个类长什么样?我们来看一下:

package com.alibaba.android.arouter.routes;
...
/**
 * DO NOT EDIT THIS FILE!!! IT WAS GENERATED BY AROUTER. */
public class ARouter$$Providers$$location implements IProviderGroup {
  @Override
  public void loadInto(Map<String, RouteMeta> providers) {
    providers.put("com.daddyno1.location.LocationService", RouteMeta.build(RouteType.PROVIDER, BaiduLocationService.class, "/Loc/LocationService", "Loc", null, -1, -2147483648));
  }
}

ARouter$$Providers$$location 这个类有什么用呢,我们先往后看,一会再说。

1.2 app模块

这里新建一个 Activity 使用我们创建好的 Location 服务

public class SecondActivity extends AppCompatActivity {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main3);

        // 使用一:by name
        LocationService locationService = (LocationService) ARouter.getInstance().build("/Loc/LocationService").navigation();
        locationService.startLocate();

        //使用二: by type
        LocationService locationService1 = ARouter.getInstance().navigation(LocationService.class);
        locationService1.startLocate();
    }
}

我们运行一下,看一下结果:

I: BaiduLocationService - init
I: BaiduLocationService - startLocate
I: BaiduLocationService - startLocate

注意: init 执行了一次, startLocate 调用了两次。

二、源码分析

2.1 init

之前在分析Activity跳转的时候分析了ARouter的初始化,这里不再细讲。

public synchronized static void init(Context context, ThreadPoolExecutor tpe) throws HandlerException {
 ...
 for (String className : routerMap) {
     if (className.startsWith(ROUTE_ROOT_PAKCAGE + DOT + SDK_NAME + SEPARATOR + SUFFIX_ROOT)) {
     //com.alibaba.android.arouter.routes.ARouter$$Root
    // This one of root elements, load root.
     ((IRouteRoot) (Class.forName(className).getConstructor().newInstance())).loadInto(Warehouse.groupsIndex);
    } else if (className.startsWith(ROUTE_ROOT_PAKCAGE + DOT + SDK_NAME + SEPARATOR + SUFFIX_INTERCEPTORS)) {
     //com.alibaba.android.arouter.routes.ARouter$$Interceptors
     // Load interceptorMeta
      ((IInterceptorGroup) (Class.forName(className).getConstructor().newInstance())).loadInto(Warehouse.interceptorsIndex);
    } else if (className.startsWith(ROUTE_ROOT_PAKCAGE + DOT + SDK_NAME + SEPARATOR + SUFFIX_PROVIDERS)) {
     //com.alibaba.android.arouter.routes.ARouter$$Providers
     // Load providerIndex
    ((IProviderGroup) (Class.forName(className).getConstructor().newInstance())).loadInto(Warehouse.providersIndex);
     }
  }
  ...
}

唯一需要提一下的是,经过路由器初始化之后,Warehouse的数据如下:

ARouter$$Providers$$location 这个是之前提到的apt生成的辅助类,它的作用就是帮助路由在初始化的时候,把相关数据注入到 Warehouse.providersIndex,这个有什么用呢,其实对于by name的使用方式来说,Warehouse.providersIndexARouter$$Providers$$location 根本没用上,只是 by type 时候的辅助类。

2.2 by name
LocationService locationService = (LocationService) ARouter.getInstance().build("/Loc/LocationService").navigation();
2.3 by type
LocationService locationService1 = ARouter.getInstance().navigation(LocationService.class);
2.4 小结

具体的实现逻辑和 Activity 路由过程很相似,自己去看代码吧。唯一的区别是,如果RouteType是 PROVIDER 的话,直接根据反射创建一个路由Destination 类的实例,存到Postcard里,最后返回给用户。

本例中ARouter会使用反射创建一个BaiduLocationService 的实体对象,回调init方法,返回给使用者,之后把 实体对象缓存到 Warehouse.providers(Map<Class, IProvider>),下次直接在使用的话,直接从缓存获取,不会再反射创建了。这也是本例为什么 init 只执行了一次。

三、总结

1、为什么IProvider要提供一个Context?
我们知道ARouter是帮助我们实现项目组件化的工具,很多情况下一个Moudle是拿不到应用程序Context的,本例中的场景就是。但很多服务的实现又会依赖于Context,所以有必要把Context传递给各个Moudle。

2、为什么推荐 Interface 集成 IPriovider?
ARouter说 通过依赖注入暴露服务。本例中抽象了一个 LocationService 接口,此接口抽象了所有用到的服务,用户通过ARouter可以拿到 LocationService 的具体实现类,然后强转成 LocationService 使用,可以不用关心具体的实现类是谁。这就是通过依赖注入的方式 实现 控制翻转,从而实现使用者 和 具体实现解耦的目的。假如某一天又想时候用 高德SDK 实现具体的 Location 服务,使用者的代码不用修改,实现完全的解耦。使用 高德 实现 Location 服务:

package com.daddyno1.location;
...
@Route(path = "/Loc/LocationService")
public class GaodeLocationService implements LocationService {

    private static final String TAG = "GaodeLocationService";

    @Override
    public void startLocate() {
        Log.i(TAG, " GaodeLocationService - startLocate");
    }

    @Override
    public Point getLocation() {
        return new Point(1,2);
    }

    @Override
    public void init(Context context) {
        Log.i(TAG, " GaodeLocationService - init");
    }
}
上一篇下一篇

猜你喜欢

热点阅读