SAF-AOP
基于 Aspecj 实现的 Android AOP 框架，并使用沪江的gradle 插件：https://github.com/HujiangTechnology/gradle_plugin_android_aspectjx
下载安装
在根目录下的build.gradle中添加
buildscript {
repositories {
jcenter()
}
dependencies {
classpath 'com.hujiang.aspectjx:gradle-android-plugin-aspectjx:2.0.4'
}
}在app 模块目录下的build.gradle中添加
apply plugin: 'com.hujiang.android-aspectjx'
...
dependencies {
compile 'com.safframework:saf-aop:1.3.0'
...
}基于aspectj的AOP，无需使用耗费性能的反射.不过,需要在build.gradle中配置一下aspectj
| 注解名称 | 作用 | 备注 |
|---|---|---|
| @Async | 借助RxJava,异步地执行app中的方法 | |
| @Cacheable | Spring Cache风格的Cache注解,将结果放于缓存中 | 只适用于android4.0以后 |
| @LogMethod | 将方法的入参和出参都打印出来,可以用于调试 | |
| @HookMethod | 可以在调用某个方法之前、以及之后进行hook | 比较适合埋点的场景，可以单独使用也可以跟任何自定义注解配合使用。也支持在匿名内部类中使用 |
| @Prefs | 将方法返回的结果放入AppPrefs中 | 只适用于android4.0以后 |
| @Safe | 可以安全地执行方法,而无需考虑是否会抛出运行时异常 | 支持在捕获异常的时候进行监听 |
| @Trace | 用于追踪某个方法花费的时间,可以用于性能调优的评判 | 支持追踪匿名内部类中的方法 |
| @Permission | 可用于运行时动态地申请权限 |
@Async的使用方法:
@Async
private void useAsync() {
Log.e(TAG, " thread=" + Thread.currentThread().getId());
Log.e(TAG, "ui thread=" + Looper.getMainLooper().getThread().getId());
}@Cacheable的使用方法:
@Cacheable(key = "user")
private User initData() {
User user = new User();
user.userName = "tony";
user.password = "123456";
return user;
}这里的@Cacheable,实际上用到Cache,要获取Cache也很简单.
@Trace的使用方法:
@Trace
@Async
private void loadUser() {
Log.e(TAG, " thread=" + Thread.currentThread().getId());
Log.e(TAG, "ui thread=" + Looper.getMainLooper().getThread().getId());
Cache cache = Cache.get(this);
User user = (User) cache.getObject("user");
Toast.makeText(MainActivity.this, SAFUtils.printObject(user), Toast.LENGTH_SHORT).show();
}将@Trace和@Async两个注解结合使用,可以看到调用loadUser()方法花费的时间.
05-18 14:31:31.229 21190-21190/app.magicwindow.cn.testsaf I/MainActivity: MainActivity=loadUser() take [1ms]
05-18 14:31:31.231 21190-22033/app.magicwindow.cn.testsaf E/com.test.saf.activity.MainActivity: thread=14876
05-18 14:31:31.231 21190-22033/app.magicwindow.cn.testsaf E/com.test.saf.activity.MainActivity: ui thread=1@Trace还支持在匿名内部类中使用
@Trace
private void initData() {
Observable.create(new ObservableOnSubscribe<String>() {
@Trace
@Override
public void subscribe(@NonNull ObservableEmitter<String> e) throws Exception {
e.onNext("111");
e.onNext("222");
e.onNext("333");
}
}).subscribe(new Consumer<String>() {
@Trace
@Override
public void accept(@NonNull String str) throws Exception {
}
});
}@HookMethod的使用方法:
不写beforeMethod和afterMethod，则相当于没有使用@HookMethod
beforeMethod和afterMethod对应的都是方法名，分别表示在调用doSomething()之前执行和之后执行。目前还不支持在beforeMethod和afterMethod中传递参数。
@HookMethod(beforeMethod="dosthbeforeMethod",afterMethod="dosthafterMethod")
void doSomething() {
}@HookMethod 同样支持在匿名内部类中使用
@HookMethod(beforeMethod = "method1",afterMethod = "method2")
private void initData() {
L.i("initData()");
}
private void method1() {
L.i("method1() is called before initData()");
}
private void method2() {
L.i("method2() is called after initData()");
}
private void testRx() {
Observable.just("tony")
.subscribe(new Consumer<String>() {
@HookMethod(beforeMethod = "testRxBefore")
@Override
public void accept(@NonNull String s) throws Exception {
System.out.println("s="+s);
}
private void testRxBefore() {
L.i("testRxBefore() is called before accept()");
}
});Proguard
-keep class com.safframework.aop.** { *; }联系方式
Wechat：fengzhizi715
SAF-AOP相关文章：
http://www.jianshu.com/p/9e78560cadad
http://www.jianshu.com/p/2779e3bb1f14
Java与Android技术栈：每周更新推送原创技术文章，欢迎扫描下方的公众号二维码并关注，期待与您的共同成长和进步。
ChangeLog
License
Copyright (C) 2017 - present, Tony Shen.
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.