MethodFinder - class

class MethodFinder internal constructor(override val classSet: Class<*>) : MemberBaseFinder

变更记录

v1.0.0 添加

功能描述

Method 查找类。

可通过指定类型查找指定 Method 或一组 Method

name - field

var name: String

变更记录

v1.0.0 添加

功能描述

设置 Method 名称。

特别注意

若不填写名称则必须存在一个其它条件。

paramCount - field

var paramCount: Int

变更记录

v1.0.0 添加

功能描述

设置 Method 参数个数。

你可以不使用 param 指定参数类型而是仅使用此变量指定参数个数。

若参数个数小于零则忽略并使用 param

returnType - field

var returnType: Any?

变更记录

v1.0.0 添加

功能描述

设置 Method 返回值,可不填写返回值。

modifiers - method

fun modifiers(conditions: ModifierConditions): IndexTypeCondition

变更记录

v1.0.0 添加

功能描述

设置 Method 标识符筛选条件。

可不设置筛选条件。

特别注意

存在多个 IndexTypeCondition 时除了 order 只会生效最后一个。

emptyParam - method

fun emptyParam(): IndexTypeCondition

变更记录

v1.0.0 添加

功能描述

设置 Method 空参数、无参数。

param - method

fun param(vararg paramType: Any): IndexTypeCondition

变更记录

v1.0.0 添加

功能描述

设置 Method 参数。

如果同时使用了 paramCountparamType 的数量必须与 paramCount 完全匹配。

如果 Method 中存在一些无意义又很长的类型,你可以使用 VagueType 来替代它。

特别注意

无参 Method 请使用 emptyParam 设置查找条件。

有参 Method 必须使用此方法设定参数或使用 paramCount 指定个数。

存在多个 IndexTypeCondition 时除了 order 只会生效最后一个。

param - method

fun param(conditions: ObjectsConditions): IndexTypeCondition

变更记录

v1.0.0 添加

功能描述

设置 Method 参数条件。

特别注意

无参 Method 请使用 emptyParam 设置查找条件。

有参 Method 必须使用此方法设定参数或使用 paramCount 指定个数。

存在多个 IndexTypeCondition 时除了 order 只会生效最后一个。

order - method

fun order(): IndexTypeCondition

变更记录

v1.0.0 添加

功能描述

顺序筛选字节码的下标。

name - method

fun name(value: String): IndexTypeCondition

变更记录

v1.0.0 添加

功能描述

设置 Method 名称。

特别注意

若不填写名称则必须存在一个其它条件。

存在多个 IndexTypeCondition 时除了 order 只会生效最后一个。

name - method

fun name(conditions: NameConditions): IndexTypeCondition

变更记录

v1.0.0 添加

功能描述

设置 Method 名称条件。

特别注意

若不填写名称则必须存在一个其它条件。

存在多个 IndexTypeCondition 时除了 order 只会生效最后一个。

paramCount - method

fun paramCount(num: Int): IndexTypeCondition

变更记录

v1.0.0 添加

功能描述

设置 Method 参数个数。

你可以不使用 param 指定参数类型而是仅使用此方法指定参数个数。

若参数个数小于零则忽略并使用 param

特别注意

存在多个 IndexTypeCondition 时除了 order 只会生效最后一个。

paramCount - method

fun paramCount(numRange: IntRange): IndexTypeCondition

变更记录

v1.0.0 添加

功能描述

设置 Method 参数个数范围。

你可以不使用 param 指定参数类型而是仅使用此方法指定参数个数范围。

特别注意

存在多个 IndexTypeCondition 时除了 order 只会生效最后一个。

paramCount - method

fun paramCount(conditions: CountConditions): IndexTypeCondition

变更记录

v1.0.0 添加

功能描述

设置 Method 参数个数条件。

你可以不使用 param 指定参数类型而是仅使用此方法指定参数个数条件。

特别注意

存在多个 IndexTypeCondition 时除了 order 只会生效最后一个。

returnType - method

fun returnType(value: Any): IndexTypeCondition

变更记录

v1.0.0 添加

功能描述

设置 Method 返回值。

可不填写返回值。

特别注意

存在多个 IndexTypeCondition 时除了 order 只会生效最后一个。

returnType - method

fun returnType(conditions: ObjectConditions): IndexTypeCondition

变更记录

v1.0.0 添加

功能描述

设置 Method 返回值条件。

可不填写返回值。

特别注意

存在多个 IndexTypeCondition 时除了 order 只会生效最后一个。

superClass - method

fun superClass(isOnlySuperClass: Boolean)

变更记录

v1.0.0 添加

功能描述

设置在 classSet 的所有父类中查找当前 Method

注意

若当前 classSet 的父类较多可能会耗时,API 会自动循环到父类继承是 Any 前的最后一个类。

RemedyPlan - class

inner class RemedyPlan internal constructor()

变更记录

v1.0.0 添加

功能描述

Method 重查找实现类,可累计失败次数直到查找成功。

method - method

inline fun method(initiate: MethodConditions): Result

变更记录

v1.0.0 添加

功能描述

创建需要重新查找的 Method

你可以添加多个备选 Method,直到成功为止,若最后依然失败,将停止查找并输出错误日志。

Result - class

inner class Result internal constructor()

变更记录

v1.0.0 添加

功能描述

RemedyPlan 结果实现类。

onFind - method

fun 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.
}

Result - class

inner class Result internal constructor(internal val isNoSuch: Boolean, internal val throwable: Throwable?) : BaseResult

变更记录

v1.0.0 添加

功能描述

Method 查找结果实现类。

result - method

inline fun result(initiate: Result.() -> Unit): Result

变更记录

v1.0.0 添加

功能描述

创建监听结果事件方法体。

功能示例

你可以使用 lambda 形式创建 Result 类。

示例如下

method {
    // Your code here.
}.result {
    get(instance).call()
    all(instance)
    remedys {}
    onNoSuchMethod {}
}

get - method

fun 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()

all - method

fun 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(...)
}

give - method

fun give(): Method?

变更记录

v1.0.0 添加

功能描述

得到 Method 本身。

若有多个 Method 结果只会返回第一个。

在查找条件找不到任何结果的时候将返回 null

giveAll - method

fun giveAll(): MutableList<Method>

变更记录

v1.0.0 添加

v1.0.3 修改

返回值类型由 HashSet 修改为 MutableList

功能描述

得到 Method 本身数组。

返回全部查找条件匹配的多个 Method 实例。

在查找条件找不到任何结果的时候将返回空的 MutableList

wait - method

fun wait(instance: Any?, initiate: Instance.() -> Unit)

变更记录

v1.0.0 添加

功能描述

获得 Method 实例处理类,配合 RemedyPlan 使用。

若有多个 Method 结果只会返回第一个。

特别注意

若你设置了 remedys 必须使用此方法才能获得结果。

若你没有设置 remedys 此方法将不会被回调。

waitAll - method

fun waitAll(instance: Any?, initiate: MutableList<Instance>.() -> Unit)

变更记录

v1.0.0 添加

v1.0.3 修改

initiate 类型由 ArrayList 修改为 MutableList

功能描述

获得 Method 实例处理类数组,配合 RemedyPlan 使用。

返回全部查找条件匹配的多个 Method 实例结果。

特别注意

若你设置了 remedys 必须使用此方法才能获得结果。

若你没有设置 remedys 此方法将不会被回调。

remedys - method

inline 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.
    }
}

onNoSuchMethod - method

inline fun onNoSuchMethod(result: (Throwable) -> Unit): Result

变更记录

v1.0.0 添加

功能描述

监听找不到 Method 时。

只会返回第一次的错误信息,不会返回 RemedyPlan 的错误信息。

ignored - method

fun ignored(): Result

变更记录

v1.0.0 添加

功能描述

忽略异常并停止打印任何错误日志。

注意

此时若要监听异常结果,你需要手动实现 onNoSuchMethod 方法。

Instance - class

inner class Instance internal constructor(private val instance: Any?, private val method: Method?)

变更记录

v1.0.0 添加

功能描述

Method 实例处理类。

call - method

fun call(vararg args: Any?): Any?

变更记录

v1.0.0 添加

功能描述

执行 Method,不指定返回值类型。

invoke - method

fun <T> invoke(vararg args: Any?): T?

变更记录

v1.0.0 添加

功能描述

执行 Method,指定 T 返回值类型。

byte - method

fun byte(vararg args: Any?): Byte?

变更记录

v1.0.0 添加

功能描述

执行 Method,指定 Byte 返回值类型。

int - method

fun int(vararg args: Any?): Int

变更记录

v1.0.0 添加

功能描述

执行 Method,指定 Int 返回值类型。

long - method

fun long(vararg args: Any?): Long

变更记录

v1.0.0 添加

功能描述

执行 Method,指定 Long 返回值类型。

short - method

fun short(vararg args: Any?): Short

变更记录

v1.0.0 添加

功能描述

执行 Method,指定 Short 返回值类型。

double - method

fun double(vararg args: Any?): Double

变更记录

v1.0.0 添加

功能描述

执行 Method,指定 Double 返回值类型。

float - method

fun float(vararg args: Any?): Float

变更记录

v1.0.0 添加

功能描述

执行 Method,指定 Float 返回值类型。

string - method

fun string(vararg args: Any?): String

变更记录

v1.0.0 添加

功能描述

执行 Method,指定 String 返回值类型。

char - method

fun char(vararg args: Any?): Char

变更记录

v1.0.0 添加

功能描述

执行 Method,指定 Char 返回值类型。

boolean - method

fun boolean(vararg args: Any?): Boolean

变更记录

v1.0.0 添加

功能描述

执行 Method,指定 Boolean 返回值类型。

array - method

inline fun <reified T> array(vararg args: Any?): Array<T>

变更记录

v1.0.0 添加

功能描述

执行 Method,指定 Array 返回值类型。

list - method

inline fun <reified T> list(vararg args: Any?): List<T>

变更记录

v1.0.0 添加

功能描述

执行 Method,指定 List 返回值类型。