- class
ConstructorFinderclass ConstructorFinder internal constructor(override val classSet: Class<*>) : MemberBaseFinder
变更记录
v1.0.0
添加
功能描述
Constructor
查找类。
可通过指定类型查找指定 Constructor
或一组 Constructor
。
- field
paramCountvar paramCount: Int
变更记录
v1.0.0
添加
功能描述
设置
Constructor
参数个数。
你可以不使用 param
指定参数类型而是仅使用此变量指定参数个数。
若参数个数小于零则忽略并使用 param
。
- method
modifiersfun modifiers(conditions: ModifierConditions): IndexTypeCondition
变更记录
v1.0.0
添加
功能描述
设置
Constructor
标识符筛选条件。
可不设置筛选条件,默认模糊查找并取第一个匹配的 Constructor
。
特别注意
存在多个 IndexTypeCondition 时除了 order 只会生效最后一个。
- method
emptyParamfun emptyParam(): IndexTypeCondition
变更记录
v1.0.0
添加
功能描述
设置
Constructor
空参数、无参数。
- method
paramfun param(vararg paramType: Any): IndexTypeCondition
变更记录
v1.0.0
添加
功能描述
设置
Constructor
参数。
如果同时使用了 paramCount
则 paramType
的数量必须与 paramCount
完全匹配。
如果 Constructor
中存在一些无意义又很长的类型,你可以使用 VagueType 来替代它。
特别注意
无参 Constructor 请使用 emptyParam 设置查找条件。
有参 Constructor 必须使用此方法设定参数或使用 paramCount 指定个数。
存在多个 IndexTypeCondition 时除了 order 只会生效最后一个。
- method
paramfun param(conditions: ObjectsConditions): IndexTypeCondition
变更记录
v1.0.0
添加
功能描述
设置
Constructor
参数条件。
特别注意
无参 Constructor 请使用 emptyParam 设置查找条件。
有参 Constructor 必须使用此方法设定参数或使用 paramCount 指定个数。
存在多个 IndexTypeCondition 时除了 order 只会生效最后一个。
- method
paramCountfun paramCount(num: Int): IndexTypeCondition
变更记录
v1.0.0
添加
功能描述
设置
Constructor
参数个数。
你可以不使用 param
指定参数类型而是仅使用此方法指定参数个数。
若参数个数小于零则忽略并使用 param
。
特别注意
存在多个 IndexTypeCondition 时除了 order 只会生效最后一个。
- method
paramCountfun paramCount(numRange: IntRange): IndexTypeCondition
变更记录
v1.0.0
添加
功能描述
设置
Constructor
参数个数范围。
你可以不使用 param
指定参数类型而是仅使用此方法指定参数个数范围。
特别注意
存在多个 IndexTypeCondition 时除了 order 只会生效最后一个。
- method
paramCountfun paramCount(conditions: CountConditions): IndexTypeCondition
变更记录
v1.0.0
添加
功能描述
设置
Constructor
参数个数条件。
你可以不使用 param
指定参数类型而是仅使用此方法指定参数个数条件。
特别注意
存在多个 IndexTypeCondition 时除了 order 只会生效最后一个。
- method
superClassfun superClass(isOnlySuperClass: Boolean)
变更记录
v1.0.0
添加
功能描述
设置在
classSet
的所有父类中查找当前Constructor
。
注意
若当前 classSet 的父类较多可能会耗时,API 会自动循环到父类继承是 Any 前的最后一个类。
- class
RemedyPlaninner class RemedyPlan internal constructor()
变更记录
v1.0.0
添加
功能描述
Constructor
重查找实现类,可累计失败次数直到查找成功。
- method
constructorinline fun constructor(initiate: ConstructorConditions)
变更记录
v1.0.0
添加
功能描述
创建需要重新查找的
Constructor
。
你可以添加多个备选 Constructor
,直到成功为止,若最后依然失败,将停止查找并输出错误日志。
- class
Resultinner class Result internal constructor()
变更记录
v1.0.0
添加
功能描述
RemedyPlan
结果实现类。
- method
onFindfun onFind(initiate: MutableList<Constructor<*>>.() -> Unit)
变更记录
v1.0.0
添加
v1.0.3
修改
initiate
类型由 HashSet
修改为 MutableList
功能描述
当在
RemedyPlan
中找到结果时。
功能示例
你可以方便地对重查找的 Constructor
实现 onFind
方法。
示例如下
constructor {
// 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
添加
功能描述
Constructor
查找结果实现类。
- method
resultinline fun result(initiate: Result.() -> Unit): Result
变更记录
v1.0.0
添加
功能描述
创建监听结果事件方法体。
功能示例
你可以使用 lambda 形式创建 Result
类。
示例如下
constructor {
// Your code here.
}.result {
get().call()
all()
remedys {}
onNoSuchConstructor {}
}
- method
getfun get(): Instance
变更记录
v1.0.0
添加
功能描述
获得
Constructor
实例处理类。
若有多个 Constructor
结果只会返回第一个。
特别注意
若你设置了 remedys 请使用 wait 回调结果方法。
功能示例
你可以通过获得方法所在实例来执行构造方法创建新的实例对象。
示例如下
constructor {
// Your code here.
}.get().call()
你可以 cast
构造方法为指定类型的实例对象。
示例如下
constructor {
// Your code here.
}.get().newInstance<TestClass>()
特别注意
若构造方法含有参数则后方参数必填。
示例如下
constructor {
// Your code here.
}.get().newInstance<TestClass>("param1", "param2")
- method
allfun all(): MutableList<Instance>
变更记录
v1.0.0
添加
v1.0.3
修改
返回值类型由 ArrayList
修改为 MutableList
功能描述
获得
Constructor
实例处理类数组。
返回全部查找条件匹配的多个 Constructor
实例结果。
功能示例
你可以通过此方法来获得当前条件结果中匹配的全部 Constructor
。
示例如下
constructor {
// Your code here.
}.all().forEach { instance ->
instance.call(...)
}
- method
givefun give(): Constructor<*>?
变更记录
v1.0.0
添加
功能描述
得到
Constructor
本身。
若有多个 Constructor
结果只会返回第一个。
在查找条件找不到任何结果的时候将返回 null
。
- method
giveAllfun giveAll(): MutableList<Constructor<*>>
变更记录
v1.0.0
添加
v1.0.3
修改
返回值类型由 HashSet
修改为 MutableList
功能描述
得到
Constructor
本身数组。
返回全部查找条件匹配的多个 Constructor
实例。
在查找条件找不到任何结果的时候将返回空的 MutableList
。
- method
waitfun wait(initiate: Instance.() -> Unit)
变更记录
v1.0.0
添加
功能描述
获得
Constructor
实例处理类,配合RemedyPlan
使用。
若有多个 Constructor
结果只会返回第一个。
特别注意
若你设置了 remedys 必须使用此方法才能获得结果。
若你没有设置 remedys 此方法将不会被回调。
- method
waitAllfun waitAll(initiate: MutableList<Instance>.() -> Unit)
变更记录
v1.0.0
添加
v1.0.3
修改
initiate
类型由 ArrayList
修改为 MutableList
功能描述
获得
Constructor
实例处理类数组,配合RemedyPlan
使用。
返回全部查找条件匹配的多个 Constructor
实例结果。
特别注意
若你设置了 remedys 必须使用此方法才能获得结果。
若你没有设置 remedys 此方法将不会被回调。
- method
remedysinline fun remedys(initiate: RemedyPlan.() -> Unit): Result
变更记录
v1.0.0
添加
功能描述
创建
Constructor
重查找功能。
功能示例
当你遇到一种 Constructor
可能存在不同形式的存在时,可以使用 RemedyPlan
重新查找它,而没有必要使用 onNoSuchConstructor
捕获异常二次查找 Constructor
。
若第一次查找失败了,你还可以在这里继续添加此方法体直到成功为止。
示例如下
constructor {
// Your code here.
}.remedys {
constructor {
// Your code here.
}
constructor {
// Your code here.
}
}
- method
onNoSuchConstructorinline fun onNoSuchConstructor(result: (Throwable) -> Unit): Result
变更记录
v1.0.0
添加
功能描述
监听找不到
Constructor
时。
只会返回第一次的错误信息,不会返回 RemedyPlan
的错误信息。
- method
ignoredfun ignored(): Result
变更记录
v1.0.0
添加
功能描述
忽略异常并停止打印任何错误日志。
注意
此时若要监听异常结果,你需要手动实现 onNoSuchConstructor 方法。
- class
Instanceinner class Instance internal constructor(private val constructor: Constructor<*>?)
变更记录
v1.0.0
添加
功能描述
Constructor
实例处理类。
- method
callfun call(vararg args: Any?): Any?
变更记录
v1.0.0
添加
功能描述
执行
Constructor
创建目标实例,不指定目标实例类型。
- method
newInstancefun <T> newInstance(vararg args: Any?): T?
变更记录
v1.0.0
添加
功能描述
执行
Constructor
创建目标实例 ,指定T
目标实例类型。