什么是路由?说简单点就是映射页面跳转关系的,当然它也包含跳转相关的一切功能。
路由框架的意义
Android系统已经给我们提供了api来做页面跳转,比如startActivity
,为什么还需要路由框架呢?我们来简单分析下路由框架存在的意义:
工作流程图
Router的工作流程简要如下图:
特性
Router
有哪些特性或者有点呢?
集成
集成过程也可参考项目主页README。
1、在项目级的build.gradle
中加入依赖:
buildscript {
repositories {
jcenter()
}
dependencies {
classpath 'com.android.tools.build:gradle:2.2.x ↑'
classpath 'com.chenenyu.router:gradle-plugin:latest.integration'
}
}
// Optional. Specify the dependencies version, default to the latest version.
ext {
...
routerVersion = "x.y.z"
compilerVersion = "x.y.z"
}
其中ext
中的配置是可选的,用来指定依赖的router
和注解处理器的版本,默认为最新的版本。
注意,Router
需要使用2.2.0及以上版本的Android gradle plugin
来处理注解处理器,截至写作时,最新版本为2.3.0-beta2
。
2、在module级的build.gradle
中使用plugin:
apply plugin: 'com.android.application/library'
apply plugin: 'com.chenenyu.router'
至此,集成工作就完成了,简单的两步:添加依赖插件和应用插件。
使用
1、Router
需要初始化,用于初始化路由表,建议放到Application
中做:
public class App extends MultiDexApplication {
@Override
public void onCreate() {
super.onCreate();
// 初始化
Router.initialize(this);
// 开启log
if (BuildConfig.DEBUG) {
Router.openLog();
}
}
}
2、添加注解
// 单路径注解
@Route("test")
public class TestActivity extends Activity {
...
}
// 多路径注解,这几个注解都能打开该Activity
@Route({"user", "example://user", "http://example.com/user"})
public class UserActivity extends Activity {
...
}
3、发起路由操作
// 最简单的路由跳转,打开TestActivity
Router.build("test").go(context);
// 其他部分api
Router.build("user")
.requestCode(int) // 调用startActivityForResult
.extras(bundle) // 携带跳转参数
.addFlags(flag) // 添加标记,比如intent.addFlags(Intent.FLAG_ACTIVITY_CLEAR_TOP)
.anim(enter, exit) // 添加跳转动画
.callback(calback) // 跳转结果回调
.go(context);
进阶
自定义路由表
Router
除了可以使用注解来做映射,还支持在代码中自定义:
// 动态添加路由
Router.addRouteTable(new RouteTable() {
@Override
public void handleActivityTable(Map<String, Class<? extends Activity>> map) {
map.put("dynamic", DynamicActivity.class);
}
});
即路由表由两部分组成,一部分是注解,另一部分是手动添加的。
拦截器
Router
支持拦截器的配置,比如在跳转前做登录状态的校验,
Router.addRouteInterceptor(new RouteInterceptor() {
@Override
public boolean intercept(Context context, @NonNull Uri uri, @Nullable Bundle extras) {
// operation.
return false;
}
});
intercept
方法返回true
即表示拦截该路由,false
表示不拦截。拦截器可以添加多个,依次调用,方便协作开发。
自定义路由解析规则
该功能是Router
的特色功能之一。由于每个产品的业务都不一样,灵活的路由处理规则是十分必要的。用户可以借鉴Router
内置的几个匹配器(Matcher
),来实现自己的规则。
内置的Matcher
Router
目前内置了4个Matcher
,已经能适用绝大部分业务场景,优先级从高到低分别是SimpleMatcher(0x1000)
、SchemeMatcher(0x0100)
、ImplicitMatcher(0x0010)
、BrowserMatcher(0x0000)
,优先级高的Matcher会优先匹配。
自定义Matcher
自定义的Matcher需要继承Matcher
抽象类,指定该Matcher的优先级,并实现两个抽象方法:
// 返回true表示当前路由被该Matcher匹配,返回false则会继续匹配其他Matcher
public abstract boolean match(Context context, Uri uri, @Nullable String route, RouteOptions routeOptions);
// match方法返回true后会调用该方法,用来生成一个Intent对象
public abstract Intent onMatched(Context context, Uri uri, @Nullable Class<? extends Activity> target);
然后调用Router.registerMatcher(new CustomMatcher(int priority));
来注册自定义的Matcher。
Matcher支持配置多个,会依次进行匹配。
其他
获取Intent
Intent intent = Router.build(uri).getIntent(context);
,即可获取一个符合路由规则Intent对象,然后你可以使用这个intent来跳转,或者发一个通知。
显示log
在调试过程中,可能需要打印Router
相关的log,通过Router.openLog()
即可打开,建议在debug环境下打开。
总结
Router是一个十分小巧灵活的路由框架,代码设计也很优雅简洁,且完美支持组件化开发,目前仍在不断地迭代中。
源码地址为:Router_jb51.rar
以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持亿速云。
亿速云「云服务器」,即开即用、新一代英特尔至强铂金CPU、三副本存储NVMe SSD云盘,价格低至29元/月。点击查看>>
免责声明:本站发布的内容(图片、视频和文字)以原创、转载和分享为主,文章观点不代表本网站立场,如果涉及侵权请联系站长邮箱:is@yisu.com进行举报,并提供相关证据,一经查实,将立刻删除涉嫌侵权内容。