Summary: Inherited Constants | Methods | Inherited Methods | [Expand All]

public final class

Method

extends AccessibleObject
implements GenericDeclaration Member

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

Class Overview

This class represents a method. Information about the method can be accessed, and the method can be invoked dynamically.

Summary

[Expand]

Inherited Constants

From interface java.lang.reflect.Member

Public Methods
boolean	equals(Object object) Indicates whether or not the specified `object` is equal to this method.
Annotation[]	getDeclaredAnnotations() Returns, for this element, all annotations that are explicitly declared (not inherited).
Class<?>	getDeclaringClass() Returns the class that declares this method.
Object	getDefaultValue() Returns the default value for the annotation member represented by this method.
Class[]<?>	getExceptionTypes() Returns the exception types as an array of `Class` instances.
Type[]	getGenericExceptionTypes() Returns the exception types as an array of `Type` instances.
Type[]	getGenericParameterTypes() Returns the parameter types as an array of `Type` instances, in declaration order.
Type	getGenericReturnType() Returns the return type of this method as a `Type` instance.
int	getModifiers() Returns the modifiers for this method.
String	getName() Returns the name of the method represented by this `Method` instance.
Annotation[][]	getParameterAnnotations() Returns an array of arrays that represent the annotations of the formal parameters of this method.
Class[]<?>	getParameterTypes() Returns an array of `Class` objects associated with the parameter types of this method.
Class<?>	getReturnType() Returns the `Class` associated with the return type of this method.
TypeVariable[]<Method>	getTypeParameters() Returns the declared type parameters in declaration order.
int	hashCode() Returns an integer hash code for this method.
Object	invoke(Object receiver, Object... args) Returns the result of dynamically invoking this method.
boolean	isBridge() Indicates whether or not this method is a bridge.
boolean	isSynthetic() Indicates whether or not this method is synthetic.
boolean	isVarArgs() Indicates whether or not this method takes a variable number argument.
String	toGenericString() Returns the string representation of the method's declaration, including the type parameters.
String	toString() Returns a string containing a concise, human-readable description of this method.

[Expand]

Inherited Methods

From class java.lang.reflect.AccessibleObject

<T extends Annotation> T	getAnnotation(Class<T> annotationType) Returns, for this element, the annotation with the specified type, or `null` if no annotation with the specified type is present (including inherited annotations).
Annotation[]	getAnnotations() Returns, for this element, an array containing all annotations (including inherited annotations).
Annotation[]	getDeclaredAnnotations() Returns, for this element, all annotations that are explicitly declared (not inherited).
boolean	isAccessible() Indicates whether this object is accessible without security checks being performed.
boolean	isAnnotationPresent(Class<? extends Annotation> annotationType) Indicates whether or not this element has an annotation with the specified annotation type (including inherited annotations).
void	setAccessible(boolean flag) Attempts to set the value of the accessible flag.
static void	setAccessible(AccessibleObject[] objects, boolean flag) Attempts to set the value of the accessible flag for all the objects in the array provided.

From class java.lang.Object

Object	clone() Creates and returns a copy of this `Object`.
boolean	equals(Object o) Compares this instance with the specified object and indicates if they are equal.
void	finalize() Is called before the object's memory is being reclaimed by the VM.
final Class<? extends Object>	getClass() Returns the unique instance of `Class` which represents this object's class.
int	hashCode() Returns an integer hash code for this object.
final void	notify() Causes a thread which is waiting on this object's monitor (by means of calling one of the `wait()` methods) to be woken up.
final void	notifyAll() Causes all threads which are waiting on this object's monitor (by means of calling one of the `wait()` methods) to be woken up.
String	toString() Returns a string containing a concise, human-readable description of this object.
final void	wait(long millis, int nanos) Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object or until the specified timeout expires.
final void	wait(long millis) Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object or until the specified timeout expires.
final void	wait() Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object.

From interface java.lang.reflect.AnnotatedElement

From interface java.lang.reflect.GenericDeclaration

From interface java.lang.reflect.Member

Public Methods

public boolean equals (Object object)

Since: API Level 1

Indicates whether or not the specified object is equal to this method. To be equal, the specified object must be an instance of Method with the same declaring class and parameter types as this method.

Parameters

object	the object to compare

Returns

true if the specified object is equal to this method, false otherwise

public Annotation[] getDeclaredAnnotations ()

Since: API Level 1

Returns, for this element, all annotations that are explicitly declared (not inherited). If there are no declared annotations present, this method returns a zero length array.

Returns

an array of annotations declared for this element

public Class<?> getDeclaringClass ()

Since: API Level 1

Returns the class that declares this method.

Returns

the declaring class

public Object getDefaultValue ()

Since: API Level 1

Returns the default value for the annotation member represented by this method.

Returns

the default value, or null if none

Throws

TypeNotPresentException	if this annotation member is of type `Class` and no definition can be found

public Class[]<?> getExceptionTypes ()

Since: API Level 1

Returns the exception types as an array of Class instances. If this method has no declared exceptions, an empty array is returned.

Returns

the declared exception classes

public Type[] getGenericExceptionTypes ()

Since: API Level 1

Returns the exception types as an array of Type instances. If this method has no declared exceptions, an empty array will be returned.

Returns

an array of generic exception types

Throws

GenericSignatureFormatError	if the generic method signature is invalid
TypeNotPresentException	if any exception type points to a missing type
MalformedParameterizedTypeException	if any exception type points to a type that cannot be instantiated for some reason

public Type[] getGenericParameterTypes ()

Since: API Level 1

Returns the parameter types as an array of Type instances, in declaration order. If this method has no parameters, an empty array is returned.

Returns

the parameter types

Throws

GenericSignatureFormatError	if the generic method signature is invalid
TypeNotPresentException	if any parameter type points to a missing type
MalformedParameterizedTypeException	if any parameter type points to a type that cannot be instantiated for some reason

public Type getGenericReturnType ()

Since: API Level 1

Returns the return type of this method as a Type instance.

Returns

the return type of this method

Throws

GenericSignatureFormatError	if the generic method signature is invalid
TypeNotPresentException	if the return type points to a missing type
MalformedParameterizedTypeException	if the return type points to a type that cannot be instantiated for some reason

public int getModifiers ()

Since: API Level 1

Returns the modifiers for this method. The Modifier class should be used to decode the result.

Returns

the modifiers for this method

public String getName ()

Since: API Level 1

Returns the name of the method represented by this Method instance.

Returns

the name of this method

public Annotation[][] getParameterAnnotations ()

Since: API Level 1

Returns an array of arrays that represent the annotations of the formal parameters of this method. If there are no parameters on this method, then an empty array is returned. If there are no annotations set, then and array of empty arrays is returned.

Returns

an array of arrays of Annotation instances

public Class[]<?> getParameterTypes ()

Since: API Level 1

Returns an array of Class objects associated with the parameter types of this method. If the method was declared with no parameters, an empty array will be returned.

Returns

the parameter types

public Class<?> getReturnType ()

Since: API Level 1

Returns the Class associated with the return type of this method.

Returns

the return type

public TypeVariable[]<Method> getTypeParameters ()

Since: API Level 1

Returns the declared type parameters in declaration order. If there are no type parameters, this method returns a zero length array.

Returns

the declared type parameters in declaration order

public int hashCode ()

Since: API Level 1

Returns an integer hash code for this method. Objects which are equal return the same value for this method. The hash code for this Method is the hash code of the name of this method.

Returns

hash code for this method

public Object invoke (Object receiver, Object... args)

Since: API Level

Returns the result of dynamically invoking this method. This reproduces the effect of receiver.methodName(arg1, arg2, ... , argN) This method performs the following:

If this method is static, the receiver argument is ignored.
Otherwise, if the receiver is null, a NullPointerException is thrown.
If the receiver is not an instance of the declaring class of the method, an IllegalArgumentException is thrown.
If this Method object is enforcing access control (see AccessibleObject) and this method is not accessible from the current context, an IllegalAccessException is thrown.
If the number of arguments passed and the number of parameters do not match, an IllegalArgumentException is thrown.
For each argument passed:
- If the corresponding parameter type is a primitive type, the argument is unwrapped. If the unwrapping fails, an IllegalArgumentException is thrown.
- If the resulting argument cannot be converted to the parameter type via a widening conversion, an IllegalArgumentException is thrown.
If this method is static, it is invoked directly. If it is non-static, this method and the receiver are then used to perform a standard dynamic method lookup. The resulting method is then invoked.
If an exception is thrown during the invocation it is caught and wrapped in an InvocationTargetException. This exception is then thrown.
If the invocation completes normally, the return value itself is returned. If the method is declared to return a primitive type, the return value is first wrapped. If the return type is void, null is returned.

Parameters

receiver	the object on which to call this method
args	the arguments to the method

Returns

the new, initialized, object

Throws

NullPointerException	if the receiver is null for a non-static method
IllegalAccessException	if this method is not accessible
IllegalArgumentException	if an incorrect number of arguments are passed, the receiver is incompatible with the declaring class, or an argument could not be converted by a widening conversion
InvocationTargetException	if an exception was thrown by the invoked method

public boolean isBridge ()

Since: API Level 1

Indicates whether or not this method is a bridge.

Returns

true if this method is a bridge, false otherwise

public boolean isSynthetic ()

Since: API Level 1

Indicates whether or not this method is synthetic.

Returns

true if this method is synthetic, false otherwise

public boolean isVarArgs ()

Since: API Level 1

Indicates whether or not this method takes a variable number argument.

Returns

true if a vararg is declared, false otherwise

public String toGenericString ()

Since: API Level 1

Returns the string representation of the method's declaration, including the type parameters.

Returns

the string representation of this method

public String toString ()

Since: API Level 1

Returns a string containing a concise, human-readable description of this method. The format of the string is:

modifiers (if any)
return type or 'void'
declaring class name
'('
parameter types, separated by ',' (if any)
')'
'throws' plus exception types, separated by ',' (if any)

For example:

public native Object
 java.lang.Method.invoke(Object,Object) throws
 IllegalAccessException,IllegalArgumentException
 ,InvocationTargetException

Returns

a printable representation for this method

Interfaces

Classes

Exceptions

Errors

Method

Class Overview

Summary

Public Methods

public boolean equals (Object object)

Parameters

Returns

See Also

public Annotation[] getDeclaredAnnotations ()

Returns

public Class<?> getDeclaringClass ()

Returns

public Object getDefaultValue ()

Returns

Throws

public Class[]<?> getExceptionTypes ()

Returns

public Type[] getGenericExceptionTypes ()

Returns

Throws

public Type[] getGenericParameterTypes ()

Returns

Throws

public Type getGenericReturnType ()

Returns

Throws

public int getModifiers ()

Returns

See Also

public String getName ()

Returns

public Annotation[][] getParameterAnnotations ()

Returns

public Class[]<?> getParameterTypes ()

Returns

public Class<?> getReturnType ()

Returns

public TypeVariable[]<Method> getTypeParameters ()

Returns

public int hashCode ()

Returns

See Also

public Object invoke (Object receiver, Object... args)

Parameters

Returns

Throws

See Also

public boolean isBridge ()

Returns

public boolean isSynthetic ()

Returns

public boolean isVarArgs ()

Returns

public String toGenericString ()

Returns

public String toString ()

Returns