介绍
FssRouter让路由变得更简单，更规范。自定义路由API使得路由参数与路由信息一目了然，更便于管理。FssRouter框架还提供了自动创建路由API的方式，你只需要一个注解便能声明一种路由方式，更简单方便。
gitHub地址：https://github.com/gongbox/fss
背景
在Android开发中，如果要从当前Activity跳转到下一个Activity，你可能会直接使用Intent的方式跳转，如下：
Intent intent = new Intent(this,XXXActivity.class);
intent.putExtra("name","value"); //传递参数
startActivity(intent);
或者你也可能使用阿里的ARouter路由框架，如下：
ARouter.getInstance().build("/xxx/xxx")
.withString("name","value") //传递参数
.navigation(XXXActivity.class);
不管使用哪种方式，你都会发现如下问题：
1，路由要携带的参数有哪些？各个参数的key值是什么？哪些参数是必传？这些参数是什么意思...
2，对应的Activity是显示启动还是隐式启动，如果是隐式启动对应的action是什么，如果有requestCode，category，flags又该设置为多少
3，无法统一管理路由，到处可见的Intent与startActivity等等，路由方式很随意，哪里想跳就在哪儿写，想传什么参数就传什么。
4，代码量多，传的参数越多，要跳转的地方越多，代码量也就越多。
在这种背景下，笔者便有了灵感，写出了FssRouter路由框架，我们看看FssRouter是怎么解决这些问题的。
接入
在根项目的build.gradle文件中添加仓库地址
allprojects {
repositories {
...
maven { url 'https://www.jitpack.io' }
}
}
对应模块添加依赖
implementation 'com.github.gongbox.fss:router-api:1.0.33'
annotationProcessor 'com.github.gongbox.fss:router-compiler:1.0.33'
使用
我们先看一下使用自定义路由API的方式，使用这种方式需要声明一个接口，在接口中声明路由信息。
现在假设我们有两个Activity，分别是MainActivity，DetailActivity，
现在的代码是这样：
public class MainActivity extends AppCompatActivity {
...
}
public class DetailActivity extends AppCompatActivity {
...
}
然后我们声明一个java接口,接口名随意,这里为ITestRouteApi
@RouteApi("test") //定义为路由Api，“test”为这个路由api的分组
public interface ITestRouteApi {
@RouteActivity(DetailActivity.class) //定义路由的目的Activity
void navigateToDetailActivity(Context context); //第一个参数必须为Context类型
}
声明上面的接口api后，然后再编译项目，然后我们就可以使用如下的方式进行路由了。
public class MainActivity extends AppCompatActivity {
...
void xxx(){
//使用下面的方式进行路由
FssRouteApi.TEST.navigateToDetailActivity(MainActivity.this);
}
}
上面是一个简单的例子，我们在看看其他情况。
1，隐式意图启动
@RouteApi("test") //定义为路由Api，“test”为这个路由api的分组
public interface ITestRouteApi {
@RouteActivity(action = "com.fss.route.detail")
void navigateToDetailActivity(Context context);
}
2，携带路由参数
@RouteApi("test") //定义为路由Api，“test”为这个路由api的分组
public interface ITestRouteApi {
@RouteActivity(action = "com.fss.route.detail")
void navigateToDetailActivity(Context context, @Extra("value") int value);
}
3，携带默认路由参数
@RouteApi("test") //定义为路由Api，“test”为这个路由api的分组
public interface ITestRouteApi {
@RouteActivity(DetailActivity.class)
@DefaultExtra(
name = "defaultValue",
defaultValue = "hello",
type = String.class
)
void navigateToDetailActivity(Context context);
}
4，设置requestCode，category，flags，路由动画等
@RouteApi("test") //定义为路由Api，“test”为这个路由api的分组
public interface ITestRouteApi {
@RouteActivity(
value = DetailActivity.class, //设置路由的目标Activity
requestCode = 1234, //设置requestCode
)
void navigateToDetailActivity1(Context context);
@RouteActivity(
value = DetailActivity.class, //设置路由的目标Activity
category = Intent.CATEGORY_DEFAULT, //设置category
)
void navigateToDetailActivity2(Context context);
@RouteActivity(
value = DetailActivity.class, //设置路由的目标Activity
flags = Intent.FLAG_ACTIVITY_CLEAR_TASK, //设置falgs
)
void navigateToDetailActivity3(Context context);
@RouteActivity(
value = DetailActivity.class, //设置路由的目标Activity
enterAnim = android.R.anim.fade_in, //设置activity进入动画
exitAnim = android.R.anim.fade_out //设置activity退出动画
)
void navigateToDetailActivity4(Context context);
}
5,携带Uri,设置type等
@RouteApi("test") //定义为路由Api，“test”为这个路由api的分组
public interface ITestRouteApi {
@RouteActivity(action = Intent.ACTION_VIEW)
void routeToView(Context context, Uri data);
@RouteActivity(
action = Intent.ACTION_GET_CONTENT,
requestCode = 2,
category = Intent.CATEGORY_OPENABLE,
type = "video/*")
void navigateToGetContent(Context context);
}
自动创建Api
上面展示了如何自定义一个路由Api，并如何进行路由。接下来我们看一种更简单的方式实现路由。
我们在的DetailActivity上声明一个注解@Route，编译项目
@Route
public class DetailActivity extends AppCompatActivity {
...
}
然后我们在MainActivity中便可以直接这样来跳转到DetailActivity了
public class MainActivity extends AppCompatActivity {
...
void xxx(){
//使用下面的方式进行路由
FssRouteApi.DEFAULT.navigateToDetailActivity(MainActivity.this);
}
}
这是因为在编译时，FssRouter会帮我们自动生成对应的路由Api，如下：
IDefaultRouteApi.java文件的具体内容如下：
public interface IDefaultRouteApi {
@RouteActivity(DetailActivity.class)
void navigateToDetailActivity(Context context);
}
因此，使用@Route注解便可以帮我们自动生成路由Api，这使得我们不必自定义路由API便可以实现路由，这种方式相对更简单，使用@Route注解，你几乎可以完成上面自定义Api的所有工作。笔者也更推荐使用这种方式，下面将介绍如何使用@Route注解。
1.携带参数
@Route(routeExtras = {
@RouteExtra(name = "value", type = String.class)
})
public class DetailActivity extends AppCompatActivity {
...
}
其中name为对应参数的key，type为对应参数的类型，默认为Object.class，支持多个参数。
对应生成的API为：
public interface IDefaultRouteApi {
@RouteActivity(DetailActivity.class)
void navigateToDetailActivity(Context context, @Extra("value") String value);
}
2.携带默认参数
@Route(defaultExtras = {
@DefaultExtra(name = "defaultValue", defaultValue = "hello" , type = String.class)
})
public class DetailActivity extends AppCompatActivity {
...
}
默认参数即是默认携带的参数，只支持基本数据类型，默认为String类型，支持多个默认参数。
对应生成的API为：
public interface IDefaultRouteApi {
@RouteActivity(DetailActivity.class)
@DefaultExtra(name = "defaultValue", defaultValue = "hello" , type = String.class)
void navigateToDetailActivity(Context context);
}
3.隐式启动
@Route(action = "com.gongbo.fss.route.detail")
public class DetailActivity extends AppCompatActivity {
...
}
这里便会以隐式意图去启动这个Activity，但是注意你还是需要在AndroidManifest.xml中配置这个Activity支持隐式启动。
对应生成的API为：
public interface IDefaultRouteApi {
@RouteActivity(action = "com.gongbo.fss.route.detail")
void navigateToDetailActivity(Context context);
}
4. 设置分组
@Route(group = "test")
public class DetailActivity extends AppCompatActivity {
...
}
每一个分组都会对应FssRouteApi类中的一个静态常量，test分组即对应FssRouteApi.TEST，如果没有设置分组，默认为default分组(FssRouteApi.DEFAULT)。此外，相同分组的Api将定义在同一个文件内,如IDefaultRouteApi.class。
对应生成的API为：
public interface ITestRouteApi {
@RouteActivity(DetailActivity.class)
void navigateToDetailActivity(Context context);
}
5. 设置路由方法名
@Route(name = "navigateTest")
public class DetailActivity extends AppCompatActivity {
...
}
路由方法默认为 "navigateTo"+路由目的类的类名称，通过设置name你可以设置自己想要的名称。
对应生成的API为：
public interface ITestRouteApi {
@RouteActivity(DetailActivity.class)
void navigateTest(Context context);
}
6. 设置flags，category，requestCode等
@Route(
category = Intent.CATEGORY_DEFAULT,
flags = Intent.FLAG_ACTIVITY_CLEAR_TASK,
requestCode = 1234
)
public class DetailActivity extends AppCompatActivity {
...
}
对应生成的API为：
public interface ITestRouteApi {
int REQUEST_CODE_TO_DETAIL_ACTIVITY = 1234;
@RouteActivity(
value = DetailActivity.class,
category = Intent.CATEGORY_DEFAULT,
flags = Intent.FLAG_ACTIVITY_CLEAR_TASK,
requestCode = REQUEST_CODE_TO_DETAIL_ACTIVITY)
void navigateToDetailActivity(Context context);
}
7,其他，设置路由动画，为路由方法添加注释等等
下面是一个比较完整的例子
@Route(
//设置路由名称
name = "navigateTest",
//设置分组
group = "detail",
//添加requestCode
requestCode = 1234,
//设置category
category = Intent.CATEGORY_DEFAULT,
//设置falgs
flags = Intent.FLAG_ACTIVITY_CLEAR_TASK,
//添加参数
routeExtras = {
@RouteExtra(name = "value", type = String.class, desc = "参数注释")
},
//添加默认参数
defaultExtras = {
@DefaultExtra(name = "defaultValue", defaultValue = "hello")
},
//activity进入动画
enterAnim = android.R.anim.fade_in,
exitAnim = android.R.anim.fade_out,
//添加注释
desc = "示例"
)
public class DetailActivity extends AppCompatActivity {
...
}
对应生成的API为：
public interface IDetailRouteApi {
int REQUEST_CODE_TO_DETAIL_ACTIVITY = 1234;
/**
* 示例
* @value 参数注释
*/
@RouteActivity(
value = RouteDetailActivity.class,
requestCode = REQUEST_CODE_TO_ROUTE_DETAIL_ACTIVITY,
category = {"android.intent.category.DEFAULT"},
flags = 32768,
enterAnim = 17432576,
exitAnim = 17432577
)
@DefaultExtra(
name = "defaultValue",
defaultValue = "hello",
type = String.class
)
void navigateTest(Context context, @Extra("value") String value);
}
这里提一下，@Route注解不仅可以声明在Activity上，也可以声明在Service或Fragment上，FssRouter同样支持路由到Service或Fragment，但部分属性不支持Service或Fragment。
而且你也可以在同一个Activity（或Service，Fragment）上添加多个@Route注解，以提供多种路由方式
其他
1,自定义配置
通过在build.gradle中defaultConfig中添加如下配置进行自定义修改
javaCompileOptions {
annotationProcessorOptions {
arguments = [
MODULE_NAME : "fss", //模块名（重要，多模块时一定要填写）
NAVIGATE_PREFIX : "navigateTo", //路由方法前缀
NAVIGATE_SUFFIX : "", //路由方法后缀
BUILD_INTENT_PREFIX: "buildIntentFor",//构建Intent方法前缀
BUILD_INTENT_SUFFIX: "", //构建Intent方法后缀
API_PREFIX : "I", //路由接口名常量前缀
API_SUFFIX : "RouteApi", //路由接口名常量后缀
GROUP_PREFIX : "", //路由分组常量前缀
GROUP_SUFFIX : "", //路由分组常量后缀
DEFAULT_GROUP : "default", //默认分组名
ROUTE_API_PREFIX : "", //接口前缀
ROUTE_API_SUFFIX : "RouteApi", //接口后缀
]
}
}
以上展示的是默认值，大多数参数通常情况下你都不需要自定义，但要注意，MODULE_NAME一定要配置，尤其是在项目中存在多个使用FssRouter的模块时。在下节的多组件支持中会讲解。
2，多组件支持
通过在各组件/模块中配置不同的MODULE_NAME参数实现，这样相应模块生成的api将放在不同的包名下，默认是com.fss.router，修改后将为com.MODULE_NAME的值.router。同时相应的Api的接口名也将会修改，默认为FssRouteApi,修改后将为
MODULE_NAME的值+ROUTE_API_SUFFIX
3，同一个Activity生成多个跳转方式
如果你使用的是Java8
@Route(name = "navigateTest")
@Route(group = "test")
@Route(action = "com.fss.hello")
public class DetailActivity extends AppCompatActivity {
...
}
如果不是使用的Java8
@Routes(value = {
@Route(name = "routeTest"),
@Route(group = "test"),
@Route(action = "com.fss.hello")
})
public class DetailActivity extends AppCompatActivity {
...
}
4,我想查看Activity的返回值，有没有更好的方式?
我们只需要将withResultCallBack设为true即可
@Route(requestCode = 1234, withResultCallBack = true)
对应生成的DefaultRouteApi
int REQUEST_CODE_TO_DETAIL_ACTIVITY = 1234;
@RouteActivity(
value = DetailActivity.class,
requestCode = REQUEST_CODE_TO_DETAIL_ACTIVITY
)
void navigateToDetailActivity(Context context, OnActivityResult onActivityResult);
可以看到上面的方法多了一个OnActivityResult类型的参数
然后我们就可以这样使用：
FssRouteApi.DEFAULT.navigateToDetailActivity(this, new OnActivityResult() {
@Override
public void onActivityResult(int requestCode, int resultCode, Intent data) {
//在这个方法会在该Activity返回后调用
}
});
不过，要实现这样的功能，我们还需要在MainActivity里的onActivityResult方法里添加一行代码：
public class MainActivity extends AppCompatActivity {
@Override
protected void onActivityResult(int requestCode, int resultCode,@Nullable Intent data) {
super.onActivityResult(requestCode, resultCode, data);
//这里必须添加，否则不会起作用
FssRouter.onActivityResult(requestCode, resultCode, data);
}
}
最后
总结一下:
一，FssRouter使用了类似retrofit的方式管理路由，路由信息清晰明了。
二，相同分组的路由声明在同一接口文件中，便于管理
三，使用时只需一行代码便可以实现路由，路由更方便。
如果你还有其他疑问或建议，欢迎与作者反馈，如果觉得不错，请点个赞，给颗星，谢谢。
更多FSS框架：
- Android开发利器-FSS开源框架之绑定
- Android开发利器-FSS开源框架之fss_common
- Android开发利器-FSS开源框架之方法运行优先级
- Android开发利器-FSS开源框架之ListView，RecyclerView适配器
如果想要了解fss框架的具体使用，我为大家提供了demo工程
- Demo