javaroute接口_Android路由框架AnnoRouter：使用Java接口来定义路由跳转

介绍

AnnoRouter是一个用于协助Android组件化的路由框架。它参考了Retrofit的接口设计&＃xff0c;将路由跳转API转化为Java接口&＃xff0c;使用注解来配置跳转信息。

Usage

初始化全局Router

Router.Builder builder &＃61; new Router.Builder()

.application(this)

...

Router.init(builder);

拦截过滤url

new Router.Builder()

.routerUrlFilter(new IRouterUrlFilter() {

&＃64;Override

public String filter(String url) {

...

return url;

}

})

...

异常错误处理

new Router.Builder()

.exceptionHandler(new IExceptionHandler() {

&＃64;Override

public void handler(String url, Exception e) {

}

})

...

定义路由Api

使用 &＃64;RouterScheme, &＃64;RouterHost, &＃64;Path 及 &＃64;Param 来定义一个路由地址。

&＃64;RouterScheme("scheme")

&＃64;RouterHost("host")

public interface RouterApi {

&＃64;Path("path")

...

void jump(&＃64;Param("paramName") int paramValue);

}

public interface RouterApi {

&＃64;RouterScheme("scheme")

&＃64;RouterHost("host")

&＃64;Path("path")

...

void jump(&＃64;Param("paramName") int paramValue);

}

有时候&＃xff0c;存在 scheme://host/path相同但参数不一样的路由地址&＃xff0c;就需要使用注解 &＃64;Strict 来作区别。

e.g.

&＃64;RouterScheme("scheme")

&＃64;RouterHost("host")

public interface RouterApi {

&＃64;Path("path")

...

void jumpToActivity1(&＃64;Param("param1") String param1);

&＃64;Strict

&＃64;Path("path")

...

void jumpToActivity2(&＃64;Param("param1") String param1, &＃64;Param("param2") int param2);

}

scheme://host/path?param1&＃61;a 将会匹配上方法 jumpToActivity1

scheme://host/path?param1&＃61;a¶m2&＃61;1 将会匹配上方法 jumpToActivity2

scheme://host/path?param1&＃61;a¶m2&＃61;1¶m3&＃61;1 将会匹配上方法 jumpToActivity1, 但 param2&＃61;1¶m3&＃61;1 会被忽略掉。

处理前置校验或准备任务

public interface RouterApi {

&＃64;Task(CustomRouterTask.class)

...

void jumpToActivity();

}

// ----------------

public class CustomRouterTask implements IRouterTask {

&＃64;Override

public void execute(Context context, RouterInfo routerInfo, OnTaskResult onTaskResult) {

// do something...

onTaskResult.success();

}

}

跳转到Activity或自定义处理

public interface RouterApi {

...

&＃64;Activity(LoginActivity.class)

void jumpToLogin();

...

&＃64;RouterHandler(CustomRouterHandler.class)

void jumpToLogin();

}

// ----------------

public class CustomRouterHandler implements IRouterHandler {

&＃64;Override

public void applyRouter(Context context, RouterInfo routerInfo, OnRouterResult routerResult) {

// do what you want to do.

if(routerResult !&＃61; null) {

routerResult.onSuccess();

}

}

}

自定义Activity转场动画

public interface RouterApi {

...

&＃64;Transition(CustomeTransition.class)

void jumpToLogin();

}

// ----------------

public class CustomeTransition implements IActivityTransition {

&＃64;Override

public int enterAnim() {

return R.anim.fade_in;

}

&＃64;Override

public int exitAnim() {

return R.anim.fade_out;

}

}

设置Activity launchMode

public interface RouterApi {

...

&＃64;Flags(Intent.FLAG_ACTIVITY_CLEAR_TOP)

void jump(&＃64;Flags int flags);

...

void jump(&＃64;Flags int flags);

}

// ----------------

Router.create(RouterApi.class).jump(Intent.FLAG_ACTIVITY_CLEAR_TOP);

添加路由Api

需要将定义好的路由Api添加至Router。如果只通过接口而不通过url跳转&＃xff0c;可以不添加。

Router.addRouterIndex(RouterApi.class);

自定义协议处理

主要处理一些特殊url协议&＃xff0c;比如 http, https

public class HttpSchemeHandler implements ISchemeHandler {

&＃64;Override

public void applyRouter(Context context, String url, OnRouterResult routerResult) {

Intent intent &＃61; new Intent();

intent.setAction("android.intent.action.VIEW");

Uri content_url &＃61; Uri.parse(url);

intent.setData(content_url);

context.startActivity(intent);

if(routerResult !&＃61; null) {

routerResult.onSuccess();

}

}

}

// ----------------

HttpSchemeHandler httpSchemeHandler &＃61; new HttpSchemeHandler();

Router.addSchemeHandler("https", httpSchemeHandler);

Router.addSchemeHandler("http", httpSchemeHandler);

使用路由Api进行跳转

两种跳转调用方式&＃xff1a;接口跳转&＃xff0c;url跳转。

// The Router class generates an implementation of the RouterApi interface.

RouterApi routerApi &＃61; Router.create(RouterApi .class);

routerApi.jump("value");

// or use url instead.

Router.execute("scheme://host/path?param&＃61;value");

获取Activity Result

&＃64;RouterScheme("app")

&＃64;RouterHost("usercenter")

public interface LoginRouterApi {

&＃64;Path("login")

&＃64;Activity(LoginActivity.class)

&＃64;RequestCode(1001)

void jumpToLogin(&＃64;Param("mobile") String mobile);

&＃64;Activity(LoginActivity.class)

&＃64;RequestCode(1001)

void jumpToLogin(&＃64;Param("mobile") String mobile, OnActivityResult onActivityResult);

}

// ----------------

OnActivityResult onActivityResult &＃61; new OnActivityResult() {

&＃64;Override

public void onActivityResult(int requestCode, int resultCode, Intent data) {

}

&＃64;Override

public void onSuccess() {

}

&＃64;Override

public void onFailure(Exception e) {

}

};

Router.execute("app://usercenter/login?mobile&＃61;0123456789", onActivityResult);

// or

Router.create(LoginRouterApi.class).jumpToLogin("0123456789", onActivityResult);

Get it

AnnoAdapter is now available on JCentral.

implementation &＃39;com.eastwood.common:anno-router:1.0.2&＃39;

结语