DegradeService degradeService = ARouter.getInstance().navigation(DegradeService.class);
if (null != degradeService) {
degradeService.onLost(context, postcard);
}
}
return null;
}
if (null != callback) {
//找到了匹配的目标类
callback.onFound(postcard);
}
if (!postcard.isGreenChannel()) { // It must be run in async thread, maybe interceptor cost too mush time made ANR.
//没有开启绿色通道,那么就还需要执行所有拦截器
//外部可以通过拦截器实现:控制是否允许跳转、更改跳转参数等逻辑
interceptorService.doInterceptions(postcard, new InterceptorCallback() {
/**
-
Continue process
-
@param postcard route meta
*/
@Override
public void onContinue(Postcard postcard) {
//拦截器允许跳转
_navigation(context, postcard, requestCode, callback);
}
/**
-
Interrupt process, pipeline will be destory when this method called.
-
@param exception Reson of interrupt.
*/
@Override
public void onInterrupt(Throwable exception) {
if (null != callback) {
callback.onInterrupt(postcard);
}
logger.info(Consts.TAG, "Navigation failed, termination by interceptor : " + exception.getMessage());
}
});
} else {
//开启了绿色通道,直接跳转,不需要遍历拦截器
return _navigation(context, postcard, requestCode, callback);
}
return null;
}
//由于本例子的目标页面是 Activity,所以只看 ACTIVITY 即可
private Object _navigation(final Context context, final Postcard postcard, final int requestCode, final NavigationCallback callback) {
final Context currentContext = null == context ? mContext : context;
switch (postcard.getType()) {
case ACTIVITY:
// Build intent
//Destination 就是指向目标 Activity 的 class 对象
final Intent intent = new Intent(currentContext, postcard.getDestination());
//塞入携带的参数
intent.putExtras(postcard.getExtras());
// Set flags.
int flags = postcard.getFlags();
if (-1 != flags) {
intent.setFlags(flags);
} else if (!(currentContext instanceof Activity)) { // Non activity, need less one flag.
intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
}
// Set Actions
String action = postcard.getAction();
if (!TextUtils.isEmpty(action)) {
intent.setAction(action);
}
// Navigation in main looper.
//最终在主线程完成跳转
runInMainThread(new Runnable() {
@Override
public void run() {
startActivity(requestCode, currentContext, intent, postcard, callback);
}
});
break;
··· //省略其它类型判断
}
return null;
}
}
复制代码
navigation
方法的重点在于 LogisticsCenter.completion(postcard)
这一句代码。在讲 ARouter 初始化流程的时候有讲到:等到后续需要跳转到 group
为 account
的页面时,就会再来反射调用 ARouter$$Group$$account
的 loadInto
方法,即按需加载,等到需要的时候再来获取详细的路由对应信息
completion
方法就是用来获取详细的路由对应信息的。该方法会通过 postcard
携带的 path 和 group 信息从 Warehouse
取值,如果值不为 null 的话就将信息保存到 postcard
中,如果值为 null 的话就抛出 NoRouteFoundException
/**
-
Completion the postcard by route metas
-
@param postcard Incomplete postcard, should complete by this method.
*/
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) { //为 null 说明目标类不存在或者是该 group 还未加载过
Class<? extends IRouteGroup> groupMeta = Warehouse.groupsIndex.get(postcard.getGroup()); // Load route meta.
if (null == groupMeta) {
//groupMeta 为 null,说明 postcard 的 path 对应的 group 不存在,抛出异常
throw new NoRouteFoundException(TAG + “There is no route match the path [” + postcard.getPath() + “], in group [” + postcard.getGroup() + “]”);
} else {
// Load route and cache it into memory, then delete from metas.
try {
if (ARouter.debuggable()) {
logger.debug(TAG, String.format(Locale.getDefault(), “The group [%s] starts loading, trigger by [%s]”, postcard.getGroup(), postcard.getPath()));
}
//会执行到这里,说明此 group 还未加载过,那么就来反射加载 group 对应的所有 path 信息
//获取后就保存到 Warehouse.routes
IRouteGroup iGroupInstance = groupMeta.getConstructor().newInstance();
iGroupInstance.loadInto(Warehouse.routes);
//移除此 group
Warehouse.groupsIndex.remove(postcard.getGroup());
if (ARouter.debuggable()) {
logger.debug(TAG, String.format(Locale.getDefault(), “The group [%s] has already been loaded, trigger by [%s]”, postcard.getGroup(), postcard.getPath()));
}
} catch (Exception e) {
throw new HandlerException(TAG + “Fatal exception when loading group meta. [” + e.getMessage() + “]”);
}
//重新执行一遍
completion(postcard); // Reload
}
} else {
//拿到详细的路由信息了,将这些信息存到 postcard 中
postcard.setDestination(routeMeta.getDestination());
postcard.setType(routeMeta.getType());
postcard.setPriority(routeMeta.getPriority());
postcard.setExtra(routeMeta.getExtra());
//省略一些和本例子无关的代码
···
}
}
复制代码
五、跳转到 Activity 并注入参数
ARouter 也支持在跳转到 Activity 的同时向目标页面自动注入参数
在跳转的时候指定要携带的键值对参数:
ARouter.getInstance().build(RoutePath.USER_HOME)
.withLong(RoutePath.USER_HOME_PARAMETER_ID, 20)
.withString(RoutePath.USER_HOME_PARAMETER_NAME, “leavesC”)
.navigation()
object RoutePath {
const val USER_HOME = “/account/userHome”
const val USER_HOME_PARAMETER_ID = “userHomeId”
const val USER_HOME_PARAMETER_NAME = “userName”
}
复制代码
在目标页面通过 @Autowired
注解修饰变量。注解可以同时声明其 name
参数,用于和传递的键值对中的 key 对应上,这样 ARouter 才知道应该向哪个变量赋值。如果没有声明 name
参数,那么 name
参数就默认和变量名相等
这样,在我们调用 ARouter.getInstance().inject(this)
后,ARouter 就会自动完成参数的赋值
package github.leavesc.user
/**
-
作者:leavesC
-
时间:2020/10/4 14:05
-
描述:
-
GitHub:https://github.com/leavesC
*/
@Route(path = RoutePath.USER_HOME)
class UserHomeActivity : AppCompatActivity() {
@Autowired(name = RoutePath.USER_HOME_PARAMETER_ID)
@JvmField
var userId: Long = 0
@Autowired
@JvmField
var userName = “”
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContentView(R.layout.activity_user_home)
ARouter.getInstance().inject(this)
tv_hint.text = “$userId $userName”
}
}
复制代码
ARouter 实现参数自动注入也需要依靠注解处理器生成的辅助文件来实现,即会生成以下的辅助代码:
package github.leavesc.user;
/**
- DO NOT EDIT THIS FILE!!! IT WAS GENERATED BY AROUTER. */
public class UserHomeActivity A R o u t e r ARouter ARouterAutowired implements ISyringe {
//用于实现序列化和反序列化
private SerializationService serializationService;
@Override
public void inject(Object target) {
serializationService = ARouter.getInstance().navigation(SerializationService.class);
UserHomeActivity substitute = (UserHomeActivity)target;
substitute.userId = substitute.getIntent().getLongExtra(“userHomeId”, substitute.userId);
substitute.userName = substitute.getIntent().getStringExtra(“userName”);
}
}
复制代码
因为在跳转到 Activity 时携带的参数也是需要放到 Intent
里的,所以 inject
方法也只是帮我们实现了从 Intent
取值然后向变量赋值的逻辑而已,这就要求相应的变量必须是 public
的,这就是在 Kotlin 代码中需要同时向变量加上 @JvmField
注解的原因
现在来看下 ARouter 是如何实现参数自动注入的,其起始方法就是:ARouter.getInstance().inject(this)
,其最终会调用到以下方法
final class _ARouter {
static void inject(Object thiz) {
AutowiredService autowiredService = ((AutowiredService) ARouter.getInstance().build(“/arouter/service/autowired”).navigation());
if (null != autowiredService) {
autowiredService.autowire(thiz);
}
}
}
复制代码
ARouter 通过控制反转的方式拿到 AutowiredService
对应的实现类 AutowiredServiceImpl
的实例对象,然后调用其 autowire
方法完成参数注入
由于生成的参数注入辅助类的类名具有固定的包名和类名,即包名和目标类所在包名一致,类名是目标类类名+ $$ARouter$$Autowired
,所以在 AutowiredServiceImpl
中就可以根据传入的 instance
参数和反射来生成辅助类对象,最终调用其 inject
方法完成参数注入
@Route(path = “/arouter/service/autowired”)
public class AutowiredServiceImpl implements AutowiredService {
private LruCache<String, ISyringe> classCache;
private List blackList;
@Override
public void init(Context context) {
classCache = new LruCache<>(66);
blackList = new ArrayList<>();
}
@Override
public void autowire(Object instance) {
String className = instance.getClass().getName();
try {
//如果在白名单中了的话,那么就不再执行参数注入
if (!blackList.contains(className)) {
ISyringe autowiredHelper = classCache.get(className);
if (null == autowiredHelper) { // No cache.
autowiredHelper = (ISyringe) Class.forName(instance.getClass().getName() + SUFFIX_AUTOWIRED).getConstructor().newInstance();
}
//完成参数注入
autowiredHelper.inject(instance);
//缓存起来,避免重复反射
classCache.put(className, autowiredHelper);
}
} catch (Exception ex) {
//如果参数注入过程抛出异常,那么就将其加入白名单中
blackList.add(className); // This instance need not autowired.
}
}
}
复制代码
六、控制反转
上一节所讲的跳转到 Activity 并自动注入参数属于依赖注入的一种,ARouter 同时也支持控制反转:通过接口来获取其实现类实例
例如,假设存在一个 ISayHelloService
接口,我们需要拿到其实现类实例,但是不希望在使用的时候和特定的实现类 SayHelloService
绑定在一起从而造成强耦合,此时就可以使用 ARouter 的控制反转功能,但这也要求 ISayHelloService
接口继承了 IProvider
接口才行
/**
-
作者:leavesC
-
时间:2020/10/4 13:49
-
描述:
-
GitHub:https://github.com/leavesC
*/
interface ISayHelloService : IProvider {
fun sayHello()
}
@Route(path = RoutePath.SERVICE_SAY_HELLO)
class SayHelloService : ISayHelloService {
override fun init(context: Context) {
}
override fun sayHello() {
Log.e(“SayHelloService”, “$this sayHello”)
}
}
复制代码
在使用的时候直接传递 ISayHelloService
的 Class 对象即可,ARouter 会将 SayHelloService
以单例模式的形式返回,无需开发者手动去构建 SayHelloService
对象,从而达到解耦的目的
ARouter.getInstance().navigation(ISayHelloService::class.java).sayHello()
复制代码
和实现 Activity 跳转的时候一样,ARouter 也会自动生成以下几个文件,包含了路由表的映射关系
package com.alibaba.android.arouter.routes;
/**
- DO NOT EDIT THIS FILE!!! IT WAS GENERATED BY AROUTER. */
public class ARouter G r o u p Group Groupaccount implements IRouteGroup {
@Override
public void loadInto(Map<String, RouteMeta> atlas) {
atlas.put(“/account/sayHelloService”, RouteMeta.build(RouteType.PROVIDER, SayHelloService.class, “/account/sayhelloservice”, “account”, null, -1, -2147483648));
}
}
/**
- DO NOT EDIT THIS FILE!!! IT WAS GENERATED BY AROUTER. */
public class ARouter P r o v i d e r s Providers Providersuser implements IProviderGroup {
@Override
public void loadInto(Map<String, RouteMeta> providers) {
providers.put(“github.leavesc.user.ISayHelloService”, RouteMeta.build(RouteType.PROVIDER, SayHelloService.class, “/account/sayHelloService”, “account”, null, -1, -2147483648));
}
}
/**
- DO NOT EDIT THIS FILE!!! IT WAS GENERATED BY AROUTER. */
public class ARouter R o o t Root Rootuser implements IRouteRoot {
@Override
public void loadInto(Map<String, Class<? extends IRouteGroup>> routes) {
routes.put(“account”, ARouter G r o u p Group Groupaccount.class);
}
}
复制代码
这里再来看下其具体的实现原理
在讲初始化流程的时候有讲到,LogisticsCenter
实现了扫描特定包名路径拿到所有自动生成的辅助文件的逻辑。所以,最终 Warehouse 中就会在初始化的时候拿到以下数据
Warehouse.groupsIndex:
account
->class com.alibaba.android.arouter.routes.ARouter$$Group$$account
Warehouse.providersIndex:
github.leavesc.user.ISayHelloService
->RouteMeta.build(RouteType.PROVIDER, SayHelloService.class, "/account/sayHelloService", "account", null, -1, -2147483648)
ARouter.getInstance().navigation(ISayHelloService::class.java)
最终会中转调用到 _ARouter
的以下方法
protected T navigation(Class<? extends T> service) {
try {
//从 Warehouse.providersIndex 取值拿到 RouteMeta 中存储的 path 和 group
Postcard postcard = LogisticsCenter.buildProvider(service.getName());
// Compatible 1.0.5 compiler sdk.
// Earlier versions did not use the fully qualified name to get the service
if (null == postcard) {
// No service, or this service in old version.
postcard = LogisticsCenter.buildProvider(service.getSimpleName());
}
if (null == postcard) {
return null;
}
//重点
LogisticsCenter.completion(postcard);
return (T) postcard.getProvider();
} catch (NoRouteFoundException ex) {
logger.warning(Consts.TAG, ex.getMessage());
return null;
}
}
复制代码
LogisticsCenter.completion(postcard)
方法的流程和之前讲解的差不多,只是在获取对象实例的时候同时将实例缓存起来,留待之后复用,至此就完成了控制反转的流程了
/**
-
Completion the postcard by route metas
-
@param postcard Incomplete postcard, should complete by this method.
*/
public synchronized static void completion(Postcard postcard) {
… //省略之前已经讲解过的代码
RouteMeta routeMeta = Warehouse.routes.get(postcard.getPath());
switch (routeMeta.getType()) {
case PROVIDER: // if the route is provider, should find its instance
// Its provider, so it must implement IProvider
//拿到 SayHelloService Class 对象
Class<? extends IProvider> providerMeta = (Class<? extends IProvider>) routeMeta.getDestination();
IProvider instance = Warehouse.providers.get(providerMeta);
if (null == instance) { // There’s no instance of this provider
//instance 等于 null 说明是第一次取值
//那么就通过反射构建 SayHelloService 对象,然后将之缓存到 Warehouse.providers 中
//所以通过控制反转获取的对象在应用的整个生命周期内只会有一个实例
IProvider provider;
try {
provider = providerMeta.getConstructor().newInstance();
provider.init(mContext);
Warehouse.providers.put(providerMeta, provider);
instance = provider;
} catch (Exception e) {
throw new HandlerException("Init provider failed! " + e.getMessage());
}
}
//将获取到的实例存起来
postcard.setProvider(instance);
postcard.greenChannel(); // Provider should skip all of interceptors
break;
case FRAGMENT:
postcard.greenChannel(); // Fragment needn’t interceptors
default:
break;
}
}
复制代码
七、拦截器
ARouter 的拦截器对于某些需要控制页面跳转流程的业务逻辑来说是十分有用的功能。例如,用户如果要跳转到个人资料页面时,我们就可以通过拦截器来判断用户是否处于已登录状态,还未登录的话就可以拦截该请求,然后自动为用户打开登录页面
我们可以同时设定多个拦截器,每个拦截器设定不同的优先级
/**
-
作者:leavesC
-
时间:2020/10/5 11:49
-
描述:
-
GitHub:https://github.com/leavesC
*/
@Interceptor(priority = 100, name = “啥也不做的拦截器”)
class NothingInterceptor : IInterceptor {
override fun init(context: Context) {
}
override fun process(postcard: Postcard, callback: InterceptorCallback) {
//不拦截,任其跳转
callback.onContinue(postcard)
}
}
@Interceptor(priority = 200, name = “登陆拦截器”)
class LoginInterceptor : IInterceptor {
override fun init(context: Context) {
}
override fun process(postcard: Postcard, callback: InterceptorCallback) {
if (postcard.path == RoutePath.USER_HOME) {
//拦截
callback.onInterrupt(null)
//跳转到登陆页
ARouter.getInstance().build(RoutePath.USER_LOGIN).navigation()
} else {
//不拦截,任其跳转
callback.onContinue(postcard)
}
}
}
复制代码
这样,当我们执行 ARouter.getInstance().build(RoutePath.USER_HOME).navigation()
想要跳转的时候,就会发现打开的其实是登录页 RoutePath.USER_LOGIN
来看下拦截器是如何实现的
对于以上的两个拦截器,会生成以下的辅助文件。辅助文件会拿到所有我们自定义的拦截器实现类并根据优先级高低存到 Map 中
package com.alibaba.android.arouter.routes;
/**
- DO NOT EDIT THIS FILE!!! IT WAS GENERATED BY AROUTER. */
public class ARouter I n t e r c e p t o r s Interceptors Interceptorsuser implements IInterceptorGroup {
@Override
public void loadInto(Map<Integer, Class<? extends IInterceptor>> interceptors) {
interceptors.put(100, NothingInterceptor.class);
interceptors.put(200, LoginInterceptor.class);
}
}
复制代码
而这些拦截器一样是会在初始化的时候,通过LogisticsCenter.init
方法存到 Warehouse.interceptorsIndex
中
/**
- LogisticsCenter init, load all metas in memory. Demand initialization
*/
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)) {
// 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)) {
// Load interceptorMeta
//拿到自定义的拦截器实现类
((IInterceptorGroup) (Class.forName(className).getConstructor().newInstance())).loadInto(Warehouse.interceptorsIndex);
} else if (className.startsWith(ROUTE_ROOT_PAKCAGE + DOT + SDK_NAME + SEPARATOR + SUFFIX_PROVIDERS)) {
// Load providerIndex
((IProviderGroup) (Class.forName(className).getConstructor().newInstance())).loadInto(Warehouse.providersIndex);
}
}
···
}
复制代码
然后,在 _ARouter
的 navigation
方法中,如何判断到此次路由请求没有开启绿色通道模式的话,那么就会将此次请求转交给 interceptorService
,让其去遍历每个拦截器
final class _ARouter {
/**
-
Use router navigation.
-
@param context Activity or null.
-
@param postcard Route metas
-
@param requestCode RequestCode
-
@param callback cb
*/
protected Object navigation(final Context context, final Postcard postcard, final int requestCode, final NavigationCallback callback) {
···
if (!postcard.isGreenChannel()) { // It must be run in async thread, maybe interceptor cost too mush time made ANR.
//遍历拦截器
interceptorService.doInterceptions(postcard, new InterceptorCallback() {
/**
-
Continue process
-
@param postcard route meta
*/
@Override
public void onContinue(Postcard postcard) {
_navigation(context, postcard, requestCode, callback);
}
/**
-
Interrupt process, pipeline will be destory when this method called.
-
@param exception Reson of interrupt.
*/
@Override
public void onInterrupt(Throwable exception) {
if (null != callback) {
callback.onInterrupt(postcard);
}
logger.info(Consts.TAG, "Navigation failed, termination by interceptor : " + exception.getMessage());
}
});
} else {
return _navigation(context, postcard, requestCode, callback);
}
return null;
}
}
复制代码
interceptorService
变量属于 InterceptorService
接口类型,该接口的实现类是 InterceptorServiceImpl
,ARouter内部在初始化的过程中也是根据控制反转的方式来拿到 interceptorService
这个实例的
InterceptorServiceImpl
的主要逻辑是:
-
在第一次获取
InterceptorServiceImpl
实例的时候,其init
方法会马上被调用,该方法内部会交由线程池来执行,通过反射生成每个拦截器对象,并调用每个拦截器的init
方法来完成拦截器的初始化,并将每个拦截器对象都存到Warehouse.interceptors
中。如果初始化完成了,则唤醒等待在interceptorInitLock
上的线程 -
当拦截器逻辑被触发,即
doInterceptions
方法被调用时,如果此时第一个步骤还未执行完的话,则会通过checkInterceptorsInitStatus()
方法等待第一个步骤执行完成。如果十秒内都未完成的话,则走失败流程直接返回 -
在线程池中遍历拦截器列表,如果有某个拦截器拦截了请求的话则调用
callback.onInterrupt
方法通知外部,否则的话则调用callback.onContinue()
方法继续跳转逻辑
@Route(path = “/arouter/service/interceptor”)
public class InterceptorServiceImpl implements InterceptorService {
private static boolean interceptorHasInit;
private static final Object interceptorInitLock = new Object();
@Override
public void init(final Context context) {
LogisticsCenter.executor.execute(new Runnable() {
@Override
public void run() {
if (MapUtils.isNotEmpty(Warehouse.interceptorsIndex)) {
//遍历拦截器列表,通过反射构建对象并初始化
for (Map.Entry<Integer, Class<? extends IInterceptor>> entry : Warehouse.interceptorsIndex.entrySet()) {
Class<? extends IInterceptor> interceptorClass = entry.getValue();
try {
IInterceptor iInterceptor = interceptorClass.getConstructor().newInstance();
iInterceptor.init(context);
//存起来
Warehouse.interceptors.add(iInterceptor);
} catch (Exception ex) {
throw new HandlerException(TAG + “ARouter init interceptor error! name = [” + interceptorClass.getName() + “], reason = [” + ex.getMessage() + “]”);
}
}
interceptorHasInit = true;
logger.info(TAG, “ARouter interceptors init over.”);
synchronized (interceptorInitLock) {
interceptorInitLock.notifyAll();
}
}
}
});
}
@Override
public void doInterceptions(final Postcard postcard, final InterceptorCallback callback) {
if (null != Warehouse.interceptors && Warehouse.interceptors.size() > 0) {
checkInterceptorsInitStatus();
if (!interceptorHasInit) {
//初始化太久,不等了,直接走失败流程
callback.onInterrupt(new HandlerException(“Interceptors initialization takes too much time.”));
return;
}
LogisticsCenter.executor.execute(new Runnable() {
@Override
public void run() {
CancelableCountDownLatch interceptorCounter = new CancelableCountDownLatch(Warehouse.interceptors.size());
try {
_excute(0, interceptorCounter, postcard);
interceptorCounter.await(postcard.getTimeout(), TimeUnit.SECONDS);
if (interceptorCounter.getCount() > 0) { // Cancel the navigation this time, if it hasn’t return anythings.
//大于 0 说明此次请求被某个拦截器拦截了,走失败流程
callback.onInterrupt(new HandlerException(“The interceptor processing timed out.”));
} else if (null != postcard.getTag()) { // Maybe some exception in the tag.
callback.onInterrupt(new HandlerException(postcard.getTag().toString()));
} else {
callback.onContinue(postcard);
}
} catch (Exception e) {
callback.onInterrupt(e);
}
}
});
} else {
callback.onContinue(postcard);
}
}
/**
-
Excute interceptor
-
@param index current interceptor index
-
@param counter interceptor counter
-
@param postcard routeMeta
*/
private static void _excute(final int index, final CancelableCountDownLatch counter, final Postcard postcard) {
if (index < Warehouse.interceptors.size()) {
IInterceptor iInterceptor = Warehouse.interceptors.get(index);
iInterceptor.process(postcard, new InterceptorCallback() {
@Override
public void onContinue(Postcard postcard) {
// Last interceptor excute over with no exception.
counter.countDown();
_excute(index + 1, counter, postcard); // When counter is down, it will be execute continue ,but index bigger than interceptors size, then U know.
}
@Override
public void onInterrupt(Throwable exception) {
// Last interceptor excute over with fatal exception.
postcard.setTag(null == exception ? new HandlerException(“No message.”) : exception.getMessage()); // save the exception message for backup.
counter.cancel();
// Be attention, maybe the thread in callback has been changed,
// then the catch block(L207) will be invalid.
// The worst is the thread changed to main thread, then the app will be crash, if you throw this exception!
// if (!Looper.getMainLooper().equals(Looper.myLooper())) { // You shouldn’t throw the exception if the thread is main thread.
// throw new HandlerException(exception.getMessage());
// }
}
});
}
}
private static void checkInterceptorsInitStatus() {
synchronized (interceptorInitLock) {
while (!interceptorHasInit) {
try {
interceptorInitLock.wait(10 * 1000);
} catch (InterruptedException e) {
throw new HandlerException(TAG + “Interceptor init cost too much time error! reason = [” + e.getMessage() + “]”);
}
}
}
}
}
复制代码
八、注解处理器
通篇读下来,读者应该能够感受到注解处理器在 ARouter 中起到了很大的作用,依靠注解处理器生成的辅助文件,ARouter 才能完成参数自动注入等功能。这里就再来介绍下 ARouter 关于注解处理器的实现原理
APT(Annotation Processing Tool) 即注解处理器,是一种注解处理工具,用来在编译期扫描和处理注解,通过注解来生成 Java 文件。即以注解作为桥梁,通过预先规定好的代码生成规则来自动生成 Java 文件。此类注解框架的代表有 ButterKnife、Dragger2、EventBus 等
Java API 已经提供了扫描源码并解析注解的框架,开发者可以通过继承 AbstractProcessor 类来实现自己的注解解析逻辑。APT 的原理就是在注解了某些代码元素(如字段、函数、类等)后,在编译时编译器会检查 AbstractProcessor 的子类,并且自动调用其 process() 方法,然后将添加了指定注解的所有代码元素作为参数传递给该方法,开发者再根据注解元素在编译期输出对应的 Java 代码
关于 APT 技术的原理和应用可以看这篇文章:Android APT 实例讲解
ARouter 源码中和注解处理器相关的 module 有两个:
-
arouter-annotation。Java Module,包含了像 Autowired、Interceptor 这些注解以及 RouteMeta 等 JavaBean
-
arouter-compiler。Android Module,包含了多个 AbstractProcessor 的实现类用于生成代码
这里主要来看 arouter-compiler
,这里以自定义的拦截器 NothingInterceptor
作为例子
package github.leavesc.user
/**
-
作者:leavesC
-
时间:2020/10/5 11:49
-
描述:
-
GitHub:https://github.com/leavesC
*/
@Interceptor(priority = 100, name = “啥也不做的拦截器”)
class NothingInterceptor : IInterceptor {
override fun init(context: Context) {
}
override fun process(postcard: Postcard, callback: InterceptorCallback) {
//不拦截,任其跳转
callback.onContinue(postcard)
}
}
复制代码
生成的辅助文件:
package com.alibaba.android.arouter.routes;
import com.alibaba.android.arouter.facade.template.IInterceptor;
import com.alibaba.android.arouter.facade.template.IInterceptorGroup;
import github.leavesc.user.NothingInterceptor;
import java.lang.Class;
import java.lang.Integer;
import java.lang.Override;
import java.util.Map;
/**
- DO NOT EDIT THIS FILE!!! IT WAS GENERATED BY AROUTER. */
public class ARouter I n t e r c e p t o r s Interceptors Interceptorsuser implements IInterceptorGroup {
@Override
public void loadInto(Map<Integer, Class<? extends IInterceptor>> interceptors) {
interceptors.put(100, NothingInterceptor.class);
}
}
复制代码
那么,生成的辅助文件我们就要包含以下几个元素:
-
包名
-
导包
-
注释
-
实现类及继承的接口
-
包含的方法及方法参数
-
方法体
-
修饰符
如果通过硬编码的形式,即通过拼接字符串的方式来生成以上代码也是可以的,但是这样会使得代码不好维护且可读性很低,所以 ARouter 是通过 JavaPoet
这个开源库来生成代码的。JavaPoet
是 square 公司开源的 Java 代码生成框架,可以很方便地通过其提供的 API 来生成指定格式(修饰符、返回值、参数、函数体等)的代码
拦截器对应的 AbstractProcessor
子类就是 InterceptorProcessor
,其主要逻辑是:
-
在 process 方法中通过 RoundEnvironment 拿到所有使用了 @Interceptor 注解进行修饰的代码元素 elements,然后遍历所有 item
-
判断每个 item 是否继承了 IInterceptor 接口,是的话则说明该 item 就是我们要找的拦截器实现类
-
获取每个 item 包含的 @Interceptor 注解对象,根据我们为之设定的优先级 priority,将每个 item 按顺序存到 interceptors 中
-
如果存在两个拦截器的优先级相同,那么就抛出异常
-
将所有拦截器按顺序存入 interceptors 后,通过 JavaPoet 提供的 API 来生成包名、导包、注释、实现类等多个代码元素,并最终生成一个完整的类文件
@AutoService(Processor.class)
@SupportedAnnotationTypes(ANNOTATION_TYPE_INTECEPTOR)
public class InterceptorProcessor extends BaseProcessor {
//用于保存拦截器,按照优先级高低进行排序
private Map<Integer, Element> interceptors = new TreeMap<>();
private TypeMirror iInterceptor = null;
@Override
public synchronized void init(ProcessingEnvironment processingEnv) {
super.init(processingEnv);
iInterceptor = elementUtils.getTypeElement(Consts.IINTERCEPTOR).asType();
logger.info(“>>> InterceptorProcessor init. <<<”);
}
/**
-
{@inheritDoc}
-
@param annotations
-
@param roundEnv
*/
@Override
public boolean process(Set<? extends TypeElement> annotations, RoundEnvironment roundEnv) {
if (CollectionUtils.isNotEmpty(annotations)) {
//拿到所有使用了 @Interceptor 进行修饰的代码元素
Set<? extends Element> elements = roundEnv.getElementsAnnotatedWith(Interceptor.class);
try {
parseInterceptors(elements);
} catch (Exception e) {
logger.error(e);
}
return true;
}
return false;
}
/**
-
Parse tollgate.
-
@param elements elements of tollgate.
*/
private void parseInterceptors(Set<? extends Element> elements) throws IOException {
if (CollectionUtils.isNotEmpty(elements)) {
logger.info(“>>> Found interceptors, size is " + elements.size() + " <<<”);
// Verify and cache, sort incidentally.
for (Element element : elements) {
//判断使用了 @Interceptor 进行修饰的代码元素是否同时实现了 com.alibaba.android.arouter.facade.template.IInterceptor 这个接口
//两者缺一不可
if (verify(element)) { // Check the interceptor meta
logger.info("A interceptor verify over, its " + element.asType());
Interceptor interceptor = element.getAnnotation(Interceptor.class);
Element lastInterceptor = interceptors.get(interceptor.priority());
if (null != lastInterceptor) { // Added, throw exceptions
//不为 null 说明存在两个拦截器其优先级相等,这是不允许的,直接抛出异常
throw new IllegalArgumentException(
String.format(Locale.getDefault(), “More than one interceptors use same priority [%d], They are [%s] and [%s].”,
interceptor.priority(),
lastInterceptor.getSimpleName(),
element.getSimpleName())
);
}
//将拦截器按照优先级高低进行排序保存
interceptors.put(interceptor.priority(), element);
} else {
logger.error("A interceptor verify failed, its " + element.asType());
}
}
// Interface of ARouter.
//拿到 com.alibaba.android.arouter.facade.template.IInterceptor 这个接口的类型抽象
TypeElement type_ITollgate = elementUtils.getTypeElement(IINTERCEPTOR);
//拿到 com.alibaba.android.arouter.facade.template.IInterceptorGroup 这个接口的类型抽象
TypeElement type_ITollgateGroup = elementUtils.getTypeElement(IINTERCEPTOR_GROUP);
/**
-
Build input type, format as :
*/
//生成对 Map<Integer, Class<? extends IInterceptor>> 这段代码的抽象封装
ParameterizedTypeName inputMapTypeOfTollgate = ParameterizedTypeName.get(
ClassName.get(Map.class),
ClassName.get(Integer.class),
ParameterizedTypeName.get(
ClassName.get(Class.class),
自我介绍一下,小编13年上海交大毕业,曾经在小公司待过,也去过华为、OPPO等大厂,18年进入阿里一直到现在。
深知大多数初中级Android工程师,想要提升技能,往往是自己摸索成长或者是报班学习,但对于培训机构动则近万的学费,着实压力不小。自己不成体系的自学效果低效又漫长,而且极易碰到天花板技术停滞不前!
因此收集整理了一份《2024年Android移动开发全套学习资料》,初衷也很简单,就是希望能够帮助到想自学提升又不知道该从何学起的朋友,同时减轻大家的负担。
既有适合小白学习的零基础资料,也有适合3年以上经验的小伙伴深入学习提升的进阶课程,基本涵盖了95%以上Android开发知识点,真正体系化!
由于文件比较大,这里只是将部分目录截图出来,每个节点里面都包含大厂面经、学习笔记、源码讲义、实战项目、讲解视频,并且会持续更新!
如果你觉得这些内容对你有帮助,可以扫码获取!!(备注:Android)
分享读者
作者2013年java转到Android开发,在小厂待过,也去过华为,OPPO等大厂待过,18年四月份进了阿里一直到现在。
被人面试过,也面试过很多人。深知大多数初中级Android工程师,想要提升技能,往往是自己摸索成长,不成体系的学习效果低效漫长,而且极易碰到天花板技术停滞不前!
我们整理了一份阿里P7级别的Android架构师全套学习资料,特别适合有3-5年以上经验的小伙伴深入学习提升。
主要包括腾讯,以及字节跳动,阿里,华为,小米,等一线互联网公司主流架构技术。
如果你觉得自己学习效率低,缺乏正确的指导,可以一起学习交流!
我们致力打造一个平等,高质量的Android交流圈子,不一定能短期就让每个人的技术突飞猛进,但从长远来说,眼光,格局,长远发展的方向才是最重要的。
35岁中年危机大多是因为被短期的利益牵着走,过早压榨掉了价值,如果能一开始就树立一个正确的长远的职业规划。35岁后的你只会比周围的人更值钱。
《互联网大厂面试真题解析、进阶开发核心学习笔记、全套讲解视频、实战项目源码讲义》点击传送门即可获取!
droid.arouter.facade.template.IInterceptor 这个接口的类型抽象
TypeElement type_ITollgate = elementUtils.getTypeElement(IINTERCEPTOR);
//拿到 com.alibaba.android.arouter.facade.template.IInterceptorGroup 这个接口的类型抽象
TypeElement type_ITollgateGroup = elementUtils.getTypeElement(IINTERCEPTOR_GROUP);
/**
-
Build input type, format as :
*/
//生成对 Map<Integer, Class<? extends IInterceptor>> 这段代码的抽象封装
ParameterizedTypeName inputMapTypeOfTollgate = ParameterizedTypeName.get(
ClassName.get(Map.class),
ClassName.get(Integer.class),
ParameterizedTypeName.get(
ClassName.get(Class.class),
自我介绍一下,小编13年上海交大毕业,曾经在小公司待过,也去过华为、OPPO等大厂,18年进入阿里一直到现在。
深知大多数初中级Android工程师,想要提升技能,往往是自己摸索成长或者是报班学习,但对于培训机构动则近万的学费,着实压力不小。自己不成体系的自学效果低效又漫长,而且极易碰到天花板技术停滞不前!
因此收集整理了一份《2024年Android移动开发全套学习资料》,初衷也很简单,就是希望能够帮助到想自学提升又不知道该从何学起的朋友,同时减轻大家的负担。
[外链图片转存中…(img-Ze1ADxXJ-1712452491990)]
[外链图片转存中…(img-GbhZs7oY-1712452491990)]
[外链图片转存中…(img-4jVOmwTe-1712452491990)]
[外链图片转存中…(img-a263W8Lm-1712452491991)]
[外链图片转存中…(img-nnCW9XC8-1712452491991)]
既有适合小白学习的零基础资料,也有适合3年以上经验的小伙伴深入学习提升的进阶课程,基本涵盖了95%以上Android开发知识点,真正体系化!
由于文件比较大,这里只是将部分目录截图出来,每个节点里面都包含大厂面经、学习笔记、源码讲义、实战项目、讲解视频,并且会持续更新!
如果你觉得这些内容对你有帮助,可以扫码获取!!(备注:Android)
分享读者
作者2013年java转到Android开发,在小厂待过,也去过华为,OPPO等大厂待过,18年四月份进了阿里一直到现在。
被人面试过,也面试过很多人。深知大多数初中级Android工程师,想要提升技能,往往是自己摸索成长,不成体系的学习效果低效漫长,而且极易碰到天花板技术停滞不前!
我们整理了一份阿里P7级别的Android架构师全套学习资料,特别适合有3-5年以上经验的小伙伴深入学习提升。
主要包括腾讯,以及字节跳动,阿里,华为,小米,等一线互联网公司主流架构技术。
[外链图片转存中…(img-Zv8WH0s7-1712452491991)]
如果你觉得自己学习效率低,缺乏正确的指导,可以一起学习交流!
我们致力打造一个平等,高质量的Android交流圈子,不一定能短期就让每个人的技术突飞猛进,但从长远来说,眼光,格局,长远发展的方向才是最重要的。
35岁中年危机大多是因为被短期的利益牵着走,过早压榨掉了价值,如果能一开始就树立一个正确的长远的职业规划。35岁后的你只会比周围的人更值钱。
《互联网大厂面试真题解析、进阶开发核心学习笔记、全套讲解视频、实战项目源码讲义》点击传送门即可获取!