Package org.miaixz.bus.core.lang.reflect.method

Class MethodInvoker

java.lang.Object

org.miaixz.bus.core.lang.reflect.method.MethodInvoker

All Implemented Interfaces:

Invoker

public class MethodInvoker
extends Object
implements Invoker

方法调用器，通过反射调用方法。

Since:

Java 17+

Author:

Kimi Liu

Constructor Summary

Constructors

Constructor	Description
MethodInvoker(Method method)	构造

Method Summary

Modifier and Type	Method	Description
Method	getMethod()	获取方法
String	getName()	获取调用方法的名称。
Type[]	getParamTypes()	获取方法参数类型
Type	getType()	获取调用方法的返回类型或参数类型或字段类型。
Class<?>	getTypeClass()	获取调用方法的返回类型或参数类型或字段类型。
<T> T	invoke(Object target, Object... args)	调用指定目标对象的方法。
static <T> T	invoke(Object object, Method method, Object... args)	执行接口或对象中的方法
static <T> T	invokeExact(Object object, Method method, Object... args)	执行接口或对象中的方法，参数类型不做转换，必须与方法参数类型完全匹配
static <T> T	invokeHandle(MethodHandle methodHandle, Object... args)	执行方法句柄，MethodHandle.invokeWithArguments(Object...)包装 非static方法需先调用MethodHandle.bindTo(Object)绑定执行对象。
<T> T	invokeStatic(Object... args)	执行静态方法
static MethodInvoker	of(Method method)	创建方法调用器
MethodInvoker	setCheckArgs(boolean checkArgs)	设置是否检查参数

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

MethodInvoker

public MethodInvoker(Method method)

构造

Parameters:

method - 方法

Method Details

of

public static MethodInvoker of(Method method)

创建方法调用器

Parameters:

method - 方法

Returns:

方法调用器

invoke

public static <T> T invoke(Object object,
 Method method,
 Object... args)
                    throws InternalException

执行接口或对象中的方法

 interface Duck {
     default String quack() {
         return "Quack";
     }
 }

 Duck duck = (Duck) Proxy.newProxyInstance(ClassKit.getClassLoader(), new Class[] { Duck.class },
         MethodInvoker::invoke);
 

Type Parameters:

T - 返回结果类型

Parameters:

object - 接口的子对象或代理对象

method - 方法

args - 参数，自动根据Method定义类型转换

Returns:

结果

Throws:

InternalException - 执行异常包装

invokeExact

public static <T> T invokeExact(Object object,
 Method method,
 Object... args)
                         throws InternalException

执行接口或对象中的方法，参数类型不做转换，必须与方法参数类型完全匹配

 interface Duck {
     default String quack() {
         return "Quack";
     }
 }

 Duck duck = (Duck) Proxy.newProxyInstance(MethodInvoker.getClassLoader(), new Class[] { Duck.class },
         MethodInvoker::invoke);
 

Type Parameters:

T - 返回结果类型

Parameters:

object - 接口的子对象或代理对象

method - 方法

args - 参数

Returns:

结果

Throws:

InternalException - 执行异常包装

getMethod

public Method getMethod()

获取方法

Returns:

方法

getParamTypes

public Type[] getParamTypes()

获取方法参数类型

Returns:

方法参数类型

getName

public String getName()

Description copied from interface: Invoker

获取调用方法的名称。

Specified by:

getName in interface Invoker

Returns:

调用方法的名称，作为字符串返回。

getType

public Type getType()

Description copied from interface: Invoker

获取调用方法的返回类型或参数类型或字段类型。

Specified by:

getType in interface Invoker

Returns:

调用方法的返回类型，作为Class对象返回。

getTypeClass

public Class<?> getTypeClass()

Description copied from interface: Invoker

获取调用方法的返回类型或参数类型或字段类型。

Specified by:

getTypeClass in interface Invoker

Returns:

调用方法的返回类型，作为Class对象返回。

setCheckArgs

public MethodInvoker setCheckArgs(boolean checkArgs)

设置是否检查参数

 1. 参数个数是否与方法参数个数一致
 2. 如果某个参数为null但是方法这个位置的参数为原始类型，则赋予原始类型默认值
 

Parameters:

checkArgs - 是否检查参数

Returns:

this

invoke

public <T> T invoke(Object target,
 Object... args)
             throws InternalException

Description copied from interface: Invoker

调用指定目标对象的方法。

Specified by:

invoke in interface Invoker

Type Parameters:

T - 返回类型

Parameters:

target - 目标对象，调用的方法属于该对象。

args - 方法调用的参数数组。

Returns:

方法的返回值，方法的返回类型可以是任意类型。

Throws:

InternalException

invokeHandle

public static <T> T invokeHandle(MethodHandle methodHandle,
 Object... args)

执行方法句柄，MethodHandle.invokeWithArguments(Object...)包装 非static方法需先调用MethodHandle.bindTo(Object)绑定执行对象。

需要注意的是，此处没有使用MethodHandle.invoke(Object...)，因为其参数第一个必须为对象或类。 MethodHandle.invokeWithArguments(Object...)只需传参数即可。

Type Parameters:

T - 返回值类型

Parameters:

methodHandle - MethodHandle

args - 方法参数值，支持子类转换和自动拆装箱

Returns:

方法返回值

invokeStatic

public <T> T invokeStatic(Object... args)
                   throws InternalException

执行静态方法

Type Parameters:

T - 对象类型

Parameters:

args - 参数对象

Returns:

结果

Throws:

InternalException - 多种异常包装