RxRouter

一个轻量级、简单、智能并且强大的安卓路由库

Github地址

Getting started

添加依赖

在build.gradle文件中添加以下依赖：

dependencies {
	implementation 'zlc.season:rxrouter:x.y.z'
	annotationProcessor 'zlc.season:rxrouter-compiler:x.y.z'
}

如果使用 Kotlin ，用 kapt 替换 annotationProcessor

Hello World

首先在我们需要路由的Activity上添加 @Url 注解：

@Url("this is a url")
class UrlActivity : AppCompatActivity() {
    ...
}

然后创建一个被 @Router 注解的类，用来告诉RxRouter这里有一个路由器：

@Router
class MainRouter{
}

这个类不需要有任何其余的代码，RxRouter会根据这个类的类名自动生成一个 RouterProvider ，比如这里的 MainRouter 将会生成 MainRouterProvider .

接着我们需要把这些路由器添加到 RxRouterProviders 中：

class CustomApplication : Application() {
    override fun onCreate() {
        super.onCreate()
        RxRouterProviders.add(MainRouterProvider())
    }
}

最后，就可以开始我们的表演了：

RxRouter.of(context)
        .route("this is a uri")
        .subscribe()

参数传递

携带参数跳转：

通过with方法，你可以给本次路由添加一系列参数.

RxRouter.of(context)
        .with(10)                         	//int value
        .with(true)							//boolean value
        .with(20.12)						//double value
        .with("this is a string value")		//string value
        .with(Bundle())						//Bundle value
        .route("this is a uri")
        .subscribe()

不再需要 onActivityResult 方法了

想要获取跳转返回的值？再也不用写一大堆 onActivityResult 方法了！链式调用，一步到位！

RxRouter.of(context)
		.with(false)
        .with(2000)
        .with(9999999999999999)
        .route("this is a uri")
        .subscribe {
            if (it.resultCode == Activity.RESULT_OK) {
                val intent = it.data
                val stringResult = intent.getStringExtra("result")
                result_text.text = stringResult
                stringResult.toast()
            }
        }

如果有结果返回，在subscribe中处理就行了.

Class 跳转

不想用Url注解？没问题，RxRouter同样支持原始的指定类名的跳转方式，和url跳转的方式相同：

RxRouter.of(context)
        .routeClass(ClassForResultActivity::class.java)
        .subscribe{
            if (it.resultCode == Activity.RESULT_OK) {
                val intent = it.data
                val stringResult = intent.getStringExtra("result")
                result_text.text = stringResult
                stringResult.toast()
            }
        }

Action 跳转

同样的，RxRouter也支持系统的Action和自定义的Action跳转.

自定义Action跳转：

<activity android:name=".ActionActivity">
    <intent-filter>
        <action android:name="zlc.season.sample.action" />
        <category android:name="android.intent.category.DEFAULT" />
    </intent-filter>
</activity>

RxRouter.of(context)
        .routeAction("zlc.season.sample.action")
        .subscribe({
            "no result".toast()
        }, {
            it.message?.toast()
        })

系统Action跳转：

//拨打电话
RxRouter.of(this)
        .addUri(Uri.parse("tel:123456"))
        .routeSystemAction(Intent.ACTION_DIAL)
        .subscribe()

//发送短信
val bundle = Bundle()
bundle.putString("sms_body", "这是信息内容")
RxRouter.of(this)
        .addUri(Uri.parse("smsto:10086"))
        .with(bundle)
        .routeSystemAction(Intent.ACTION_SENDTO)
        .subscribe()

防火墙

RxRouter拥有一个小巧而强大的防火墙，能够在路由之前根据防火墙的规则进行拦截，您可以添加一个或者多个防火墙.

//创建一个LoginFirewall
class LoginFirewall : Firewall {
    override fun allow(datagram: Datagram): Boolean {
        if (notLogin) {
            "您还没有登录，请先登录".toast()
            return false
        }
        return true
    }
}

//将Firewall添加到路由中
RxRouter.of(this)
        .addFirewall(LoginFirewall())
        .route("this is a url")
        .subscribe()

作者：Season

链接：https://juejin.im/post/5acdb3b1518825558a06f80e