調研了一下目前的路由框架,ARouter(阿里的),ActivityRouter都使用了apt技術 編譯時注解,個人想法是一口吃不成胖子,先做個比較實用的。 VpRouter路由框架主要應用于組件化開發中
設計目的
- 解耦
- 跨模塊跳轉
- 方便服務器配置schema,實現動態配置跳轉目標
- 對外部提供遠程訪問的功能,實現跨應用調用響應
主要功能點
- 支持intent,http,schema三種跳轉
- 路由表支持xml配置,可自定義,支持多路徑
- 有攔截器
- 同時支持反射和隱式意圖
- 支持結果回調
- 支持參數傳遞
- 鏈式調用
- 支持url模式傳參
- 支持配置多個webview 實現指定非默認的webview啟動url
- 支持配置多個prefix
重要的類
- VpRouter 單例模式 入口類
- AbsRouter 路由抽象類 主要代碼
- RouterTable 路由表
- IRouterInterceptor(攔截器) IRouterResultCallback(結果回調)
類圖
vprouter.png
加載路由配置文件
//導入路由表 在application的onCreate中
VpRouter.load(getApplicationContext(),"router.xml");
路由配置文件
<?xml version="1.0" encoding="utf-8" ?>
<root>
schema-prefix>
<prefix>vf://</prefix>
<prefix>vipjr://</prefix>
<prefix>vpjr://</prefix>
</schema-prefix>
<default-webview>vpjr://h5.page</default-webview>
<rule>
<schema>vpjr://h5.page</schema>
<!--<action>webview</action>-->
<class>com.vip.hybrid.h5container.H5WebViewActivity</class>
</rule>
<rule>
<schema>vpjr://h5.page.pay</schema>
<!--<action>webview</action>-->
<class>com.vip.vpal.paydesk.support.h5.H5ContainerActivity</class>
</rule>
<rule>
<schema>vpjr://paycode.entry</schema>
<!--<action>1111</action>-->
<class>com.vip.vpal.paycode.presentation.activity.PaymentEntryActivity</class>
</rule>
<rule>
<schema>vpjr://guide</schema>
<!--<action>basemodule.test.mainactivity</action>-->
<class>com.vip.vf.android.GuideActivity</class>
</rule>
</root>
- schema-prefix: 前綴
- default-webview: 默認webview的schema
- 每一個rule節點代表一組路由規則,被解析成Rule對象
使用示例
//啟動url 默認的webview
VpRouter.get().context(this).jump("http://www.vip.com?web_title=唯品會");
//指定webview啟動
VpRouter.get().context(this).webView("vpjr://h5.page.pay").jump("http://www.vip.com");
//最復雜的使用
VpRouter.get()
.context(this)
.setInterceptor(new IRouterInterceptor() {
@Override
public boolean cancel() {
return false;//return true 會把本次跳轉攔截掉
}
@Override
public Bundle addExtras() {
return null;//返回Bundle 會添加到Intent中
}
})
.setResultCallback(new IRouterResultCallback() {
@Override
public void onSuccess() {
//跳轉成功的回調
}
@Override
public void onFail(RouterError error) {
//跳轉失敗的回調
LogUtils.d("error:"+error);
}
})
.extra("key","value")
.extra("key2","value2")
.flags(Intent.FLAG_ACTIVITY_SINGLE_TOP)
.jump("vf://paycode.entry?title=1111");//支持url傳參
//最簡單的使用
VpRouter.get().context(this).jump("vpjr://guide");
VpRouter.get().context(this).jumpForResult("vpjr://guide",REQUEST_CODE);//REQUEST_CODE>0