java.lang.reflect
Class Method

java.lang.Object
  java.lang.reflect.AccessibleObject
      java.lang.reflect.Method

All Implemented Interfaces:

AnnotatedElement, GenericDeclaration, Member

public final class Method
extends AccessibleObject
implements GenericDeclaration, Member

Method enables reflection access to Java methods.

Field Summary

Fields inherited from interface java.lang.reflect.Member

DECLARED, PUBLIC

Method Summary

boolean	equals(Object obj) equals compares two methods.
<T extends Annotation> T	getAnnotation(Class<T> annotationType) getAnnotation NYI: COMMENT: JDK 1.5 method description
Annotation[]	getDeclaredAnnotations() getDeclaredAnnotations NYI: COMMENT: JDK 1.5 method description
Class<?>	getDeclaringClass() getDeclaringClass returns the class this method was declared in.
Object	getDefaultValue() getDefaultValue NYI: COMMENT: JDK 1.5 method description
Class<?>[]	getExceptionTypes() getExceptionTypes returns an array of all declared exceptions of this method.
Type[]	getGenericExceptionTypes() getGenericExceptionTypes NYI: COMMENT: JDK 1.5 method description
Type[]	getGenericParameterTypes() getGenericParameterTypes NYI: COMMENT: JDK 1.5 method description
Type	getGenericReturnType() getGenericReturnType NYI: COMMENT: JDK 1.5 method description
int	getModifiers() getModifiers returns the set of modifiers set for this method.
String	getName() getName returns the name of this method.
Annotation[][]	getParameterAnnotations() getParameterAnnotations NYI: COMMENT: JDK 1.5 method description
Class<?>[]	getParameterTypes() getParameterTypes returns an array with the type of all the parameters of this method.
Class<?>	getReturnType() getReturnType returns the return type of this method.
TypeVariable<?>[]	getTypeParameters() getTypeParameters NYI: COMMENT: JDK 1.5 method description
int	hashCode() hashCode returns a hash code for this field
Object	invoke(Object obj, Object... args) invoke executes this method with the given arguments
boolean	isBridge() isBridge NYI: COMMENT: JDK 1.5 method description
boolean	isSynthetic() isSynthetic NYI: COMMENT: JDK 1.5 method description
boolean	isVarArgs() isVarArgs NYI: COMMENT: JDK 1.5 method description
String	toGenericString() toGenericString NYI: COMMENT: JDK 1.5 method description
String	toString() toString converts this method into a string such as "public int java.lang.Integer.intValue()"

Methods inherited from class java.lang.reflect.AccessibleObject

getAnnotations, isAccessible, isAnnotationPresent, setAccessible, setAccessible

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Method Detail

getDeclaringClass

public Class<?> getDeclaringClass()

getDeclaringClass returns the class this method was declared in.

Specified by:

getDeclaringClass in interface Member

Returns:

The class declaring this method.

See Also:

Member.getDeclaringClass()

getName

public String getName()

getName returns the name of this method.

Specified by:

getName in interface Member

Returns:

the name as a java string.

getModifiers

public int getModifiers()

getModifiers returns the set of modifiers set for this method.

Specified by:

getModifiers in interface Member

Returns:

the modifiers.

See Also:

Modifier

getReturnType

public Class<?> getReturnType()

getReturnType returns the return type of this method.

Returns:

the type, either a Java class, an array type, a primitive type such as Integer.TYPE or Void.tYPE.

getParameterTypes

public Class<?>[] getParameterTypes()

getParameterTypes returns an array with the type of all the parameters of this method.

Returns:

an array of all parameters of this method.

getExceptionTypes

public Class<?>[] getExceptionTypes()

getExceptionTypes returns an array of all declared exceptions of this method.

Returns:

array of declared exceptions, never null.

equals

public boolean equals(Object obj)

equals compares two methods.

Overrides:

equals in class Object

Parameters:

obj - another method

Returns:

true iff obj is a method with the same declaringClass(), the same name, equal getParameterTypes() arrays and equal return type compared to this.

hashCode

public int hashCode()

hashCode returns a hash code for this field

Overrides:

hashCode in class Object

Returns:

getDeclaringClass().getName().hashCode() ^ getName().hashCode()

toString

public String toString()

toString converts this method into a string such as "public int java.lang.Integer.intValue()"

Overrides:

toString in class Object

Returns:

a string representation of this method.

invoke

public Object invoke(Object obj,
                     Object... args)
              throws IllegalAccessException,
                     IllegalArgumentException,
                     InvocationTargetException

invoke executes this method with the given arguments

Parameters:

obj - the target object of this method if this is an instance method. Ignored in case of a static method.

args - the arguments to be passed to this method.

Returns:

the, possibly boxed return value of this method, null for a method with void as return type.

Throws:

NullPointerException - if this is an instance method and obj is null.

IllegalAccessException - if the caller does not have the right to access this method.

InvocationTargetException - if this method returns with an exception, this exception is replaced by an instance of InvocationTargetException.

ExceptionInInitializerError - if this is a static method and initialization of the declaring class failed.

IllegalArgumentException

getTypeParameters

public TypeVariable<?>[] getTypeParameters()

getTypeParameters

NYI: COMMENT: JDK 1.5 method description

Specified by:

getTypeParameters in interface GenericDeclaration

Returns:

the parameter types for the method this object represents

Since:

1.5

getGenericReturnType

public Type getGenericReturnType()

getGenericReturnType

NYI: COMMENT: JDK 1.5 method description

Returns:

a Type object that represents the formal return type of the underlying method

Since:

1.5

getGenericExceptionTypes

public Type[] getGenericExceptionTypes()

getGenericExceptionTypes

NYI: COMMENT: JDK 1.5 method description

Returns:

an array of Types that represent the exception types thrown by the underlying method

Since:

1.5

getGenericParameterTypes

public Type[] getGenericParameterTypes()

getGenericParameterTypes

NYI: COMMENT: JDK 1.5 method description

Returns:

an array of Types that represent the formal parameter types of the underlying method, in declaration order

Since:

1.5

toGenericString

public String toGenericString()

toGenericString

NYI: COMMENT: JDK 1.5 method description

Returns:

a string describing this Method, include type parameters

Since:

1.5

isSynthetic

public boolean isSynthetic()

isSynthetic

NYI: COMMENT: JDK 1.5 method description

Specified by:

isSynthetic in interface Member

Returns:

true if and only if this method is a synthetic method as defined by the Java Language Specification.

Since:

1.5

isVarArgs

public boolean isVarArgs()

isVarArgs

NYI: COMMENT: JDK 1.5 method description

Returns:

true if an only if this method was declared to take a variable number of arguments.

Since:

1.5

isBridge

public boolean isBridge()

isBridge

NYI: COMMENT: JDK 1.5 method description

Returns:

true if and only if this method is a bridge method as defined by the Java Language Specification.

Since:

1.5

getAnnotation

public <T extends Annotation> T getAnnotation(Class<T> annotationType)

getAnnotation

NYI: COMMENT: JDK 1.5 method description

Specified by:

getAnnotation in interface AnnotatedElement

Overrides:

getAnnotation in class AccessibleObject

Parameters:

annotationType -

Returns:

his element's annotation for the specified annotation type if present on this element, else null

Since:

1.5

getDeclaredAnnotations

public Annotation[] getDeclaredAnnotations()

getDeclaredAnnotations

NYI: COMMENT: JDK 1.5 method description

Specified by:

getDeclaredAnnotations in interface AnnotatedElement

Overrides:

getDeclaredAnnotations in class AccessibleObject

Returns:

All annotations directly present on this element

Since:

1.5

getParameterAnnotations

public Annotation[][] getParameterAnnotations()

getParameterAnnotations

NYI: COMMENT: JDK 1.5 method description

Returns:

array of arrays that represent the annotations on the formal parameters, in declaration order, of the method represented by this Method object

Since:

1.5

getDefaultValue

public Object getDefaultValue()

getDefaultValue

NYI: COMMENT: JDK 1.5 method description

Returns:

the default value for the annotation member represented by this Method instance.

Since:

1.5