groovy.lang

Class MetaClassImpl

java.lang.Object

groovy.lang.MetaClassImpl

All Implemented Interfaces:

MetaClass, MetaObjectProtocol, MutableMetaClass

Direct Known Subclasses:

ClosureMetaClass, ExpandoMetaClass, ProxyMetaClass

public class MetaClassImpl
extends java.lang.Object
implements MetaClass, MutableMetaClass

Allows methods to be dynamically added to existing classes at runtime

See Also:

MetaClass

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	MetaClassImpl.Index
static class	MetaClassImpl.MetaConstructor This is a helper class introduced in Groovy 2.1.0, which is used only by indy.

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.Object[]	EMPTY_ARGUMENTS
protected MetaMethod	getPropertyMethod
protected static java.lang.String	INVOKE_METHOD_METHOD
protected MetaMethod	invokeMethodMethod
protected boolean	isGroovyObject
protected boolean	isMap
protected MetaMethodIndex	metaMethodIndex
protected static java.lang.String	METHOD_MISSING
protected static java.lang.String	PROPERTY_MISSING
protected MetaClassRegistry	registry
protected MetaMethod	setPropertyMethod
protected static java.lang.String	STATIC_METHOD_MISSING
protected static java.lang.String	STATIC_PROPERTY_MISSING
protected CachedClass	theCachedClass
protected java.lang.Class	theClass

Constructor Summary

Constructors

Constructor and Description
MetaClassImpl(java.lang.Class theClass)
MetaClassImpl(java.lang.Class theClass, MetaMethod[] add)
MetaClassImpl(MetaClassRegistry registry, java.lang.Class theClass)
MetaClassImpl(MetaClassRegistry registry, java.lang.Class theClass, MetaMethod[] add)

Method Summary

Methods

Modifier and Type	Method and Description
void	addMetaBeanProperty(MetaBeanProperty mp) Adds a new MetaBeanProperty to this MetaClass
void	addMetaMethod(MetaMethod method) adds a MetaMethod to this class.
protected void	addMetaMethodToIndex(MetaMethod method, MetaMethodIndex.Header header)
void	addNewInstanceMethod(java.lang.reflect.Method method) adds a new instance method to this MetaClass.
void	addNewStaticMethod(java.lang.reflect.Method method) adds a new static method to this MetaClass.
protected void	applyPropertyDescriptors(java.beans.PropertyDescriptor[] propertyDescriptors)
protected void	checkIfGroovyObjectMethod(MetaMethod metaMethod) Checks if the metaMethod is a method from the GroovyObject interface such as setProperty, getProperty and invokeMethod
protected void	checkInitalised() checks if the initialisation of the class id complete.
protected java.lang.Object	chooseMethod(java.lang.String methodName, java.lang.Object methodOrList, java.lang.Class[] arguments) Chooses the correct method to use from a list of methods which match by name.
protected void	clearInvocationCaches() remove all method call cache entries.
CallSite	createConstructorSite(CallSite site, java.lang.Object[] args)
CallSite	createPogoCallCurrentSite(CallSite site, java.lang.Class sender, java.lang.Object[] args)
CallSite	createPogoCallSite(CallSite site, java.lang.Object[] args)
CallSite	createPojoCallSite(CallSite site, java.lang.Object receiver, java.lang.Object[] args)
CallSite	createStaticSite(CallSite site, java.lang.Object[] args)
protected void	dropMethodCache(java.lang.String name)
protected void	dropStaticMethodCache(java.lang.String name)
protected static MetaMethod	findMethodInClassHierarchy(java.lang.Class instanceKlazz, java.lang.String methodName, java.lang.Class[] arguments, MetaClass metaClass)
protected MetaMethod	findMixinMethod(java.lang.String methodName, java.lang.Class[] arguments)
protected static MetaMethod	findOwnMethod(java.lang.Class instanceKlazz, java.lang.String methodName, java.lang.Class[] arguments, MetaClass metaClass, MetaMethod method)
protected MetaBeanProperty	findPropertyInClassHierarchy(java.lang.String propertyName, CachedClass theClass)
MetaMethod[]	getAdditionalMetaMethods()
java.lang.Object	getAttribute(java.lang.Class sender, java.lang.Object receiver, java.lang.String messageName, boolean useSuper) Retrieves the value of an attribute (field).
java.lang.Object	getAttribute(java.lang.Class sender, java.lang.Object object, java.lang.String attribute, boolean useSuper, boolean fromInsideClass) Looks up the given attribute (field) on the given object
java.lang.Object	getAttribute(java.lang.Object object, java.lang.String attribute) Retrieves an attribute of an instance of the class returned by the getTheClass() method.
ClassInfo	getClassInfo()
ClassNode	getClassNode() Obtains a reference to the original AST for the MetaClass if it is available at runtime
MetaProperty	getEffectiveGetMetaProperty(java.lang.Class sender, java.lang.Object object, java.lang.String name, boolean useSuper)
MetaMethod	getMetaMethod(java.lang.String name, java.lang.Object[] argTypes) Retrieves an instance MetaMethod for the given name and argument values, using the types of the argument values to establish the chosen MetaMethod
java.util.List<MetaMethod>	getMetaMethods() Retrieves a list of MetaMethods held by this class
MetaProperty	getMetaProperty(java.lang.String name) Returns a MetaProperty for the given name or null if it doesn't exist
java.util.List<MetaMethod>	getMethods() Retrieves a list of MetaMethods held by the class
MetaMethod	getMethodWithCaching(java.lang.Class sender, java.lang.String methodName, java.lang.Object[] arguments, boolean isCallToSuper)
MetaMethod	getMethodWithoutCaching(java.lang.Class sender, java.lang.String methodName, java.lang.Class[] arguments, boolean isCallToSuper)
java.util.List<MetaProperty>	getProperties() Get all the properties defined for this type
java.lang.Object	getProperty(java.lang.Class sender, java.lang.Object object, java.lang.String name, boolean useSuper, boolean fromInsideClass) Retrieves a property on the given receiver for the specified arguments.
java.lang.Object	getProperty(java.lang.Object object, java.lang.String property) Retrieves a property of an instance of the class returned by the getTheClass() method.
MetaClassRegistry	getRegistry()
MetaMethod	getStaticMetaMethod(java.lang.String name, java.lang.Object[] argTypes) Retrieves a static MetaMethod for the given name and argument values, using the types of the arguments to establish the chosen MetaMethod
protected java.lang.Object	getSubclassMetaMethods(java.lang.String methodName)
protected java.util.LinkedList<CachedClass>	getSuperClasses()
CachedClass	getTheCachedClass()
java.lang.Class	getTheClass() Retrieves that Java Class that the attached Meta behaviours apply to
int	getVersion()
MetaProperty	hasProperty(java.lang.Object obj, java.lang.String name) Returns true of the implementing MetaClass has a property of the given name Note that this method will only return true for realised properties and does not take into account implementation of getProperty or propertyMissing
void	incVersion()
void	initialize() complete the initialisation process.
java.lang.Object	invokeConstructor(java.lang.Object[] arguments) Invokes a constructor for the given arguments.
java.lang.Object	invokeMethod(java.lang.Class sender, java.lang.Object object, java.lang.String methodName, java.lang.Object[] originalArguments, boolean isCallToSuper, boolean fromInsideClass) Invokes the given method on the object.
java.lang.Object	invokeMethod(java.lang.Object object, java.lang.String methodName, java.lang.Object arguments) Invokes a method on the given object, with the given name and single argument.
java.lang.Object	invokeMethod(java.lang.Object object, java.lang.String methodName, java.lang.Object[] originalArguments) Invokes the given method on the object.
java.lang.Object	invokeMissingMethod(java.lang.Object instance, java.lang.String methodName, java.lang.Object[] arguments) Attempts to invoke the methodMissing method otherwise throws a MissingMethodException
java.lang.Object	invokeMissingProperty(java.lang.Object instance, java.lang.String propertyName, java.lang.Object optionalValue, boolean isGetter) Invokes the propertyMissing method otherwise throws a MissingPropertyException
java.lang.Object	invokeStaticMethod(java.lang.Object object, java.lang.String methodName, java.lang.Object[] arguments) Invokes a static method on the given Object with the given name and arguments.
protected java.lang.Object	invokeStaticMissingProperty(java.lang.Object instance, java.lang.String propertyName, java.lang.Object optionalValue, boolean isGetter) Hook to deal with the case of MissingProperty for static properties.
boolean	isGroovyObject()
protected boolean	isInitialized()
boolean	isModified() Return whether the MetaClass has been modified or not
protected void	onGetPropertyFoundInHierarchy(MetaMethod method)
protected void	onInvokeMethodFoundInHierarchy(MetaMethod method)
protected void	onMixinMethodFound(MetaMethod method)
protected void	onSetPropertyFoundInHierarchy(MetaMethod method)
protected void	onSuperMethodFoundInHierarchy(MetaMethod method)
protected void	onSuperPropertyFoundInHierarchy(MetaBeanProperty property)
MetaMethod	pickMethod(java.lang.String methodName, java.lang.Class[] arguments) Selects a method by name and argument classes.
java.util.List	respondsTo(java.lang.Object obj, java.lang.String name) Returns an object satisfying Groovy truth if the implementing MetaClass responds to a method with the given name regardless of arguments.
java.util.List	respondsTo(java.lang.Object obj, java.lang.String name, java.lang.Object[] argTypes) Returns an object satisfying Groovy truth if the implementing MetaClass responds to a method with the given name and arguments types.
java.lang.reflect.Constructor	retrieveConstructor(java.lang.Class[] arguments)
MetaMethod	retrieveConstructor(java.lang.Object[] arguments) This is a helper method added in Groovy 2.1.0, which is used only by indy.
MetaMethod	retrieveStaticMethod(java.lang.String methodName, java.lang.Object[] arguments)
int	selectConstructorAndTransformArguments(int numberOfConstructors, java.lang.Object[] arguments) Internal method to support Groovy runtime.
void	setAttribute(java.lang.Class sender, java.lang.Object object, java.lang.String attribute, java.lang.Object newValue, boolean useSuper, boolean fromInsideClass) Sets the given attribute (field) on the given object
void	setAttribute(java.lang.Object object, java.lang.String attribute, java.lang.Object newValue) Sets an attribute of an instance of the class returned by the getTheClass() method.
void	setProperties(java.lang.Object bean, java.util.Map map) Sets a number of bean properties from the given Map where the keys are the String names of properties and the values are the values of the properties to set
void	setProperty(java.lang.Class sender, java.lang.Object object, java.lang.String name, java.lang.Object newValue, boolean useSuper, boolean fromInsideClass) Sets the property value on an object
void	setProperty(java.lang.Object object, java.lang.String property, java.lang.Object newValue) Sets a property of an instance of the class returned by the getTheClass() method.
java.lang.String	toString()

Methods inherited from class java.lang.Object

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

Field Detail

STATIC_METHOD_MISSING

protected static final java.lang.String STATIC_METHOD_MISSING

See Also:

Constant Field Values

STATIC_PROPERTY_MISSING

protected static final java.lang.String STATIC_PROPERTY_MISSING

See Also:

Constant Field Values

METHOD_MISSING

protected static final java.lang.String METHOD_MISSING

See Also:

Constant Field Values

PROPERTY_MISSING

protected static final java.lang.String PROPERTY_MISSING

See Also:

Constant Field Values

INVOKE_METHOD_METHOD

protected static final java.lang.String INVOKE_METHOD_METHOD

See Also:

Constant Field Values

theClass

protected final java.lang.Class theClass

theCachedClass

protected final CachedClass theCachedClass

getPropertyMethod

protected MetaMethod getPropertyMethod

invokeMethodMethod

protected MetaMethod invokeMethodMethod

setPropertyMethod

protected MetaMethod setPropertyMethod

registry

protected MetaClassRegistry registry

isGroovyObject

protected final boolean isGroovyObject

isMap

protected final boolean isMap

EMPTY_ARGUMENTS

public static final java.lang.Object[] EMPTY_ARGUMENTS

metaMethodIndex

protected final MetaMethodIndex metaMethodIndex

Constructor Detail

MetaClassImpl

public MetaClassImpl(java.lang.Class theClass,
             MetaMethod[] add)

MetaClassImpl

public MetaClassImpl(java.lang.Class theClass)

MetaClassImpl

public MetaClassImpl(MetaClassRegistry registry,
             java.lang.Class theClass,
             MetaMethod[] add)

MetaClassImpl

public MetaClassImpl(MetaClassRegistry registry,
             java.lang.Class theClass)

Method Detail

getTheCachedClass

public final CachedClass getTheCachedClass()

getRegistry

public MetaClassRegistry getRegistry()

respondsTo

public java.util.List respondsTo(java.lang.Object obj,
                        java.lang.String name,
                        java.lang.Object[] argTypes)

Description copied from interface: MetaObjectProtocol

Returns an object satisfying Groovy truth if the implementing MetaClass responds to a method with the given name and arguments types.

Note that this method's return value is based on realised methods and does not take into account objects or classes that implement invokeMethod or methodMissing

This method is "safe" in that it will always return a value and never throw an exception

Specified by:

respondsTo in interface MetaObjectProtocol

Parameters:

obj - The object to inspect

name - The name of the method of interest

argTypes - The argument types to match against

Returns:

A List of MetaMethods matching the argument types which will be empty if no matching methods exist

See Also:

MetaObjectProtocol.respondsTo(Object, String, Object[])

respondsTo

public java.util.List respondsTo(java.lang.Object obj,
                        java.lang.String name)

Description copied from interface: MetaObjectProtocol

Returns an object satisfying Groovy truth if the implementing MetaClass responds to a method with the given name regardless of arguments. In other words this method will return for foo() and foo(String).

Note that this method's return value is based on realised methods and does not take into account objects or classes that implement invokeMethod or methodMissing

This method is "safe" in that it will always return a value and never throw an exception

Specified by:

respondsTo in interface MetaObjectProtocol

Parameters:

obj - The object to inspect

name - The name of the method of interest

Returns:

A List of MetaMethods which will be empty if no methods with the given name exist

See Also:

MetaObjectProtocol.respondsTo(Object, String)

hasProperty

public MetaProperty hasProperty(java.lang.Object obj,
                       java.lang.String name)

Description copied from interface: MetaObjectProtocol

Returns true of the implementing MetaClass has a property of the given name

Note that this method will only return true for realised properties and does not take into account implementation of getProperty or propertyMissing

Specified by:

hasProperty in interface MetaObjectProtocol

Parameters:

obj - The object to inspect

name - The name of the property

Returns:

The MetaProperty or null if it doesn't exist

See Also:

MetaObjectProtocol.hasProperty(Object,String)

getMetaProperty

public MetaProperty getMetaProperty(java.lang.String name)

Description copied from interface: MetaObjectProtocol

Returns a MetaProperty for the given name or null if it doesn't exist

Specified by:

getMetaProperty in interface MetaObjectProtocol

Parameters:

name - The name of the MetaProperty

Returns:

A MetaProperty or null

See Also:

MetaObjectProtocol.getMetaProperty(String)

getStaticMetaMethod

public MetaMethod getStaticMetaMethod(java.lang.String name,
                             java.lang.Object[] argTypes)

Description copied from interface: MetaObjectProtocol

Retrieves a static MetaMethod for the given name and argument values, using the types of the arguments to establish the chosen MetaMethod

Specified by:

getStaticMetaMethod in interface MetaObjectProtocol

Parameters:

name - The name of the MetaMethod

argTypes - The argument types

Returns:

A MetaMethod or null if it doesn't exist

See Also:

MetaObjectProtocol.getStaticMetaMethod(String, Object[])

getMetaMethod

public MetaMethod getMetaMethod(java.lang.String name,
                       java.lang.Object[] argTypes)

Description copied from interface: MetaObjectProtocol

Retrieves an instance MetaMethod for the given name and argument values, using the types of the argument values to establish the chosen MetaMethod

Specified by:

getMetaMethod in interface MetaObjectProtocol

Parameters:

name - The name of the MetaMethod

argTypes - Array containing - 1) the argument values (using which their types are then inferred), or 2) the corresponding argument types

Returns:

A MetaMethod or null if it doesn't exist

See Also:

MetaObjectProtocol.getMetaMethod(String, Object[])

getTheClass

public java.lang.Class getTheClass()

Description copied from interface: MetaObjectProtocol

Retrieves that Java Class that the attached Meta behaviours apply to

Specified by:

getTheClass in interface MetaObjectProtocol

Returns:

The java.lang.Class instance

isGroovyObject

public boolean isGroovyObject()

getSuperClasses

protected java.util.LinkedList<CachedClass> getSuperClasses()

isModified

public boolean isModified()

Description copied from interface: MutableMetaClass

Return whether the MetaClass has been modified or not

Specified by:

isModified in interface MutableMetaClass

Returns:

True if it has

addNewInstanceMethod

public void addNewInstanceMethod(java.lang.reflect.Method method)

Description copied from interface: MutableMetaClass

adds a new instance method to this MetaClass. Instance methods are able to overwrite the original methods of the class. Calling this method should not be done after initialise was called.

Specified by:

addNewInstanceMethod in interface MutableMetaClass

Parameters:

method - the method to be added

addNewStaticMethod

public void addNewStaticMethod(java.lang.reflect.Method method)

Description copied from interface: MutableMetaClass

adds a new static method to this MetaClass. This is only possible as long as initialise was not called.

Specified by:

addNewStaticMethod in interface MutableMetaClass

Parameters:

method - the method to be added

invokeMethod

public java.lang.Object invokeMethod(java.lang.Object object,
                            java.lang.String methodName,
                            java.lang.Object arguments)

Description copied from interface: MetaObjectProtocol

Invokes a method on the given object, with the given name and single argument.

Specified by:

invokeMethod in interface MetaObjectProtocol

Parameters:

object - The Object to invoke the method on

methodName - The name of the method

arguments - The argument to the method

Returns:

The return value of the method which is null if the return type is void

See Also:

MetaObjectProtocol.invokeMethod(Object, String, Object[])

invokeMissingMethod

public java.lang.Object invokeMissingMethod(java.lang.Object instance,
                                   java.lang.String methodName,
                                   java.lang.Object[] arguments)

Description copied from interface: MetaClass

Attempts to invoke the methodMissing method otherwise throws a MissingMethodException

Specified by:

invokeMissingMethod in interface MetaClass

Parameters:

instance - The instance to invoke methodMissing on

methodName - The name of the method

arguments - The arguments to the method

Returns:

The results of methodMissing or throws MissingMethodException

See Also:

MissingMethodException

invokeMissingProperty

public java.lang.Object invokeMissingProperty(java.lang.Object instance,
                                     java.lang.String propertyName,
                                     java.lang.Object optionalValue,
                                     boolean isGetter)

Description copied from interface: MetaClass

Invokes the propertyMissing method otherwise throws a MissingPropertyException

Specified by:

invokeMissingProperty in interface MetaClass

Parameters:

instance - The instance of the class

propertyName - The name of the property

optionalValue - The value of the property which could be null in the case of a getter

isGetter - Whether the missing property event was the result of a getter or a setter

Returns:

The result of the propertyMissing method or throws MissingPropertyException

onSuperPropertyFoundInHierarchy

protected void onSuperPropertyFoundInHierarchy(MetaBeanProperty property)

onMixinMethodFound

protected void onMixinMethodFound(MetaMethod method)

onSuperMethodFoundInHierarchy

protected void onSuperMethodFoundInHierarchy(MetaMethod method)

onInvokeMethodFoundInHierarchy

protected void onInvokeMethodFoundInHierarchy(MetaMethod method)

onSetPropertyFoundInHierarchy

protected void onSetPropertyFoundInHierarchy(MetaMethod method)

onGetPropertyFoundInHierarchy

protected void onGetPropertyFoundInHierarchy(MetaMethod method)

invokeStaticMissingProperty

protected java.lang.Object invokeStaticMissingProperty(java.lang.Object instance,
                                           java.lang.String propertyName,
                                           java.lang.Object optionalValue,
                                           boolean isGetter)

Hook to deal with the case of MissingProperty for static properties. The method will look attempt to look up "propertyMissing" handlers and invoke them otherwise thrown a MissingPropertyException

Parameters:

instance - The instance

propertyName - The name of the property

optionalValue - The value in the case of a setter

isGetter - True if its a getter

Returns:

The value in the case of a getter or a MissingPropertyException

invokeMethod

public java.lang.Object invokeMethod(java.lang.Object object,
                            java.lang.String methodName,
                            java.lang.Object[] originalArguments)

Invokes the given method on the object.

Specified by:

invokeMethod in interface MetaObjectProtocol

Parameters:

object - The instance which the method is invoked on

methodName - The name of the method

originalArguments - The arguments to the method

Returns:

The return value of the method which is null if the return type is void

See Also:

MissingMethodException

invokeMethod

public java.lang.Object invokeMethod(java.lang.Class sender,
                            java.lang.Object object,
                            java.lang.String methodName,
                            java.lang.Object[] originalArguments,
                            boolean isCallToSuper,
                            boolean fromInsideClass)

Invokes the given method on the object.

Specified by:

invokeMethod in interface MetaClass

Parameters:

sender - The java.lang.Class instance that invoked the method

object - The object which the method was invoked on

methodName - The name of the method

originalArguments - The arguments to the method

isCallToSuper - Whether the method is a call to a super class method

fromInsideClass - Whether the call was invoked from the inside or the outside of the class

Returns:

The return value of the method

getMethodWithCaching

public MetaMethod getMethodWithCaching(java.lang.Class sender,
                              java.lang.String methodName,
                              java.lang.Object[] arguments,
                              boolean isCallToSuper)

retrieveConstructor

public java.lang.reflect.Constructor retrieveConstructor(java.lang.Class[] arguments)

retrieveStaticMethod

public MetaMethod retrieveStaticMethod(java.lang.String methodName,
                              java.lang.Object[] arguments)

getMethodWithoutCaching

public MetaMethod getMethodWithoutCaching(java.lang.Class sender,
                                 java.lang.String methodName,
                                 java.lang.Class[] arguments,
                                 boolean isCallToSuper)

invokeStaticMethod

public java.lang.Object invokeStaticMethod(java.lang.Object object,
                                  java.lang.String methodName,
                                  java.lang.Object[] arguments)

Description copied from interface: MetaObjectProtocol

Invokes a static method on the given Object with the given name and arguments.

The Object can either be an instance of the class that this MetaObjectProtocol instance applies to or the java.lang.Class instance itself. If a method cannot be invoked a MissingMethodException is will be thrown

Specified by:

invokeStaticMethod in interface MetaObjectProtocol

Parameters:

object - An instance of the class returned by the getTheClass() method or the class itself

methodName - The name of the method

arguments - The arguments to the method

Returns:

The return value of the method which is null if the return type is void

See Also:

MissingMethodException

invokeConstructor

public java.lang.Object invokeConstructor(java.lang.Object[] arguments)

Description copied from interface: MetaObjectProtocol

Invokes a constructor for the given arguments. The MetaClass will attempt to pick the best argument which matches the types of the objects passed within the arguments array

Specified by:

invokeConstructor in interface MetaObjectProtocol

Parameters:

arguments - The arguments to the constructor

Returns:

An instance of the java.lang.Class that this MetaObjectProtocol object applies to

selectConstructorAndTransformArguments

public int selectConstructorAndTransformArguments(int numberOfConstructors,
                                         java.lang.Object[] arguments)

Description copied from interface: MetaClass

Internal method to support Groovy runtime. Not for client usage.

Specified by:

selectConstructorAndTransformArguments in interface MetaClass

Parameters:

numberOfConstructors - The number of constructors

arguments - The arguments

Returns:

selected index

checkInitalised

protected void checkInitalised()

checks if the initialisation of the class id complete. This method should be called as a form of assert, it is no way to test if there is still initialisation work to be done. Such logic must be implemented in a different way.

Throws:

java.lang.IllegalStateException - if the initialisation is incomplete yet

retrieveConstructor

public MetaMethod retrieveConstructor(java.lang.Object[] arguments)

This is a helper method added in Groovy 2.1.0, which is used only by indy. This method is for internal use only.

Since:

Groovy 2.1.0

setProperties

public void setProperties(java.lang.Object bean,
                 java.util.Map map)

Sets a number of bean properties from the given Map where the keys are the String names of properties and the values are the values of the properties to set

getProperty

public java.lang.Object getProperty(java.lang.Class sender,
                           java.lang.Object object,
                           java.lang.String name,
                           boolean useSuper,
                           boolean fromInsideClass)

Description copied from interface: MetaClass

Retrieves a property on the given receiver for the specified arguments. The sender is the class that is requesting the property from the object. The MetaClass will attempt to establish the method to invoke based on the name and arguments provided.

The isCallToSuper and fromInsideClass help the Groovy runtime perform optimisations on the call to go directly to the super class if necessary

Specified by:

getProperty in interface MetaClass

Parameters:

sender - The java.lang.Class instance that requested the property

object - The Object which the property is being retrieved from

name - The name of the property

useSuper - Whether the call is to a super class property

fromInsideClass - ??

Returns:

the given property's value on the object

getEffectiveGetMetaProperty

public MetaProperty getEffectiveGetMetaProperty(java.lang.Class sender,
                                       java.lang.Object object,
                                       java.lang.String name,
                                       boolean useSuper)

getProperties

public java.util.List<MetaProperty> getProperties()

Get all the properties defined for this type

Specified by:

getProperties in interface MetaClass

Specified by:

getProperties in interface MetaObjectProtocol

Returns:

a list of MetaProperty objects

See Also:

MetaProperty

applyPropertyDescriptors

protected void applyPropertyDescriptors(java.beans.PropertyDescriptor[] propertyDescriptors)

addMetaBeanProperty

public void addMetaBeanProperty(MetaBeanProperty mp)

Adds a new MetaBeanProperty to this MetaClass

Specified by:

addMetaBeanProperty in interface MutableMetaClass

Parameters:

mp - The MetaBeanProperty

setProperty

public void setProperty(java.lang.Class sender,
               java.lang.Object object,
               java.lang.String name,
               java.lang.Object newValue,
               boolean useSuper,
               boolean fromInsideClass)

Sets the property value on an object

Specified by:

setProperty in interface MetaClass

Parameters:

sender - The java.lang.Class instance that is mutating the property

object - The Object which the property is being set on

name - The name of the property

newValue - The new value of the property to set

useSuper - Whether the call is to a super class property

fromInsideClass - ??

getAttribute

public java.lang.Object getAttribute(java.lang.Class sender,
                            java.lang.Object receiver,
                            java.lang.String messageName,
                            boolean useSuper)

Description copied from interface: MetaClass

Retrieves the value of an attribute (field). This method is to support the Groovy runtime and not for general client API usage.

Specified by:

getAttribute in interface MetaClass

Parameters:

sender - The class of the object that requested the attribute

receiver - The instance

messageName - The name of the attribute

useSuper - Whether to look-up on the super class or not

Returns:

The attribute value

getAttribute

public java.lang.Object getAttribute(java.lang.Class sender,
                            java.lang.Object object,
                            java.lang.String attribute,
                            boolean useSuper,
                            boolean fromInsideClass)

Looks up the given attribute (field) on the given object

setAttribute

public void setAttribute(java.lang.Class sender,
                java.lang.Object object,
                java.lang.String attribute,
                java.lang.Object newValue,
                boolean useSuper,
                boolean fromInsideClass)

Sets the given attribute (field) on the given object

Specified by:

setAttribute in interface MetaClass

Parameters:

sender - The class of the object that requested the attribute

object - The instance

attribute - The name of the attribute

newValue - The value of the attribute

useSuper - Whether to look-up on the super class or not

fromInsideClass - Whether the call happened from the inside or the outside of a class

getClassNode

public ClassNode getClassNode()

Description copied from interface: MetaClass

Obtains a reference to the original AST for the MetaClass if it is available at runtime

Specified by:

getClassNode in interface MetaClass

Returns:

The original AST or null if it cannot be returned

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

addMetaMethod

public void addMetaMethod(MetaMethod method)

adds a MetaMethod to this class. WARNING: this method will not do the neccessary steps for multimethod logic and using this method doesn't mean, that a method added here is replacing another method from a parent class completely. These steps are usually done by initialize, which means if you need these steps, you have to add the method before running initialize the first time.

Specified by:

addMetaMethod in interface MutableMetaClass

Parameters:

method - the MetaMethod

See Also:

initialize()

addMetaMethodToIndex

protected void addMetaMethodToIndex(MetaMethod method,
                        MetaMethodIndex.Header header)

checkIfGroovyObjectMethod

protected final void checkIfGroovyObjectMethod(MetaMethod metaMethod)

Checks if the metaMethod is a method from the GroovyObject interface such as setProperty, getProperty and invokeMethod

Parameters:

metaMethod - The metaMethod instance

See Also:

GroovyObject

isInitialized

protected boolean isInitialized()

chooseMethod

protected java.lang.Object chooseMethod(java.lang.String methodName,
                            java.lang.Object methodOrList,
                            java.lang.Class[] arguments)

Chooses the correct method to use from a list of methods which match by name.

Parameters:

methodOrList - the possible methods to choose from

arguments -

initialize

public void initialize()

Description copied from interface: MetaClass

complete the initialisation process. After this method is called no methods should be added to the meta class. Invocation of methods or access to fields/properties is forbidden unless this method is called. This method should contain any initialisation code, taking a longer time to complete. An example is the creation of the Reflector. It is suggested to synchronize this method.

Specified by:

initialize in interface MetaClass

getMethods

public java.util.List<MetaMethod> getMethods()

Description copied from interface: MetaClass

Retrieves a list of MetaMethods held by the class

Specified by:

getMethods in interface MetaClass

Specified by:

getMethods in interface MetaObjectProtocol

Returns:

A list of MetaMethods

See Also:

MetaMethod

getMetaMethods

public java.util.List<MetaMethod> getMetaMethods()

Description copied from interface: MetaClass

Retrieves a list of MetaMethods held by this class

Specified by:

getMetaMethods in interface MetaClass

Returns:

A list of MetaMethods

dropStaticMethodCache

protected void dropStaticMethodCache(java.lang.String name)

dropMethodCache

protected void dropMethodCache(java.lang.String name)

createPojoCallSite

public CallSite createPojoCallSite(CallSite site,
                          java.lang.Object receiver,
                          java.lang.Object[] args)

createStaticSite

public CallSite createStaticSite(CallSite site,
                        java.lang.Object[] args)

createPogoCallSite

public CallSite createPogoCallSite(CallSite site,
                          java.lang.Object[] args)

createPogoCallCurrentSite

public CallSite createPogoCallCurrentSite(CallSite site,
                                 java.lang.Class sender,
                                 java.lang.Object[] args)

createConstructorSite

public CallSite createConstructorSite(CallSite site,
                             java.lang.Object[] args)

getClassInfo

public ClassInfo getClassInfo()

getVersion

public int getVersion()

incVersion

public void incVersion()

getAdditionalMetaMethods

public MetaMethod[] getAdditionalMetaMethods()

findPropertyInClassHierarchy

protected MetaBeanProperty findPropertyInClassHierarchy(java.lang.String propertyName,
                                            CachedClass theClass)

findMixinMethod

protected MetaMethod findMixinMethod(java.lang.String methodName,
                         java.lang.Class[] arguments)

findMethodInClassHierarchy

protected static MetaMethod findMethodInClassHierarchy(java.lang.Class instanceKlazz,
                                    java.lang.String methodName,
                                    java.lang.Class[] arguments,
                                    MetaClass metaClass)

findOwnMethod

protected static MetaMethod findOwnMethod(java.lang.Class instanceKlazz,
                       java.lang.String methodName,
                       java.lang.Class[] arguments,
                       MetaClass metaClass,
                       MetaMethod method)

getSubclassMetaMethods

protected java.lang.Object getSubclassMetaMethods(java.lang.String methodName)

getProperty

public java.lang.Object getProperty(java.lang.Object object,
                           java.lang.String property)

Description copied from interface: MetaObjectProtocol

Retrieves a property of an instance of the class returned by the getTheClass() method.

What this means is largely down to the MetaClass implementation, however the default case would result in an attempt to invoke a JavaBean getter, or if no such getter exists a public field of the instance.

Specified by:

getProperty in interface MetaObjectProtocol

Parameters:

object - An instance of the class returned by the getTheClass() method

property - The name of the property to retrieve the value for

Returns:

The properties value

See Also:

MetaClassImpl

setProperty

public void setProperty(java.lang.Object object,
               java.lang.String property,
               java.lang.Object newValue)

Description copied from interface: MetaObjectProtocol

Sets a property of an instance of the class returned by the getTheClass() method.

What this means is largely down to the MetaClass implementation, however the default case would result in an attempt to invoke a JavaBean setter, or if no such setter exists to set a public field of the instance.

Specified by:

setProperty in interface MetaObjectProtocol

Parameters:

object - An instance of the class returned by the getTheClass() method

property - The name of the property to set

newValue - The new value of the property

See Also:

MetaClassImpl

getAttribute

public java.lang.Object getAttribute(java.lang.Object object,
                            java.lang.String attribute)

Description copied from interface: MetaObjectProtocol

Retrieves an attribute of an instance of the class returned by the getTheClass() method.

What this means is largely down to the MetaClass implementation, however the default case would result in attempt to read a field of the instance.

Specified by:

getAttribute in interface MetaObjectProtocol

Parameters:

object - An instance of the class returned by the getTheClass() method

attribute - The name of the attribute to retrieve the value for

Returns:

The attribute value

See Also:

MetaClassImpl

setAttribute

public void setAttribute(java.lang.Object object,
                java.lang.String attribute,
                java.lang.Object newValue)

Description copied from interface: MetaObjectProtocol

Sets an attribute of an instance of the class returned by the getTheClass() method.

What this means is largely down to the MetaClass implementation, however the default case would result in an attempt to set a field of the instance.

Specified by:

setAttribute in interface MetaObjectProtocol

Parameters:

object - An instance of the class returned by the getTheClass() method

attribute - The name of the attribute to set

newValue - The new value of the attribute

See Also:

MetaClassImpl

pickMethod

public MetaMethod pickMethod(java.lang.String methodName,
                    java.lang.Class[] arguments)

Description copied from interface: MetaClass

Selects a method by name and argument classes. This method does not search for an exact match, it searches for a compatible method. For this the method selection mechanism is used as provided by the implementation of this MetaClass. pickMethod may or may not be used during the method selection process when invoking a method. There is no warranty for that.

Specified by:

pickMethod in interface MetaClass

Parameters:

methodName - the name of the method to pick

arguments - the method arguments

Returns:

a matching MetaMethod or null

clearInvocationCaches

protected void clearInvocationCaches()

remove all method call cache entries. This should be done if a method is added during runtime, but not by using a category.