基于公司业务发展,公司的APP需求不断增加,应用也略显“臃肿”。想着趁现在不那么“糟糕”,时间也比较宽裕,把项目结构整整,因而走上了组件化之路。
模块化 VS 组件化
模块化: 将一个程序按照其功能做拆分,分成相互独立的模块,以便于每个模块只包含与其功能相关的内容。
组件化: 基于可重用的目的,将一个大的软件系统按照分离关注点的形式,拆分成多个独立的组件。
区别:
模块化和组件化本质思想是一样的,都是“大化小”,两者的目的都是为了重用和解耦,只是叫法不一样。如果非要说区别,那么可以认为模块化粒度更小,更侧重于重用;而组件化粒度稍大于模块,更侧重于业务解耦。
为什么需要路由
路由主要的功能是实现模块化之间界面(Activity,网页)的跳转,那为什么不直接调显式跳转呢?
据我总结,主要有以下3点原因:
减少模块之间的依赖。因为显式跳转需要引用其他模块。
跳转时,参数不明确,沟通需要时间。因为显式调用时,需要知道目标Activity需要哪些参数,如果参数改了,如果沟通不到位或者文档没有及时更新,会出现错误等问题。
简化H5页面与应用页面之间的跳转。
虽然网上有很多库,如阿里的ARouter。我不是有轮子不用,只是想着能学习多点组件化的知识,出于这个目的,决定自定义路由。
跳转页面的方式
Activity之间的跳转有2种方式:显式和隐式,显式显然不行,我们来看看隐式(如果不知道,请参考Android开发艺术探索笔记(2)- Activity的启动模式)。
隐式跳转的条件是Intent要么匹配action,要么匹配data。我这里选择匹配data方式,理由是匹配data方式是利用URL Scheme页面跳转协议,可以非常方便跳转app中的各个页面,也可以通过H5页面跳转页面等。
什么是URL Scheme
Android中的scheme是一种页面内跳转协议,通过定义自己的scheme协议,可以非常方便跳转app中的各个页面;通过scheme协议,服务器可以定制化告诉App跳转那个页面,可以通过通知栏消息定制化跳转页面,可以通过H5页面跳转页面等。
URL Scheme格式
URL Scheme和Http的Uri很像,包括scheme,host,port,path,query。
例子:
app://user:8888/login?username=xiaoming
- app:代表scheme,协议的名称
- user:代表host,地址域
- 8888:代表port,端口号
- login:代表path,路径
- username:代表query,传递的参数
使用URL Scheme
manifest声明activity:
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android" package="com.johan.demo">
<application
<activity android:name=".SecondActivity">
<intent-filter>
<data android:scheme="app" android:host="user" android:port="8888" android:path="/login" />
<!-- 一下几行必须设置 -->
<action android:name="android.intent.action.VIEW" /> <!-- 隐式调用必须声明 -->
<category android:name="android.intent.category.DEFAULT" /> <!-- 隐式调用必须声明 -->
<category android:name="android.intent.category.BROWSABLE" /> <!-- BROWSABLE的意思就是浏览器在特定条件下可以打开你的Activity -->
</intent-filter>
</activity>
...
</application>
</manifest>
activity跳转:
Intent intent = new Intent();
Uri uri = Uri.parse("app://user:8888/login?username=xiaoming");
intent.setData(uri);
startActivity(intent);
这种方式跳转Activity有个致命的缺点,如果找不到对应的Uri,程序就会Crash,所以在跳转之前要判断一下Uri是否存在:
PackageManager packageManager = getPackageManager();
Intent intent = new Intent();
Uri uri = Uri.parse("app://user:8888/login?username=xiaoming");
intent.setData(uri);
List<ResolveInfo> activities = packageManager.queryIntentActivities(intent, 0);
boolean isValid = !activities.isEmpty();
if (isValid) {
startActivity(intent);
}
设计路由
既然跳转方式选定了,但是还存在问题,就是参数不明确问题。如果能像retrofit那样,方法决定参数,这样就不用担心参数不明确问题了。
稍微看过retrofit源码都知道,retrofit运用的动态代理模式,so我们模仿一下,Like This,代码如下:(dome,仅供参考)
public class SimpleRouter {
// ApplicationContext
private static Context routerContext;
/**
* 初始化
* @param context
*/
public static void init(Context context, int cacheSize) {
routerContext = context.getApplicationContext();
}
@SuppressWarnings("unchecked")
public static <T> T create(final Class<T> iRouter) {
return (T) Proxy.newProxyInstance(iRouter.getClassLoader(), new Class[]{iRouter}, new InvocationHandler() {
@Override
public Object invoke(Object proxy, Method method, Object[] args) throws Throwable {
// 开始解析
// 域名,可以不写
String domain = null;
if (iRouter.isAnnotationPresent(RouterDomain.class)) {
RouterDomain routerDomain = iRouter.getAnnotation(RouterDomain.class);
domain = routerDomain.value();
}
// 路径,必须有,否则报错
if (!method.isAnnotationPresent(RouterPath.class)) {
throw new RuntimeException(iRouter.getName() + " " + method.getName() + " should has RouterPath Annotation");
}
RouterPath uriPath = method.getAnnotation(RouterPath.class);
String path = uriPath.value();
StringBuilder urlBuilder = new StringBuilder();
if (domain != null) urlBuilder.append(domain);
urlBuilder.append(path);
// 参数
Annotation[][] paramAnnotations = method.getParameterAnnotations();
for (int index = 0; index < paramAnnotations.length; index++) {
Annotation[] paramAnnotation = paramAnnotations[0];
if (paramAnnotation == null || paramAnnotation.length == 0) {
continue;
}
if (paramAnnotation[0] instanceof RouterParam) {
RouterParam uriParam = (RouterParam) paramAnnotation[0];
String param = uriParam.value();
String connector = index == 0 ? "?" : "&";
urlBuilder.append(connector).append(param).append("=").append(args[index]);
}
}
// 打开Activity
openActivity(urlBuilder.toString());
return null;
}
});
}
/**
* 打开Activity
* @param url
* @return
*/
private static boolean openActivity(String url) {
PackageManager packageManager = routerContext.getPackageManager();
Intent intent = new Intent(Intent.ACTION_VIEW, Uri.parse(url));
List<ResolveInfo> activities = packageManager.queryIntentActivities(intent, 0);
boolean isValid = !activities.isEmpty();
if (isValid) {
routerContext.startActivity(intent);
}
return isValid;
}
}
应用动态代理模式,由接口生成代理类,调用接口方法时,就会执行代理类的invoke方法,打开对应的Activity!
使用方法:比如我们有2个module,app和user-module。
先在user-module的manifest文件声明activity:
<activity android:name=".UserLoginActivity">
<intent-filter>
<data android:scheme="app" android:host="user" android:path="/login" />
<action android:name="android.intent.action.VIEW" />
<category android:name="android.intent.category.DEFAULT" />
<category android:name="android.intent.category.BROWSABLE" />
</intent-filter>
</activity>
然后在app跳转到user-module的界面:
// 我在Application初始化SimpleRouter,也可以在Activity中初始化
public class MainApplication extends Application {
@Override
public void onCreate() {
super.onCreate();
SimpleRouter.init(this);
}
}
// UserRouter接口
@RouterDomain("app://user")
public interface UserRouter {
@RouterPath("/login")
void goLogin();
}
// MainActivity跳转
public class MainActivity extends Activity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
}
public void goToUserLogin(View view) {
// 跳转
SimpleRouter.create(UserRouter.class).goLogin();
}
}
使用就这么简单!!!
当然,目前只是一个实现页面跳转的路由,以后慢慢改善!!
代码我已经上传到我的github中,代码地址:https://github.com/JohanMan/simplerouter,有兴趣的可以看一下!!
参考资料
Android 开发:由模块化到组件化(一)
Android业务组件化之URL Scheme使用
Android业务组件化之子模块SubModule的拆分以及它们之间的路由Router实现