public abstract class ASMMethod extends Object
Method
provides information about, and access to, a single method
on a class or interface. The reflected method may be a class method
or an instance method (including an abstract method).
A Method
permits widening conversions to occur when matching the
actual parameters to invoke with the underlying method's formal
parameters, but it throws an IllegalArgumentException
if a
narrowing conversion would occur.
Constructor and Description |
---|
ASMMethod(Class declaringClass,
Class[] parameterTypes)
Package-private constructor used by ReflectAccess to enable
instantiation of these objects in Java code from the java.lang
package via sun.reflect.LangReflectAccess.
|
Modifier and Type | Method and Description |
---|---|
boolean |
equals(Object obj)
Compares this
Method against the specified object. |
Class<?> |
getDeclaringClass()
Returns the
Class object representing the class or interface
that declares the method represented by this Method object. |
Class<?>[] |
getExceptionTypes()
Returns an array of
Class objects that represent
the types of the exceptions declared to be thrown
by the underlying method
represented by this Method object. |
abstract int |
getModifiers()
Returns the Java language modifiers for the method represented
by this
Method object, as an integer. |
abstract String |
getName()
Returns the name of the method represented by this
Method
object, as a String . |
Class<?>[] |
getParameterTypes()
Returns an array of
Class objects that represent the formal
parameter types, in declaration order, of the method
represented by this Method object. |
Class<?> |
getReturnType()
Returns a
Class object that represents the formal return type
of the method represented by this Method object. |
abstract String |
getReturnTypeAsString() |
abstract Object |
invoke(Object obj,
Object[] args)
Invokes the underlying method represented by this
Method
object, on the specified object with the specified parameters. |
public Class<?> getDeclaringClass()
Class
object representing the class or interface
that declares the method represented by this Method
object.public abstract String getName()
Method
object, as a String
.public abstract int getModifiers()
Method
object, as an integer. The Modifier
class should
be used to decode the modifiers.Modifier
public Class<?> getReturnType()
Class
object that represents the formal return type
of the method represented by this Method
object.public abstract String getReturnTypeAsString()
public Class<?>[] getParameterTypes()
Class
objects that represent the formal
parameter types, in declaration order, of the method
represented by this Method
object. Returns an array of length
0 if the underlying method takes no parameters.public Class<?>[] getExceptionTypes()
Class
objects that represent
the types of the exceptions declared to be thrown
by the underlying method
represented by this Method
object. Returns an array of length
0 if the method declares no exceptions in its throws
clause.public boolean equals(Object obj)
Method
against the specified object. Returns
true if the objects are the same. Two Methods
are the same if
they were declared by the same class and have the same name
and formal parameter types and return type.public abstract Object invoke(Object obj, Object[] args) throws Throwable
Method
object, on the specified object with the specified parameters.
Individual parameters are automatically unwrapped to match
primitive formal parameters, and both primitive and reference
parameters are subject to method invocation conversions as
necessary.
If the underlying method is static, then the specified obj
argument is ignored. It may be null.
If the number of formal parameters required by the underlying method is
0, the supplied args
array may be of length 0 or null.
If the underlying method is an instance method, it is invoked using dynamic method lookup as documented in The Java Language Specification, Second Edition, section 15.12.4.4; in particular, overriding based on the runtime type of the target object will occur.
If the underlying method is static, the class that declared the method is initialized if it has not already been initialized.
If the method completes normally, the value it returns is returned to the caller of invoke; if the value has a primitive type, it is first appropriately wrapped in an object. However, if the value has the type of an array of a primitive type, the elements of the array are not wrapped in objects; in other words, an array of primitive type is returned. If the underlying method return type is void, the invocation returns null.
obj
- the object the underlying method is invoked fromargs
- the arguments used for the method callobj
with parameters
args
IllegalAccessException
- if this Method
object
enforces Java language access control and the underlying
method is inaccessible.IllegalArgumentException
- if the method is an
instance method and the specified object argument
is not an instance of the class or interface
declaring the underlying method (or of a subclass
or implementor thereof); if the number of actual
and formal parameters differ; if an unwrapping
conversion for primitive arguments fails; or if,
after possible unwrapping, a parameter value
cannot be converted to the corresponding formal
parameter type by a method invocation conversion.InvocationTargetException
- if the underlying method
throws an exception.NullPointerException
- if the specified object is null
and the method is an instance method.ExceptionInInitializerError
- if the initialization
provoked by this method fails.Throwable
Copyright © 2015 Lucee