今天我们接着来学习下阿里今年开源的路由框架ARouter,这个也是我们这个解析系列内容的最后一篇了,后面还会一片总结的分享。今天分享下ARouter的降级策略。
那么降级策略是个什么鬼?使用系统自带的StartActivity()启动后就无法插手其中任何环节了,只能交给系统管理,这就导致了在跳转失败的情况下无法降级,而是会直接抛出运营级的异常,甚至导致崩溃,这个给用户的感觉就不是很好。ARouter的降级策略就允许我们在自定义降级服务,在跳转失败的时候可以自行处理,比如可以加载H5页面来处理这种错误情况。今天的内容不多,源码涉及到的内容也很少,比较轻松愉快,主要是学习下这种新的错误处理思想。
今天内容分成下面两部分:
1.降级策略的实现方式
2.降级策略的源码分析
惯例,先看下降级策略的Demo,有个直观的感受:
降级策略.png 降级成功.png好了,大家准备好开始我们今天的降级策略之旅~~~
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.降级策略的源码分析
protected Object navigation(final Context context, final Postcard postcard, final int requestCode, final NavigationCallback callback) {
try {
} 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;
}
}
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的节点和组别。
节点和组仓库.png降级的策略就是以上,轻松愉快~~~
3.总结
这个也是ARouter目前框架分析的最后一篇分享了,降级策略,内容比较简单,但是思想很值得借鉴,设计思路也是很常用的方法,回调接口和服务接口。由于很多内容前面已经反复分享过了,所以没有重头分析跳转的整个流程,有需要的小伙伴可以自行参考前面的分享。
ARouter这个框架阿里还在维护,后面有更新我们再看看是否出新的分享,目前内容就这样了,后面还会再出最后一个简单的总结分享,欢迎关注哦。
欢迎关注公众号:JueCode