Android 路由框架

时间  2019-11-24
标签 android 路由 框架 栏目 Android 繁體版
原文   原文链接

参考文献:java

superxlcr的ARouter学习笔记android

码字农民工的文章git

繁华落尽666的文章程序员

本文主要介绍的知识点

  • 关于android路由框架解决的问题
  • android路由框架的使用(这里只是介绍ARouter的使用)
  • 关于使用ARouter框架的注意事项
  • 总结

1.Android路由框架解决的问题

相信你们在工做中都会遇到这样的问题,经过其余App或者经过网页跳转到指定的本身的App或者跳转到指定的页面中去,通常都是在推送中或者经过Banner点击以后的操做,通常的操做都是像下面这样的github

  • 设置相应的intent-filter
<intent-filter>
	<action android:name="com.hejin.arouter.Main2Activity"/>
	<category android:name="android.intent.category.DEFAULT"/>
</intent-filter>
复制代码
  • 经过Intent隐式跳转到相应的Activity
Intent intent = new Intent();
	intent.setAction("com.hejin.arouter.Main2Activity");
	startActivity(intent);
复制代码

其实这里我要说明一下,若是你是正规的开发公司我以为通常都不会这么去写,其实这个跳转彻底能实现,可是通常正规的公司都会定一些协议和端口号,也就是说会添加scheme来指定一些数据的协议部分和path进行匹配,可是随着时间的推移和团队的扩大,会慢慢的暴露出不少问题:编程

  • 集中式的URL管理：谈到集中式的管理，老是比较蛋疼，多人协同开发的时候，你们都去AndroidManifest.xml中定义各类IntentFilter，使用隐式Intent,最终发现AndroidManifest.xml中充斥着各类Schame，各类Path，须要常常解决Path重叠覆盖、过多的Activity被导出，引起安全风险等问题
  • 可配置性较差：Manifest限制于xml格式，书写麻烦，配置复杂，能够自定义的东西也较少
  • 跨模块没法显式依赖：在App小有规模的时候，咱们会对App作水平拆分，按照业务拆分红多个子模块，之间彻底解耦，经过打包流程控制App功能，这样方便应对大团队多人协做，互相逻辑不干扰，这时候只能依赖隐式Intent跳转，书写麻烦，成功与否难以控制。

尤为是在项目演进的时候都会进行组件化开发,因此这里网上有不少大神就研究出路由框架这么一个东西,解决了上面的相应问题,这里接触的就是阿里巴巴开源的ARouter在GitHub上已经已经有3.+k的start了,相对来讲应该比较稳定,因此让咱们开始吧!api

2.ARouter的简单使用

2.1首先是把ARouter引入到项目中去

  • 首先在在module中配置相应的参数
defaultConfig {
        .......
        javaCompileOptions {
            annotationProcessorOptions {
                arguments = [ moduleName : project.getName() ]
            }
        }
    }
复制代码
  • 而后配置api和compiler(这个也是在module中)
dependencies {
    compile 'com.alibaba:arouter-api:x.x.x'
    annotationProcessor 'com.alibaba:arouter-compiler:x.x.x'
    ...
}
复制代码
  • 上面是github上面写的内容,可是有一点他没有写,可是就是必定要在项目的gradle中添加下面这段代码:
dependencies {
        classpath 'com.android.tools.build:gradle:2.3.3'
        classpath 'com.neenbedankt.gradle.plugins:android-apt:1.8' //路由须要
        // NOTE: Do not place your application dependencies here; they belong
        // in the individual module build.gradle files
    }
复制代码

这句话必定要加上不然根本就跳转不过去,具体为何我还真是不知道.... 有了以上的内容就完成了基本的配置,就能够进行相应的跳转了...安全

2.2代码中的简单使用

  • 在Application中初始化ARouter
/*初始化路由框架*/
        ARouter.init(this);
复制代码
  • 首先要在你要跳转的Activity(或者说是目标的Activity)添加注释
@Route(path = "XXX/XXX")
复制代码

这里面要注意两点首先这个注解里面的内容必须是二级菜单,这个在github上面有解释,其次就是这个注解要写在Activity的类上边bash

  • 经过代码进行跳转(发起路由)
ARouter.getInstance().build("/XXX/XXX").navigation();
//跳转中携带参数
ARouter.getInstance().build("/XXX/XXX")
             .withLong("key", "value")
             .withString("key", "value")
             .navigation
复制代码

这里面的参数要和你要跳转的Activity注解中的参数保持一致,当你传递参数的时候,你直接经过Intent去取就能够了.app

经过以上步骤就能实现基本的跳转传递参数了,可是身为有逼格的程序员咱们怎么能这样就知足了呢?

3.ARouter进阶使用

3.1 利用Uri进行跳转

Uri uri = Uri.parse("/test/activity");
        ARouter.getInstance()
                .build(uri)
                .navigation();
复制代码

3.2传递参数的获取问题

当你传递参数的时候你能够经过Intent取获取,固然也能够经过相应的注解进行获取,就像下面这样:

@Autowired(name = "xxx")
public String text;
复制代码

这里呢要注意,修饰符必须是public而且key值要相互对应.还要在目标的Activtiy中添加**ARouter.getInstance().inject(this);**才可使用相应的值,不然取值的时候会失败,可是不会报空指针.

3.3关于转场动画的跳转处理

有没有想过,以前在Activity跳转的时候可使用overridePendingTransition();,可是如今经过路由跳转的话,没有地方取设置动画了,而后ARouter为咱们想到了这个问题.

  • 旧动画:使用withTransition方法便可(至关于以前的overridePendingTransition()方法设置)
ARouter.getInstance().build(path).withTransition(R.anim_slide_in,R.anim_slide_out);
复制代码
  • 新动画:使用withOptionsCompat方法便可(Android5.0新出的转场动画)
ActivityOptionsCompat compat = ActivityOptionsCompat.makeScaleUpAnimation(view, view.getWidth() / 2, view.getHeight() / 2, 0, 0);
ARouter.getInstance().build("path").withOptionsCompat(compat).navigation();
复制代码

3.4ARouter处理跳转过程的结果

ARouter可让咱们处理跳转过程的结果,什么用呢?就是你找到目标以后要进行什么操做.

ARouter.getInstance().build("/module/jumpTestActivity2").navigation(null,new NavigationCallback() {  
            @Override
            public void onFound(Postcard postcard) { 
            // 找到目标后进行的操做
            }
            
            @Override 
            public void onLost(Postcard postcard) {
            // 找不到目标进行的操做
            }
        });
复制代码

补充说明: 在最新api中已是四个方法了!

ARouter.getInstance().build("/test/activity").navigation(this, new NavigationCallback() {
            @Override
            public void onFound(Postcard postcard) {
		//找到队应的内容的时候
                Log.e("done", "onFound: ");
            }

            @Override
            public void onLost(Postcard postcard) {
		//没有找到对应的内容的时候
                Log.e("done", "onLost: ");
            }

            @Override
            public void onArrival(Postcard postcard) {
		//跳转成功
                Log.e("done", "onArrival: ");
            }

            @Override
            public void onInterrupt(Postcard postcard) {
		//拦截操做
                Log.e("done", "onInterrupt: ");
            }
        });
复制代码

这里能够在onLost中去处理"位置页面"的跳转结果,好比升级APP之类的话术.

3.5携带结果的Activity

ARouter.getInstance().build("/test/activity").navigation(this,10);
复制代码

后面那个参数就是请求码,别的和以前的都同样.

3.6组的概念

在ARouter中有个组的概念,什么意思呢?就是在构建路由请求的时候,能够指定分组. 其实这个分组原本就是有个你像path=/test/activity test就至关是分组,可是也可使用group进行分组,像下面这段代码:

@Route(path = "/test/activity", group = "app")
复制代码

这里须要强调一下,若是你设置了相应的分组,那么在进行跳转的时候,必定要使用ARouter.getInstance().build(path, group)进行跳转,不然没法找到相应的跳转

3.7重写跳转URL实现重定向

能够从新定向你的URL地址

@Route(path = "/test/activity2")
public class PathReplaceServerImp implements PathReplaceService {
    @Override
    public String forString(String path) {

        path = "/test/activity2";
        return path;
    }

    @Override
    public Uri forUri(Uri uri) {
        return null;
    }

    @Override
    public void init(Context context) {
        Log.e("done", "init: 这里是初始化的时候执行的方法");
    }
}
复制代码

这里说明一下:上面得path必定要加上一个任意项目中出现得注解便可,若是项目中没有出现得话会报空指针异常的.经过上面的代码,就能够更改项目中跳转时候的path和URL地址了.

3.8ARouter拦截器

ARouter的拦截器能够在navigation的过程当中拦截请求,并进行一系列的处理 ,是一种AOP的编程模式(应用场景为检查登录状态等)要实现拦截器,首先咱们须要实现IInterceptor接口,并使用Interceptor注解标记咱们的拦截器,并传入priority优先级参数(数字越小,优先级越高),其实拦截器就是实现了一个接口去进行回调的!

public class TestInterceotor implements IInterceptor {
    @Override
    public void process(Postcard postcard, final InterceptorCallback callback) {
        if (postcard.getPath().equals("/test/activity")) {
            callback.onContinue(postcard);
        } else {
            callback.onContinue(postcard);
        }
    }

    @Override
    public void init(Context context) {
        Log.e("done", "init: 初始化调用");
    }
}
复制代码

这里说明几点内容:

  • 首先process这个方法是处理拦截内容的,这里我判断了一个相应的注解路由,若是跳转的是相应的路径,那么进行拦截.
  • 其次callback.onContinue(postcard)这个要注意,这句话的含义就是交由路由去处理,若是这里不写这句话的话,路由就终止了.
  • init方法是全局只执行一次,这里为何这么设计我也不知道,应该是用到相应的内容了吧!原谅我是一个菜鸟
  • 若是你想加入相应的等级的话在类的上面加入以下注解**@Interceptor(priority = 7)**其实就是设置拦截器等级的,这里为何又拦截器的等级呢?主要是为了让拦截器一级一级的向下传递.这样就有了多级的拦截器.

上面的内容只是简单的用到了拦截器,可是理解起来毕竟又一些晦涩,当直接说让你实现登录的拦截,你怎么实现,开始的时候我也以为简单,可是当本身写的时候,我发现这个问题真不是看上去那么简单.这里我先把内容拦截器的代码都放上,而后我在讲解!

  • 首次跳转的逻辑
ARouter.getInstance().build("/test/activity").navigation(this, new NavCallback() {
            @Override
            public void onArrival(Postcard postcard) {

            }

            @Override
            public void onInterrupt(Postcard postcard) {
                Log.e(TAG, "onInterrupt: 这个方法是拦截器执行以后才执行的");
            }
        });
复制代码
  • 拦截器的代码:
@Interceptor(priority = 7)
public class TestInterceotor implements IInterceptor {
    @Override
    public void process(Postcard postcard, final InterceptorCallback callback) {
        if (postcard.getPath().equals("/test/activity")) {
            Log.e("done", "process: main2Activity");
            if (APP.isLogin) {/*已经登录*/
                callback.onContinue(postcard);
            } else {/*没有登录*/
                ARouter.getInstance().build("/test/activity2")
                        .withString("name", postcard.getPath()).navigation();
            }
            Log.e("done", "process: 执行完了");
        } else {
            Log.e("done", "process: 这个方法何时执行");
            callback.onContinue(postcard);
        }
    }

    @Override
    public void init(Context context) {
        Log.e("done", "init: 初始化调用");
    }
}
复制代码
  • 模拟登录的Activity
@Route(path = "/test/activity2")
public class Main3Activity extends AppCompatActivity {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main3);
        ARouter.getInstance().inject(this);
    }

    public void click(View view) {
        APP.isLogin = true;
        ARouter.getInstance().build("/test/activity").navigation();
        finish();
    }
}
复制代码

这里第一次跳转的时候,因为拦截器使得没有登录的逻辑就跳转到了登录页面,以后我在登录页面模拟了一次登录的操做,而后关闭这个页面以前,我又从新跳转了目标页面,此次因为已经登录了,因此会直接继续执行跳转了目标页面.这里说的挺简单的,有一个回调我尚未搞清楚,onInterrupt这个回调以后有什么用,其实这里也能够传入一个字段,而后跳转的时候直接传入这个字段,这个字段主要是保存要跳转的页面的数据,以后就能直接跳转了.这样就解决了耦合的问题.

3.9在拦截器中添加额外的参数

@Route(path = "/test/activity", extras = 0;/*注意这里是int类型的参数*/)
复制代码

说明一下:这个是在目标的Activity页面添加的额外参数,以后会在拦截器内生效.

总结

其实关于这个框架还有不少问题我没有理解,可是基本的一些内容都已经讲解了,其实接触这个框架主要是当初看见组件化开发的时候,看到了这个框架,其实在项目中使用也能够,总体管理了跳转.写的挺乱的,感谢你们抽出宝贵时间来阅读,有什么不对的地方但愿指正.

相关文章
相关标签/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公众号
   欢迎关注本站公众号,获取更多信息
联系我们 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程