|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectrailo.transformer.bytecode.reflection.ASMMethod
public abstract class ASMMethod
A 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.
Member
,
Class
,
Class.getMethods()
,
Class.getMethod(String, Class[])
,
Class.getDeclaredMethods()
,
Class.getDeclaredMethod(String, Class[])
Constructor Summary | |
---|---|
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. |
Method Summary | |
---|---|
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. |
Methods inherited from class java.lang.Object |
---|
getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
public ASMMethod(Class declaringClass, Class[] parameterTypes)
Method Detail |
---|
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.
equals
in class Object
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 call
obj
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
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |