groovy.lang

Class MetaMethod

java.lang.Object

org.codehaus.groovy.reflection.ParameterTypes

groovy.lang.MetaMethod

All Implemented Interfaces:

Cloneable

Direct Known Subclasses:

CachedMethod, CallSiteAwareMetaMethod, ClosureMetaMethod, ClosureStaticMetaMethod, GeneratedMetaMethod, MetaClassImpl.MetaConstructor, MixinInstanceMetaMethod, ReflectionMetaMethod, TransformMetaMethod

public abstract class MetaMethod
extends ParameterTypes
implements Cloneable

Represents a Method on a Java object a little like Method except without using reflection to invoke the method

Version:

$Revision$

Author:

James Strachan, Alex Tkachman

Field Summary

Fields inherited from class org.codehaus.groovy.reflection.ParameterTypes

isVargsMethod, nativeParamTypes, parameterTypes

Constructor Summary

Constructors

Constructor and Description
MetaMethod() Constructor for a metamethod with an empy parameter list
MetaMethod(Class[] pt) Constructor wit a list of parameter classes

Method Summary

Methods

Modifier and Type	Method and Description
void	checkParameters(Class[] arguments) Checks that the given parameters are valid to call this method
Object	clone()
Object	doMethodInvoke(Object object, Object[] argumentArray) Invokes the method this object represents.
protected static boolean	equal(CachedClass[] a, CachedClass[] b)
protected static boolean	equal(CachedClass[] a, Class[] b)
abstract CachedClass	getDeclaringClass() Gets the class where this method is declared
String	getDescriptor() Return a descriptior of this method based on the returntype and parameters of this method.
abstract int	getModifiers() Returns the modifiers for this method
String	getMopName()
abstract String	getName() Returns the name of the method represented by this class
abstract Class	getReturnType() Access the return type for this method
String	getSignature() Returns the signature of this method
abstract Object	invoke(Object object, Object[] arguments) Invoke this method
boolean	isAbstract() Returns wether or not this method is abstract.
boolean	isCacheable() Returns wether this object is cachable
boolean	isMethod(MetaMethod method) Returns true if this this metamethod represents the same method as the argument.
boolean	isPrivate() Returns wether or not this method is private.
boolean	isProtected() Returns wether or not this method is protected.
boolean	isPublic() Returns wether or not this method is public.
boolean	isSame(MetaMethod method)
boolean	isStatic() Returns wether or not this method is static.
RuntimeException	processDoMethodInvokeException(Exception e, Object object, Object[] argumentArray) This method is called when an exception occurs while invoking this method.
String	toString() Returns a string representation of this mehthod

Methods inherited from class org.codehaus.groovy.reflection.ParameterTypes

coerceArgumentsToClasses, correctArguments, getNativeParameterTypes, getParameterTypes, getPT, isValidExactMethod, isValidExactMethod, isValidMethod, isValidMethod, isVargsMethod, isVargsMethod, setParametersTypes

Methods inherited from class java.lang.Object

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

Constructor Detail

MetaMethod

public MetaMethod()

Constructor for a metamethod with an empy parameter list

MetaMethod

public MetaMethod(Class[] pt)

Constructor wit a list of parameter classes

Parameters:

pt - A list of parameters types

Method Detail

getModifiers

public abstract int getModifiers()

Returns the modifiers for this method

Returns:

modifiers as an int.

getName

public abstract String getName()

Returns the name of the method represented by this class

Returns:

name of this method

getReturnType

public abstract Class getReturnType()

Access the return type for this method

Returns:

the return type of this method

getDeclaringClass

public abstract CachedClass getDeclaringClass()

Gets the class where this method is declared

Returns:

class of this mehtod

invoke

public abstract Object invoke(Object object,
            Object[] arguments)

Invoke this method

Parameters:

object - The object this method should be involded on

arguments - The arguments for the menthod if applicable

Returns:

The return value of the invocation

checkParameters

public void checkParameters(Class[] arguments)

Checks that the given parameters are valid to call this method

Parameters:

arguments - the arguments to check

Throws:

IllegalArgumentException - if the parameters are not valid

isMethod

public boolean isMethod(MetaMethod method)

Returns true if this this metamethod represents the same method as the argument.

Parameters:

method - A metaMethod instance

Returns:

true if method is for the same method as this method, false otherwise.

equal

protected static boolean equal(CachedClass[] a,
            Class[] b)

equal

protected static boolean equal(CachedClass[] a,
            CachedClass[] b)

toString

public String toString()

Returns a string representation of this mehthod

Overrides:

toString in class Object

clone

public Object clone()

Overrides:

clone in class Object

isStatic

public boolean isStatic()

Returns wether or not this method is static.

Returns:

true if this method is static

isAbstract

public boolean isAbstract()

Returns wether or not this method is abstract.

Returns:

true if this method is abstract

isPrivate

public final boolean isPrivate()

Returns wether or not this method is private.

Returns:

true if this method is private

isProtected

public final boolean isProtected()

Returns wether or not this method is protected.

Returns:

true if this method is protected

isPublic

public final boolean isPublic()

Returns wether or not this method is public.

Returns:

true if this method is public

isSame

public final boolean isSame(MetaMethod method)

Parameters:

method - the method to compare against

Returns:

true if the given method has the same name, parameters, return type and modifiers but may be defined on another type

isCacheable

public boolean isCacheable()

Returns wether this object is cachable

getDescriptor

public String getDescriptor()

Return a descriptior of this method based on the returntype and parameters of this method.

getSignature

public String getSignature()

Returns the signature of this method

Returns:

The signature of this method

getMopName

public String getMopName()

processDoMethodInvokeException

public final RuntimeException processDoMethodInvokeException(Exception e,
                                              Object object,
                                              Object[] argumentArray)

This method is called when an exception occurs while invoking this method.

doMethodInvoke

public Object doMethodInvoke(Object object,
                    Object[] argumentArray)

Invokes the method this object represents. This method is not final but it should be overloaded very carefully and only by generated methods there is no guarantee that it will be called

Parameters:

object - The object the method is to be called at.

argumentArray - Arguments for the mehtod invokation.

Returns:

The return value of the invoked method.