- class
MethodFinderclass MethodFinder internal constructor(override val classSet: Class<*>) : MemberBaseFinder
变更记录
v1.0.0
添加
功能描述
Method
查找类。
可通过指定类型查找指定 Method
或一组 Method
。
- field
namevar name: String
变更记录
v1.0.0
添加
功能描述
设置
Method
名称。
特别注意
若不填写名称则必须存在一个其它条件。
- field
paramCountvar paramCount: Int
变更记录
v1.0.0
添加
功能描述
设置
Method
参数个数。
你可以不使用 param
指定参数类型而是仅使用此变量指定参数个数。
若参数个数小于零则忽略并使用 param
。
- field
returnTypevar returnType: Any?
变更记录
v1.0.0
添加
功能描述
设置
Method
返回值,可不填写返回值。
- method
modifiersfun modifiers(conditions: ModifierConditions): IndexTypeCondition
变更记录
v1.0.0
添加
功能描述
设置
Method
标识符筛选条件。
可不设置筛选条件。
特别注意
存在多个 IndexTypeCondition 时除了 order 只会生效最后一个。
- method
emptyParamfun emptyParam(): IndexTypeCondition
变更记录
v1.0.0
添加
功能描述
设置
Method
空参数、无参数。
- method
paramfun param(vararg paramType: Any): IndexTypeCondition
变更记录
v1.0.0
添加
功能描述
设置
Method
参数。
如果同时使用了 paramCount
则 paramType
的数量必须与 paramCount
完全匹配。
如果 Method
中存在一些无意义又很长的类型,你可以使用 VagueType 来替代它。
特别注意
无参 Method 请使用 emptyParam 设置查找条件。
有参 Method 必须使用此方法设定参数或使用 paramCount 指定个数。
存在多个 IndexTypeCondition 时除了 order 只会生效最后一个。
- method
paramfun param(conditions: ObjectsConditions): IndexTypeCondition
变更记录
v1.0.0
添加
功能描述
设置
Method
参数条件。
特别注意
无参 Method 请使用 emptyParam 设置查找条件。
有参 Method 必须使用此方法设定参数或使用 paramCount 指定个数。
存在多个 IndexTypeCondition 时除了 order 只会生效最后一个。
- method
orderfun order(): IndexTypeCondition
变更记录
v1.0.0
添加
功能描述
顺序筛选字节码的下标。
- method
namefun name(value: String): IndexTypeCondition
变更记录
v1.0.0
添加
功能描述
设置
Method
名称。
特别注意
若不填写名称则必须存在一个其它条件。
存在多个 IndexTypeCondition 时除了 order 只会生效最后一个。
- method
namefun name(conditions: NameConditions): IndexTypeCondition
变更记录
v1.0.0
添加
功能描述
设置
Method
名称条件。
特别注意
若不填写名称则必须存在一个其它条件。
存在多个 IndexTypeCondition 时除了 order 只会生效最后一个。
- method
paramCountfun paramCount(num: Int): IndexTypeCondition
变更记录
v1.0.0
添加
功能描述
设置
Method
参数个数。
你可以不使用 param
指定参数类型而是仅使用此方法指定参数个数。
若参数个数小于零则忽略并使用 param
。
特别注意
存在多个 IndexTypeCondition 时除了 order 只会生效最后一个。
- method
paramCountfun paramCount(numRange: IntRange): IndexTypeCondition
变更记录
v1.0.0
添加
功能描述
设置
Method
参数个数范围。
你可以不使用 param
指定参数类型而是仅使用此方法指定参数个数范围。
特别注意
存在多个 IndexTypeCondition 时除了 order 只会生效最后一个。
- method
paramCountfun paramCount(conditions: CountConditions): IndexTypeCondition
变更记录
v1.0.0
添加
功能描述
设置
Method
参数个数条件。
你可以不使用 param
指定参数类型而是仅使用此方法指定参数个数条件。
特别注意
存在多个 IndexTypeCondition 时除了 order 只会生效最后一个。
- method
returnTypefun returnType(value: Any): IndexTypeCondition
变更记录
v1.0.0
添加
功能描述
设置
Method
返回值。
可不填写返回值。
特别注意
存在多个 IndexTypeCondition 时除了 order 只会生效最后一个。
- method
returnTypefun returnType(conditions: ObjectConditions): IndexTypeCondition
变更记录
v1.0.0
添加
功能描述
设置
Method
返回值条件。
可不填写返回值。
特别注意
存在多个 IndexTypeCondition 时除了 order 只会生效最后一个。
- method
superClassfun superClass(isOnlySuperClass: Boolean)
变更记录
v1.0.0
添加
功能描述
设置在
classSet
的所有父类中查找当前Method
。
注意
若当前 classSet 的父类较多可能会耗时,API 会自动循环到父类继承是 Any 前的最后一个类。
- class
RemedyPlaninner class RemedyPlan internal constructor()
变更记录
v1.0.0
添加
功能描述
Method
重查找实现类,可累计失败次数直到查找成功。
- method
methodinline fun method(initiate: MethodConditions): Result
变更记录
v1.0.0
添加
功能描述
创建需要重新查找的
Method
。
你可以添加多个备选 Method
,直到成功为止,若最后依然失败,将停止查找并输出错误日志。
- class
Resultinner class Result internal constructor()
变更记录
v1.0.0
添加
功能描述
RemedyPlan
结果实现类。
- method
onFindfun onFind(initiate: MutableList<Method>.() -> Unit)
变更记录
v1.0.0
添加
v1.0.3
修改
initiate
类型由 HashSet
修改为 MutableList
功能描述
当在
RemedyPlan
中找到结果时。
功能示例
你可以方便地对重查找的 Method
实现 onFind
方法。
示例如下
method {
// Your code here.
}.onFind {
// Your code here.
}
- class
Resultinner class Result internal constructor(internal val isNoSuch: Boolean, internal val throwable: Throwable?) : BaseResult
变更记录
v1.0.0
添加
功能描述
Method
查找结果实现类。
- method
resultinline fun result(initiate: Result.() -> Unit): Result
变更记录
v1.0.0
添加
功能描述
创建监听结果事件方法体。
功能示例
你可以使用 lambda 形式创建 Result
类。
示例如下
method {
// Your code here.
}.result {
get(instance).call()
all(instance)
remedys {}
onNoSuchMethod {}
}
- method
getfun get(instance: Any?): Instance
变更记录
v1.0.0
添加
功能描述
获得
Method
实例处理类。
若有多个 Method
结果只会返回第一个。
特别注意
若你设置了 remedys 请使用 wait 回调结果方法。
功能示例
你可以通过获得方法所在实例来执行 Method
。
示例如下
method {
// Your code here.
}.get(instance).call()
若当前为静态方法,你可以不设置实例。
示例如下
method {
// Your code here.
}.get().call()
- method
allfun all(instance: Any?): MutableList<Instance>
变更记录
v1.0.0
添加
v1.0.3
修改
返回值类型由 ArrayList
修改为 MutableList
功能描述
获得
Method
实例处理类数组。
返回全部查找条件匹配的多个 Method
实例结果。
功能示例
你可以通过此方法来获得当前条件结果中匹配的全部 Method
,其方法所在实例用法与 get
相同。
示例如下
method {
// Your code here.
}.all(instance).forEach { instance ->
instance.call(...)
}
- method
givefun give(): Method?
变更记录
v1.0.0
添加
功能描述
得到
Method
本身。
若有多个 Method
结果只会返回第一个。
在查找条件找不到任何结果的时候将返回 null
。
- method
giveAllfun giveAll(): MutableList<Method>
变更记录
v1.0.0
添加
v1.0.3
修改
返回值类型由 HashSet
修改为 MutableList
功能描述
得到
Method
本身数组。
返回全部查找条件匹配的多个 Method
实例。
在查找条件找不到任何结果的时候将返回空的 MutableList
。
- method
waitfun wait(instance: Any?, initiate: Instance.() -> Unit)
变更记录
v1.0.0
添加
功能描述
获得
Method
实例处理类,配合RemedyPlan
使用。
若有多个 Method
结果只会返回第一个。
特别注意
若你设置了 remedys 必须使用此方法才能获得结果。
若你没有设置 remedys 此方法将不会被回调。
- method
waitAllfun waitAll(instance: Any?, initiate: MutableList<Instance>.() -> Unit)
变更记录
v1.0.0
添加
v1.0.3
修改
initiate
类型由 ArrayList
修改为 MutableList
功能描述
获得
Method
实例处理类数组,配合RemedyPlan
使用。
返回全部查找条件匹配的多个 Method
实例结果。
特别注意
若你设置了 remedys 必须使用此方法才能获得结果。
若你没有设置 remedys 此方法将不会被回调。
- method
remedysinline fun remedys(initiate: RemedyPlan.() -> Unit): Result
变更记录
v1.0.0
添加
功能描述
创建
Method
重查找功能。
功能示例
当你遇到一种 Method
可能存在不同形式的存在时,可以使用 RemedyPlan
重新查找它,而没有必要使用 onNoSuchMethod
捕获异常二次查找 Method
。
若第一次查找失败了,你还可以在这里继续添加此方法体直到成功为止。
示例如下
method {
// Your code here.
}.remedys {
method {
// Your code here.
}
method {
// Your code here.
}
}
- method
onNoSuchMethodinline fun onNoSuchMethod(result: (Throwable) -> Unit): Result
变更记录
v1.0.0
添加
功能描述
监听找不到
Method
时。
只会返回第一次的错误信息,不会返回 RemedyPlan
的错误信息。
- method
ignoredfun ignored(): Result
变更记录
v1.0.0
添加
功能描述
忽略异常并停止打印任何错误日志。
注意
此时若要监听异常结果,你需要手动实现 onNoSuchMethod 方法。
- class
Instanceinner class Instance internal constructor(private val instance: Any?, private val method: Method?)
变更记录
v1.0.0
添加
功能描述
Method
实例处理类。
- method
callfun call(vararg args: Any?): Any?
变更记录
v1.0.0
添加
功能描述
执行
Method
,不指定返回值类型。
- method
invokefun <T> invoke(vararg args: Any?): T?
变更记录
v1.0.0
添加
功能描述
执行
Method
,指定T
返回值类型。
- method
bytefun byte(vararg args: Any?): Byte?
变更记录
v1.0.0
添加
功能描述
执行
Method
,指定 Byte 返回值类型。
- method
intfun int(vararg args: Any?): Int
变更记录
v1.0.0
添加
功能描述
执行
Method
,指定 Int 返回值类型。
- method
longfun long(vararg args: Any?): Long
变更记录
v1.0.0
添加
功能描述
执行
Method
,指定 Long 返回值类型。
- method
shortfun short(vararg args: Any?): Short
变更记录
v1.0.0
添加
功能描述
执行
Method
,指定 Short 返回值类型。
- method
doublefun double(vararg args: Any?): Double
变更记录
v1.0.0
添加
功能描述
执行
Method
,指定 Double 返回值类型。
- method
floatfun float(vararg args: Any?): Float
变更记录
v1.0.0
添加
功能描述
执行
Method
,指定 Float 返回值类型。
- method
stringfun string(vararg args: Any?): String
变更记录
v1.0.0
添加
功能描述
执行
Method
,指定 String 返回值类型。
- method
charfun char(vararg args: Any?): Char
变更记录
v1.0.0
添加
功能描述
执行
Method
,指定 Char 返回值类型。
- method
booleanfun boolean(vararg args: Any?): Boolean
变更记录
v1.0.0
添加
功能描述
执行
Method
,指定 Boolean 返回值类型。
- method
arrayinline fun <reified T> array(vararg args: Any?): Array<T>
变更记录
v1.0.0
添加
功能描述
执行
Method
,指定 Array 返回值类型。
- method
listinline fun <reified T> list(vararg args: Any?): List<T>
变更记录
v1.0.0
添加
功能描述
执行
Method
,指定 List 返回值类型。