今天我们接着来学习下阿里今年开源的路由框架ARouter,这个也是我们这个解析系列内容的最后一篇了,后面还会一片总结的分享。今天分享下ARouter的降级策略。
那么降级策略是个什么鬼?使用系统自带的StartActivity()启动后就无法插手其中任何环节了,只能交给系统管理,这就导致了在跳转失败的情况下无法降级,而是会直接抛出运营级的异常,甚至导致崩溃,这个给用户的感觉就不是很好。ARouter的降级策略就允许我们在自定义降级服务,在跳转失败的时候可以自行处理,比如可以加载H5页面来处理这种错误情况。今天的内容不多,源码涉及到的内容也很少,比较轻松愉快,主要是学习下这种新的错误处理思想。
今天内容分成下面两部分:
1.降级策略的实现方式
2.降级策略的源码分析
惯例,先看下降级策略的Demo,有个直观的感受:
好了,大家准备好开始我们今天的降级策略之旅~~~
1.降级策略的实现方式
ARouter提供的降级策略主要有两种方式,一种是通过回调的方式;一种是提供服务接口的方式。我们分别来看看两种方式的使用方法:
一.单独降级-回调的方式
这种方式在跳转失败的时候会回调NavCallback接口的onLost方法,对于这个接口有没有很熟悉的感觉?就是上篇分享的拦截器的接口。
ARouter.getInstance().build("/xxx/xxx").navigation(this, new NavCallback() {
@Override
public void onFound(Postcard postcard) {
Log.d("ARouter", "找到了");
}
@Override
public void onLost(Postcard postcard) {
Log.d("ARouter", "找不到了");
}
@Override
public void onArrival(Postcard postcard) {
Log.d("ARouter", "跳转完了");
}
@Override
public void onInterrupt(Postcard postcard) {
Log.d("ARouter", "被拦截了");
}
});
回调接口,对于降级策略主要实现感兴趣的onLost方法即可。
public interface NavigationCallback {
/**
* Callback when find the destination.
*
* @param postcard meta
*/
void onFound(Postcard postcard);
/**
* Callback after lose your way.
*
* @param postcard meta
*/
void onLost(Postcard postcard);
/**
* Callback after navigation.
*
* @param postcard meta
*/
void onArrival(Postcard postcard);
/**
* Callback on interrupt.
*
* @param postcard meta
*/
void onInterrupt(Postcard postcard);
}
接着再来看看第二种降级策略
二.全局降级-服务接口的方式:
先看看怎么用,有木有惊呆了?这种方式很简单,主要处理逻辑在内部,暴露的接口很友好。
ARouter.getInstance().build("/xxx/xxx").navigation();
这种降级策略主要是实现服务接口DegradeService,就一个方法就是o nLost,和上面的类似。
public interface DegradeService extends IProvider {
/**
* Router has lost.
*
* @param postcard meta
*/
void onLost(Context context, Postcard postcard);
}
降级策略主要是这两种实现方式,比较简单,各有千秋,可以结合自己的需求进行使用,不过需要注意一点,不能两种同时使用,单独降级的方式优先于全局降级,也就是如果同时使用两种方式,调用完单独降级策略后就不会再调用全局降级。
接下来我们看看源码就知道为什么了。
2.降级策略的源码分析
跳转逻辑还是主要在_ARouter中,我们看下navigation方法,方法我进行了截取和降级策略相关的代码。LogisticsCenter.completion(postcard)主要是根据路径寻找目标,这个我们后面再看,如果目标没有找到,就进入catch,看下catch里面的逻辑,如果回调接口不为空,就调用回调接口的onLost方法。如果没有提供回调接口就会加载降级服务DegradeService的实例,加载成功就调用服务的onLost方法,结果加载失败,那就是降级失败,跳转失败。
protected Object navigation(final Context context, final Postcard postcard, final int requestCode, final NavigationCallback callback) {
try {
LogisticsCenter.completion(postcard);
} catch (NoRouteFoundException ex) {
if (null != callback) {
callback.onLost(postcard);
} else { // No callback for this invoke, then we use the global degrade service.
DegradeService degradeService = ARouter.getInstance().navigation(DegradeService.class);
if (null != degradeService) {
degradeService.onLost(context, postcard);
}
}
return null;
}
}
其实到这里降级策略的逻辑就结束了,幸福是不是来的太突然???是的,逻辑不复杂,提供了很好的扩展。我们再看看LogisticsCenter.completion这个老朋友了,这个是与编译期间生成的映射文件直接打交道的模块。
先在加载到内存的节点仓库中查找是否有该目标节点的存在,没有就到组仓库中找,找不到就报错NoRouteFoundException,这就到了我们上面的逻辑中。
public synchronized static void completion(Postcard postcard) {
if (null == postcard) {
throw new NoRouteFoundException(TAG + "No postcard!");
}
RouteMeta routeMeta = Warehouse.routes.get(postcard.getPath());
if (null == routeMeta) { // Maybe its does't exist, or didn't load.
Class<? extends IRouteGroup> groupMeta = Warehouse.groupsIndex.get(postcard.getGroup()); // Load route meta.
if (null == groupMeta) {
throw new NoRouteFoundException(TAG + "There is no route match the path [" + postcard.getPath() + "], in group [" + postcard.getGroup() + "]");
}
}
}
我们看看节点Warehouse.routes和 Warehouse.groupsIndex组仓库是不是都找不到,肯定都找不到xxx的节点和组别。
降级的策略就是以上,轻松愉快~~~
3.总结
这个也是ARouter目前框架分析的最后一篇分享了,降级策略,内容比较简单,但是思想很值得借鉴,设计思路也是很常用的方法,回调接口和服务接口。由于很多内容前面已经反复分享过了,所以没有重头分析跳转的整个流程,有需要的小伙伴可以自行参考前面的分享。
ARouter这个框架阿里还在维护,后面有更新我们再看看是否出新的分享,目前内容就这样了,后面还会再出最后一个简单的总结分享,欢迎关注哦。
欢迎关注公众号:JueCode