@AndroidAopMatchClassMethod
简述¶
此切面是做匹配某类及其对应方法的切面的,这个切面方式关注的是方法的执行(Method Execution) 注意区分和@AndroidAopReplaceClass的区别。
@AndroidAopMatchClassMethod(
targetClassName = 目标类名(包含包名),
methodName = 方法名数组,
type = 匹配类型,非必须,默认 EXTENDS
excludeClasses = 排除继承关系中的一些类的数组(type 不是 SELF 才有效),非必须
)
-
targetClassName 是内部类时不使用
$
字符,而是用.
-
type 有四种类型(不设置默认
EXTENDS
):SELF
表示匹配的是 targetClassName 所设置类的 自身EXTENDS
表示匹配的是 所有继承于 targetClassName 所设置的类DIRECT_EXTENDS
表示匹配的是 直接继承于 targetClassName 所设置的类LEAF_EXTENDS
表示匹配的是 末端继承(就是没有子类了) targetClassName 所设置的类
graph LR C(C 类) ---> |C类继承于B类| B{ B 类 }; B --->|B类继承于A类| A[A 类]; B --->|DIRECT_EXTENDS / EXTENDS| A; C ---->|LEAF_EXTENDS / EXTENDS| A; D(D 类) --->|D类继承于A类| A; D --->|DIRECT_EXTENDS/ LEAF_EXTENDS / EXTENDS| A;
简单来说,
LEAF_EXTENDS
和DIRECT_EXTENDS
是两个极端,前者关注的是继承关系中最后一个节点,后者关注的是继承关系中第一个节点。另外注意EXTENDS
这种匹配类型范围比较大,所有继承的中间类也可能会加入切面代码 -
excludeClasses
- 如果 targetClassName 是类名,就是排除掉继承关系中的一些类,可以设置多个,且 type 不是 SELF 才有效
- 如果 targetClassName 是包名,就是排除掉匹配到的一些类,可以设置多个,且 type 是 SELF 才有效
-
overrideMethod 默认false
-
设置为true,如果子类(非接口,可以是抽象类)中没有匹配的方法则重写父类的方法
- targetClassName 不可以包含 *
- methodName 不可以定义 [ "*" ]
- 重写的方法不能是private 、final修饰的才可以
-
设置为false,如果子类没有匹配的方法则不作处理
-
Note
另外不是所有类都可以Hook进去
type
类型为 SELF
时,targetClassName
所设置的类必须是安装包里的代码。 例如:如果这个类(如:Toast)在 android.jar 里边是不行的。如有这种需求应该使用@AndroidAopReplaceClasstype
类型不是 SELF
时,这个切面要想有作用需要有匹配的那个方法,如果子类没有重写匹配的方法,子类就不会被匹配到,使用 overrideMethod 可忽略此限制 创建切面处理类¶
切面处理类需要实现 MatchClassMethod 接口,在 invoke 中处理切面逻辑
Note
如果切点函数是 suspend 点此前往查看
匹配规则¶
可以看到下边例子中有的设置的方法名就只写了方法名,有的也写上了返回值类型和参数类型,下边介绍下
模糊匹配¶
- 1、targetClassName 最后以
.*
结尾且有其他字符,并且type = MatchType.SELF
时,则匹配该包下所有类,包括子包 如下边的例九 - 2、methodName 有且只有一个方法名为
*
的则匹配类中的所有方法 如下边的例八 - 3、methodName 只写方法名但不写返回类型和参数类型也是模糊匹配,这将会使目标类中所有同名方法都加入切点
Note
对于匹配包名的我是强烈不建议这么做的,侵入代码过多,而且打包速度明显下降。建议只做调试、日志之用,原方法应全部放行
精准匹配¶
methodName 方法名写上返回类型、参数类型,这样就可以精准到一个方法加入切点(精准匹配异常时会自动退化到模糊匹配)
匹配的写法公式: 返回值类型 方法名(参数类型,参数类型...)
- 返回值类型 可以不用写
- 方法名 必须写
- 参数类型 可以不用写,写的话用 () 包裹起来,多个参数类型用 , 隔开,没有参数就只写 ()
- 返回值类型 和 方法名 之间用空格隔开
- 返回值类型 和 参数类型 不写的话就是不验证
- 返回值类型 和 参数类型 都要用 Java 的类型表示,除了 8 种基本类型之外,其他引用类型都是 包名.类名
- 如果函数是
suspend
修饰的,那 返回值类型 无论是什么类型都写suspend
,参数类型 还是按上述几点来写 -
对于存在泛型信息的(例如集合List)必须抹除泛型信息
-
与targetClassName不同的是方法参数和返回值类型如果是内部类则需要用
$
而不能用.
代替
Note
AOP 代码生成助手,可辅助你一键生成代码
下边给出类型表示不同的 Kotlin 对 Java 对照表,如果是 Kotlin 代码请对号入座
(有发现不全的可以跟我反馈)
Kotlin 类型 | Java 类型 |
---|---|
Int | int |
Short | short |
Byte | byte |
Char | char |
Long | long |
Float | float |
Double | double |
Boolean | boolean |
Int? | java.lang.Integer |
Short? | java.lang.Short |
Byte? | java.lang.Byte |
Char? | java.lang.Character |
Long? | java.lang.Long |
Float? | java.lang.Float |
Double? | java.lang.Double |
Boolean? | java.lang.Boolean |
String | java.lang.String |
Unit(或不写) | void |
Unit? | java.lang.Void |
Any | java.lang.Object |
其他不在上表中的数据类型,都属于引用类型,写法就是 包名.类名
Note
1、Kotlin 中的 vararg str : String
相当于 Java 中的 String...
,这种匹配时无论哪种代码都按 String[]
来表示(此处以 String 为例,其他类型也一样)
2、对于有泛型的类型不要写泛型,例如 java.lang.List<String> methodName(java.lang.List<String>)
应该直接写为 java.lang.List methodName(java.lang.List)
各种场景示例¶
例一¶
想要监测所有继承自 AppCompatActivity 类的所有 startActivity 跳转
@AndroidAopMatchClassMethod(
targetClassName = "androidx.appcompat.app.AppCompatActivity",
methodName = {"startActivity"},
type = MatchType.EXTENDS
)
public class MatchActivityMethod implements MatchClassMethod {
@Nullable
@Override
public Object invoke(@NonNull ProceedJoinPoint joinPoint, @NonNull String methodName) {
// 在此写你的逻辑
return joinPoint.proceed();
}
}
注意:对于匹配子类方法的,如果子类没有重写匹配的方法,是无效的,使用 overrideMethod 可忽略此限制
例二¶
假如想 Hook 所有的 android.view.View.OnClickListener 的 onClick,说白了就是想全局监测所有的设置 OnClickListener 的点击事件,代码如下:
@AndroidAopMatchClassMethod(
targetClassName = "android.view.View.OnClickListener",
methodName = ["onClick"],
type = MatchType.EXTENDS //type 一定是 EXTENDS 因为你想 hook 所有继承了 OnClickListener 的类
)
class MatchOnClick : MatchClassMethod {
// @SingleClick(5000) //联合 @SingleClick ,给所有点击增加防多点,6不6
override fun invoke(joinPoint: ProceedJoinPoint, methodName: String): Any? {
Log.e("MatchOnClick", "=====invoke=====$methodName")
return joinPoint.proceed()
}
}
这块提示下,对于使用了 lambda 点击监听的;
ProceedJoinPoint 的 target 不是 android.view.View.OnClickListener
- 对于Java target 是 设置lambda表达式的那个类的对象
- 对于Kotlin target 是 null
invoke 回调的 methodName 也不是 onClick 而是编译时自动生成的方法名,类似于这样 onCreate\(lambda\)14 里边包含了 lambda 关键字
对于 onClick(view:View) 的 view
- 如果是 Kotlin 的代码 ProceedJoinPoint.args[1]
- 如果是 Java 的代码 ProceedJoinPoint.args[0]
这块不在继续赘述了,自己用一下就知道了;
总结下:其实对于所有的 lambda 的 ProceedJoinPoint.args
- 如果是 Kotlin 第一个参数是设置lambda表达式的那个类的对象,后边的参数就是 hook 方法的所有参数
- 如果是 Java 从第一个参数开始就是 hook 方法的所有参数
例三¶
目标类有多个重名方法,只想匹配某一个方法(上文有提到精准匹配规则)
package com.flyjingfish.test_lib;
public class TestMatch {
public void test(int value1){
}
public String test(int value1,String value2){
return value1+value2;
}
}
package com.flyjingfish.test_lib.mycut;
@AndroidAopMatchClassMethod(
targetClassName = "com.flyjingfish.test_lib.TestMatch",
methodName = ["java.lang.String test(int,java.lang.String)"],
type = MatchType.SELF
)
class MatchTestMatchMethod : MatchClassMethod {
override fun invoke(joinPoint: ProceedJoinPoint, methodName: String): Any? {
Log.e("MatchTestMatchMethod","======"+methodName+",getParameterTypes="+joinPoint.getTargetMethod().getParameterTypes().length);
// 在此写你的逻辑
//不想执行原来方法逻辑,👇就不调用下边这句
return joinPoint.proceed()
}
}
例四¶
继承关系层次较多时不想每层都加入切面
@AndroidAopMatchClassMethod(
targetClassName = "android.view.View.OnClickListener",
methodName = ["onClick"],
type = MatchType.EXTENDS //type 一定是 EXTENDS 因为你想 hook 所有继承了 OnClickListener 的类
)
class MatchOnClick : MatchClassMethod {
// @SingleClick(5000) //联合 @SingleClick ,给所有点击增加防多点,6不6
override fun invoke(joinPoint: ProceedJoinPoint, methodName: String): Any? {
Log.e("MatchOnClick", "=====invoke=====$methodName")
return joinPoint.proceed()
}
}
public abstract class MyOnClickListener implements View.OnClickListener {
@Override
public void onClick(View v) {
...
//这块有必要的逻辑代码
}
}
binding.btnSingleClick.setOnClickListener(object :MyOnClickListener(){
override fun onClick(v: View?) {
super.onClick(v)//尤其是这句调用父类 onClick 想要保留执行父类方法的逻辑
onSingleClick()
}
})
这么写,会导致上边的 MyOnClickListener onClick 也加入切面,如此一来相当于一个点击有回调了两次切面处理类的 invoke ,这可能不是我们想要的,所以可以这么改
@AndroidAopMatchClassMethod(
targetClassName = "android.view.View.OnClickListener",
methodName = ["onClick"],
type = MatchType.EXTENDS,
excludeClasses = ["com.flyjingfish.androidaop.test.MyOnClickListener"]//加上这个可以排除掉一些类
)
class MatchOnClick : MatchClassMethod {
override fun invoke(joinPoint: ProceedJoinPoint, methodName: String): Any? {
Log.e("MatchOnClick", "=====invoke=====$methodName")
return joinPoint.proceed()
}
}
例五¶
切入点是伴生对象怎么办?
假如有这样一个代码
package com.flyjingfish.androidaop
class ThirdActivity : BaseActivity() {
companion object{
fun start(){
...
}
}
}
@AndroidAopMatchClassMethod(
targetClassName = "com.flyjingfish.androidaop.ThirdActivity.Companion",
methodName = ["start"],
type = MatchType.SELF
)
class MatchCompanionStart : MatchClassMethod {
override fun invoke(joinPoint: ProceedJoinPoint, methodName: String): Any? {
Log.e("MatchCompanionStart", "======$methodName")
return joinPoint.proceed()
}
}
例六¶
切入点是 Kotlin 代码的成员变量,想要监听赋值、取值的操作
在代码中我们会有这样的操作
您可以这么写
@AndroidAopMatchClassMethod(
targetClassName = "com.flyjingfish.androidaop.test.TestBean",
methodName = ["setName","getName"],
type = MatchType.SELF
)
class MatchTestBean : MatchClassMethod {
override fun invoke(joinPoint: ProceedJoinPoint, methodName: String): Any? {
Log.e("MatchTestBean", "======$methodName");
ToastUtils.makeText(ToastUtils.app,"MatchTestBean======$methodName")
return joinPoint.proceed()
}
}
例七¶
如果切点方法是 suspend
修饰的函数怎么办?
package com.flyjingfish.androidaop
class MainActivity: BaseActivity2() {
suspend fun getData(num:Int) :Int{
return withContext(Dispatchers.IO) {
getDelayResult()
}
}
}
精准匹配写法如下,匹配的函数返回值类型无论是哪种,都写 suspend
,具体说明看上文的精准匹配部分
@AndroidAopMatchClassMethod(
targetClassName = "com.flyjingfish.androidaop.MainActivity",
methodName = ["suspend getData(int)"],
type = MatchType.SELF
)
class MatchSuspend : MatchClassMethod {
override fun invoke(joinPoint: ProceedJoinPoint, methodName: String): Any? {
Log.e("MatchSuspend", "======$methodName")
return joinPoint.proceed()
}
}
例八¶
想要匹配一个类的所有方法
@AndroidAopMatchClassMethod(
targetClassName = "com.flyjingfish.androidaop.SecondActivity",
methodName = ["*"],
type = MatchType.SELF
)
class MatchAllMethod : MatchClassMethod {
override fun invoke(joinPoint: ProceedJoinPoint, methodName: String): Any? {
Log.e("MatchMainAllMethod", "AllMethod======$methodName");
return joinPoint.proceed()
}
}
例九¶
想要匹配一个包下的所有类的所有方法
@AndroidAopMatchClassMethod(
targetClassName = "com.flyjingfish.androidaop.*",
methodName = ["*"],
type = MatchType.SELF
)
class MatchAll : MatchClassMethod {
override fun invoke(joinPoint: ProceedJoinPoint, methodName: String): Any? {
Log.e("MatchAll", "---->${joinPoint.targetClass}--${joinPoint.targetMethod.name}--${joinPoint.targetMethod.parameterTypes.toList()}");
return joinPoint.proceed()
}
}
*
代替了 类名
或者代替一部分的包名+类名
,该例代表 com.flyjingfish.androidaop
包以及子包下的所有类 2、当然 methodName 部分依旧可以填写多个模糊匹配甚至精准匹配的方法名