Class MetaClassImpl
- All Implemented Interfaces:
MetaClass
,MetaObjectProtocol
,MutableMetaClass
- Direct Known Subclasses:
ClosureMetaClass
,ExpandoMetaClass
,ProxyMetaClass
public class MetaClassImpl extends Object implements MetaClass, MutableMetaClass
- See Also:
MetaClass
-
Nested Class Summary
Nested Classes Modifier and Type Class 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 Description static Object[]
EMPTY_ARGUMENTS
protected MetaMethod
getPropertyMethod
protected static String
INVOKE_METHOD_METHOD
protected MetaMethod
invokeMethodMethod
protected boolean
isGroovyObject
protected boolean
isMap
protected MetaMethodIndex
metaMethodIndex
protected static String
METHOD_MISSING
protected static String
PROPERTY_MISSING
protected MetaClassRegistry
registry
protected MetaMethod
setPropertyMethod
protected static String
STATIC_METHOD_MISSING
protected static String
STATIC_PROPERTY_MISSING
protected CachedClass
theCachedClass
protected Class
theClass
-
Constructor Summary
Constructors Constructor Description MetaClassImpl(MetaClassRegistry registry, Class theClass)
Constructor with registry setting methods to nullMetaClassImpl(MetaClassRegistry registry, Class theClass, MetaMethod[] add)
Constructor with registryMetaClassImpl(Class theClass)
Constructor that sets the methods to nullMetaClassImpl(Class theClass, MetaMethod[] add)
Constructor -
Method Summary
Modifier and Type Method Description void
addMetaBeanProperty(MetaBeanProperty mp)
Adds a new MetaBeanProperty to this MetaClassvoid
addMetaMethod(MetaMethod method)
adds a MetaMethod to this class.protected void
addMetaMethodToIndex(MetaMethod method, MetaMethodIndex.Header header)
void
addNewInstanceMethod(Method method)
Adds an instance method to this metaclass.void
addNewStaticMethod(Method method)
Adds a static method to this metaclass.protected void
applyPropertyDescriptors(PropertyDescriptor[] propertyDescriptors)
protected void
checkIfGroovyObjectMethod(MetaMethod metaMethod)
Checks if the metaMethod is a method from the GroovyObject interface such as setProperty, getProperty and invokeMethodprotected void
checkInitalised()
checks if the initialisation of the class id complete.protected Object
chooseMethod(String methodName, Object methodOrList, 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, Object[] args)
Create a CallSiteprotected static String
createErrorMessageForAmbiguity(String theClassName, String name, Class[] arguments, LinkedList matches)
CallSite
createPogoCallCurrentSite(CallSite site, Class sender, Object[] args)
Create a CallSiteCallSite
createPogoCallSite(CallSite site, Object[] args)
Create a CallSiteCallSite
createPojoCallSite(CallSite site, Object receiver, Object[] args)
Create a CallSiteCallSite
createStaticSite(CallSite site, Object[] args)
Create a CallSiteprotected MetaMethod
createTransformMetaMethod(MetaMethod method)
protected static Object
doChooseMostSpecificParams(String theClassName, String name, List matchingMethods, Class[] arguments, boolean checkParametersCompatible)
protected void
dropMethodCache(String name)
protected void
dropStaticMethodCache(String name)
protected static MetaMethod
findMethodInClassHierarchy(Class instanceKlazz, String methodName, Class[] arguments, MetaClass metaClass)
protected MetaMethod
findMixinMethod(String methodName, Class[] arguments)
protected static MetaMethod
findOwnMethod(Class instanceKlazz, String methodName, Class[] arguments, MetaClass metaClass, MetaMethod method)
protected MetaBeanProperty
findPropertyInClassHierarchy(String propertyName, CachedClass theClass)
MetaMethod[]
getAdditionalMetaMethods()
Retrieves a list of additional MetaMethods held by this classObject
getAttribute(Class sender, Object object, String attribute, boolean useSuper)
Retrieves the value of an attribute (field).Object
getAttribute(Class sender, Object object, String attribute, boolean useSuper, boolean fromInsideClass)
Retrieves the value of an attribute (field).Object
getAttribute(Object object, String attribute)
Retrieves the value of an attribute (field).ClassInfo
getClassInfo()
Returns the ClassInfo for the contained ClassClassNode
getClassNode()
Obtains a reference to the original AST for the MetaClass if it is available at runtimeMetaProperty
getEffectiveGetMetaProperty(Class sender, Object object, String name, boolean useSuper)
MetaMethod
getMetaMethod(String name, Object[] argTypes)
Retrieves an instance MetaMethod for the given name and argument values, using the types of the argument values to establish the chosen MetaMethodList<MetaMethod>
getMetaMethods()
Retrieves the list of MetaMethods held by this class.MetaProperty
getMetaProperty(String name)
Returns a MetaProperty for the given name or null if it doesn't existList<MetaMethod>
getMethods()
Retrieves the list of MetaMethods held by the class.MetaMethod
getMethodWithCaching(Class sender, String methodName, Object[] arguments, boolean isCallToSuper)
MetaMethod
getMethodWithoutCaching(Class sender, String methodName, Class[] arguments, boolean isCallToSuper)
List<MetaProperty>
getProperties()
Get all the properties defined for this typeObject
getProperty(Class sender, Object object, String name, boolean useSuper, boolean fromInsideClass)
Retrieves a property on the given receiver for the specified arguments.Object
getProperty(Object object, String property)
Retrieves a property on the given object for the specified arguments.MetaClassRegistry
getRegistry()
Returns the registry for this metaclassMetaMethod
getStaticMetaMethod(String name, Object[] argTypes)
Retrieves a static MetaMethod for the given name and argument values, using the types of the arguments to establish the chosen MetaMethodprotected Object
getSubclassMetaMethods(String methodName)
protected LinkedList<CachedClass>
getSuperClasses()
CachedClass
getTheCachedClass()
Returns the cached class for this metaclassClass
getTheClass()
Returns the class this object this is the metaclass of.int
getVersion()
Returns version of the contained Classprotected static long
handleMatches(long matchesDistance, LinkedList matches, Object method, long dist)
boolean
hasCustomInvokeMethod()
indicates is the meta class method invocation for non-static methods is done through a custom invoker object.boolean
hasCustomStaticInvokeMethod()
indicates is the meta class method invocation for static methods is done through a custom invoker object.MetaProperty
hasProperty(Object obj, String name)
Returns true of the implementing MetaClass has a property of the given namevoid
incVersion()
Increments version of the contained Classvoid
initialize()
Complete the initialisation process.Object
invokeConstructor(Object[] arguments)
Invokes a constructor for the given arguments.Object
invokeMethod(Class sender, Object object, String methodName, Object[] originalArguments, boolean isCallToSuper, boolean fromInsideClass)
Invokes a method on the given receiver for the specified arguments.Object
invokeMethod(Object object, String methodName, Object arguments)
Invoke a method on the given object with the given arguments.Object
invokeMethod(Object object, String methodName, Object[] originalArguments)
Invokes a method on the given receiver for the specified arguments.Object
invokeMissingMethod(Object instance, String methodName, Object[] arguments)
Invoke a missing method on the given object with the given arguments.Object
invokeMissingProperty(Object instance, String propertyName, Object optionalValue, boolean isGetter)
Invoke a missing property on the given object with the given arguments.Object
invokeStaticMethod(Object object, String methodName, Object[] arguments)
Invokes a static method on the given Object with the given name and arguments.protected Object
invokeStaticMissingProperty(Object instance, String propertyName, Object optionalValue, boolean isGetter)
Hook to deal with the case of MissingProperty for static properties.boolean
isGroovyObject()
Return whether the class represented by this metaclass instance is an instance of the GroovyObject classprotected boolean
isInitialized()
boolean
isModified()
Returns whether this MetaClassImpl has been modified.boolean
isPermissivePropertyAccess()
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(String methodName, Class[] arguments)
Selects a method by name and argument classes.protected void
reinitialize()
List
respondsTo(Object obj, String name)
Returns an object satisfying Groovy truth if the implementing MetaClass responds to a method with the given name regardless of arguments.List
respondsTo(Object obj, String name, Object[] argTypes)
Returns an object satisfying Groovy truth if the implementing MetaClass responds to a method with the given name and arguments types.Constructor
retrieveConstructor(Class[] arguments)
MetaMethod
retrieveConstructor(Object[] arguments)
This is a helper method added in Groovy 2.1.0, which is used only by indy.MetaMethod
retrieveStaticMethod(String methodName, Object[] arguments)
int
selectConstructorAndTransformArguments(int numberOfConstructors, Object[] arguments)
Internal method to support Groovy runtime.void
setAttribute(Class sender, Object object, String attribute, Object newValue, boolean useSuper, boolean fromInsideClass)
Sets an attribute on the given receiver for the specified arguments.void
setAttribute(Object object, String attribute, Object newValue)
Sets the value of an attribute (field).protected void
setInitialized(boolean initialized)
void
setPermissivePropertyAccess(boolean permissivePropertyAccess)
void
setProperties(Object bean, 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 setvoid
setProperty(Class sender, Object object, String name, Object newValue, boolean useSuper, boolean fromInsideClass)
Retrieves a property on the given receiver for the specified arguments.void
setProperty(Object object, String property, Object newValue)
Sets a property on the given object for the specified arguments.String
toString()
Returns a string representation of this metaclass
-
Field Details
-
EMPTY_ARGUMENTS
-
STATIC_METHOD_MISSING
- See Also:
- Constant Field Values
-
STATIC_PROPERTY_MISSING
- See Also:
- Constant Field Values
-
METHOD_MISSING
- See Also:
- Constant Field Values
-
PROPERTY_MISSING
- See Also:
- Constant Field Values
-
INVOKE_METHOD_METHOD
- See Also:
- Constant Field Values
-
theClass
-
theCachedClass
-
isGroovyObject
protected final boolean isGroovyObject -
isMap
protected final boolean isMap -
metaMethodIndex
-
getPropertyMethod
-
invokeMethodMethod
-
setPropertyMethod
-
registry
-
-
Constructor Details
-
MetaClassImpl
Constructor- Parameters:
theClass
- The class this is the metaclass doradd
- The methods for this class
-
MetaClassImpl
Constructor that sets the methods to null- Parameters:
theClass
- The class this is the metaclass dor
-
MetaClassImpl
Constructor with registry- Parameters:
registry
- The metaclass registry for this MetaClasstheClass
- The classadd
- The methods
-
MetaClassImpl
Constructor with registry setting methods to null- Parameters:
registry
- The metaclass registry for this MetaClasstheClass
- The class
-
-
Method Details
-
getTheCachedClass
Returns the cached class for this metaclass- Returns:
- The cached class.
-
getRegistry
Returns the registry for this metaclass- Returns:
- The resgistry
-
respondsTo
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 interfaceMetaObjectProtocol
- Parameters:
obj
- The object to inspectname
- The name of the method of interestargTypes
- 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
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 interfaceMetaObjectProtocol
- Parameters:
obj
- The object to inspectname
- 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
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 interfaceMetaObjectProtocol
- Parameters:
obj
- The object to inspectname
- The name of the property- Returns:
- The MetaProperty or null if it doesn't exist
- See Also:
MetaObjectProtocol.hasProperty(Object, String)
-
getMetaProperty
Description copied from interface:MetaObjectProtocol
Returns a MetaProperty for the given name or null if it doesn't exist- Specified by:
getMetaProperty
in interfaceMetaObjectProtocol
- Parameters:
name
- The name of the MetaProperty- Returns:
- A MetaProperty or null
- See Also:
MetaObjectProtocol.getMetaProperty(String)
-
getStaticMetaMethod
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 interfaceMetaObjectProtocol
- Parameters:
name
- The name of the MetaMethodargTypes
- The argument types- Returns:
- A MetaMethod or null if it doesn't exist
- See Also:
MetaObjectProtocol.getStaticMetaMethod(String, Object[])
-
getMetaMethod
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 interfaceMetaObjectProtocol
- Parameters:
name
- The name of the MetaMethodargTypes
- 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
Returns the class this object this is the metaclass of.- Specified by:
getTheClass
in interfaceMetaObjectProtocol
- Returns:
- The class contained by this metaclass
-
isGroovyObject
public boolean isGroovyObject()Return whether the class represented by this metaclass instance is an instance of the GroovyObject class- Returns:
- true if this is a groovy class, false otherwise.
-
getSuperClasses
-
isModified
public boolean isModified()Returns whether this MetaClassImpl has been modified. Since MetaClassImpl is not designed for modification this method always returns false- Specified by:
isModified
in interfaceMutableMetaClass
- Returns:
- false
-
addNewInstanceMethod
Adds an instance method to this metaclass.- Specified by:
addNewInstanceMethod
in interfaceMutableMetaClass
- Parameters:
method
- The method to be added
-
addNewStaticMethod
Adds a static method to this metaclass.- Specified by:
addNewStaticMethod
in interfaceMutableMetaClass
- Parameters:
method
- The method to be added
-
invokeMethod
Invoke a method on the given object with the given arguments.- Specified by:
invokeMethod
in interfaceMetaObjectProtocol
- Parameters:
object
- The object the method should be invoked on.methodName
- The name of the method to invoke.arguments
- The arguments to the invoked method as null, a Tuple, an array or a single argument of any type.- Returns:
- The result of the method invocation.
- See Also:
MetaObjectProtocol.invokeMethod(Object, String, Object[])
-
invokeMissingMethod
Invoke a missing method on the given object with the given arguments.- Specified by:
invokeMissingMethod
in interfaceMetaClass
- Parameters:
instance
- The object the method should be invoked on.methodName
- The name of the method to invoke.arguments
- The arguments to the invoked method.- Returns:
- The result of the method invocation.
- See Also:
MissingMethodException
-
invokeMissingProperty
public Object invokeMissingProperty(Object instance, String propertyName, Object optionalValue, boolean isGetter)Invoke a missing property on the given object with the given arguments.- Specified by:
invokeMissingProperty
in interfaceMetaClass
- Parameters:
instance
- The object the method should be invoked on.propertyName
- The name of the property to invoke.optionalValue
- The (optional) new value for the propertyisGetter
- Whether the method is a getter- Returns:
- The result of the method invocation.
-
onSuperPropertyFoundInHierarchy
-
onMixinMethodFound
-
onSuperMethodFoundInHierarchy
-
onInvokeMethodFoundInHierarchy
-
onSetPropertyFoundInHierarchy
-
onGetPropertyFoundInHierarchy
-
invokeStaticMissingProperty
protected Object invokeStaticMissingProperty(Object instance, String propertyName, 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 instancepropertyName
- The name of the propertyoptionalValue
- The value in the case of a setterisGetter
- True if its a getter- Returns:
- The value in the case of a getter or a MissingPropertyException
-
invokeMethod
Invokes a method on the given receiver for the specified arguments. The MetaClass will attempt to establish the method to invoke based on the name and arguments provided.- Specified by:
invokeMethod
in interfaceMetaObjectProtocol
- Parameters:
object
- The object which the method was invoked onmethodName
- The name of the methodoriginalArguments
- The arguments to the method- Returns:
- The return value of the method
- See Also:
MetaClass.invokeMethod(Class, Object, String, Object[], boolean, boolean)
-
invokeMethod
public Object invokeMethod(Class sender, Object object, String methodName, Object[] originalArguments, boolean isCallToSuper, boolean fromInsideClass)Invokes a method on the given receiver for the specified arguments. The sender is the class that invoked the method on 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:
invokeMethod
in interfaceMetaClass
- Parameters:
sender
- The java.lang.Class instance that invoked the methodobject
- The object which the method was invoked onmethodName
- The name of the methodoriginalArguments
- The arguments to the methodisCallToSuper
- Whether the method is a call to a super class methodfromInsideClass
- Whether the call was invoked from the inside or the outside of the class- Returns:
- The return value of the method
- See Also:
MetaClass.invokeMethod(Class, Object, String, Object[], boolean, boolean)
-
createTransformMetaMethod
-
getMethodWithCaching
public MetaMethod getMethodWithCaching(Class sender, String methodName, Object[] arguments, boolean isCallToSuper) -
retrieveConstructor
-
retrieveStaticMethod
-
getMethodWithoutCaching
public MetaMethod getMethodWithoutCaching(Class sender, String methodName, Class[] arguments, boolean isCallToSuper) -
invokeStaticMethod
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 interfaceMetaObjectProtocol
- Parameters:
object
- An instance of the class returned by the getTheClass() method or the class itselfmethodName
- The name of the methodarguments
- 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
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 interfaceMetaObjectProtocol
- Parameters:
arguments
- The arguments to the constructor- Returns:
- An instance of the java.lang.Class that this MetaObjectProtocol object applies to
-
selectConstructorAndTransformArguments
Description copied from interface:MetaClass
Internal method to support Groovy runtime. Not for client usage.- Specified by:
selectConstructorAndTransformArguments
in interfaceMetaClass
- Parameters:
numberOfConstructors
- The number of constructorsarguments
- 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:
IllegalStateException
- if the initialisation is incomplete yet
-
retrieveConstructor
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
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 Object getProperty(Class sender, Object object, 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 interfaceMetaClass
- Parameters:
sender
- The java.lang.Class instance that requested the propertyobject
- The Object which the property is being retrieved fromname
- The name of the propertyuseSuper
- Whether the call is to a super class propertyfromInsideClass
- ??- Returns:
- the given property's value on the object
-
getEffectiveGetMetaProperty
public MetaProperty getEffectiveGetMetaProperty(Class sender, Object object, String name, boolean useSuper) -
getProperties
Get all the properties defined for this type- Specified by:
getProperties
in interfaceMetaClass
- Specified by:
getProperties
in interfaceMetaObjectProtocol
- Returns:
- a list of MetaProperty objects
- See Also:
MetaProperty
-
applyPropertyDescriptors
-
addMetaBeanProperty
Adds a new MetaBeanProperty to this MetaClass- Specified by:
addMetaBeanProperty
in interfaceMutableMetaClass
- Parameters:
mp
- The MetaBeanProperty
-
setProperty
public void setProperty(Class sender, Object object, String name, Object newValue, boolean useSuper, boolean fromInsideClass)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 useSuper and fromInsideClass help the Groovy runtime perform optimisations on the call to go directly to the super class if necessary
- Specified by:
setProperty
in interfaceMetaClass
- Parameters:
sender
- The java.lang.Class instance that is mutating the propertyobject
- The Object which the property is being set onname
- The name of the propertynewValue
- The new value of the property to setuseSuper
- Whether the call is to a super class propertyfromInsideClass
- Whether the call was invoked from the inside or the outside of the class.
-
getAttribute
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 interfaceMetaClass
- Parameters:
sender
- The class of the object that requested the attributeobject
- The instanceattribute
- The name of the attributeuseSuper
- Whether to look-up on the super class or not- Returns:
- The attribute value
-
getAttribute
public Object getAttribute(Class sender, Object object, String attribute, boolean useSuper, boolean fromInsideClass)Retrieves the value of an attribute (field). This method is to support the Groovy runtime and not for general client API usage.- Parameters:
sender
- The class of the object that requested the attributeobject
- The instance the attribute is to be retrieved fromattribute
- The name of the attributeuseSuper
- Whether to look-up on the super class or notfromInsideClass
- Whether the call was invoked from the inside or the outside of the class.- Returns:
- The attribute value
-
setAttribute
public void setAttribute(Class sender, Object object, String attribute, Object newValue, boolean useSuper, boolean fromInsideClass)Sets an attribute on the given receiver for the specified arguments. The sender is the class that is setting the attribute 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:
setAttribute
in interfaceMetaClass
- Parameters:
sender
- The java.lang.Class instance that is mutating the propertyobject
- The Object which the property is being set onattribute
- The name of the attribute,newValue
- The new value of the attribute to setuseSuper
- Whether the call is to a super class propertyfromInsideClass
- Whether the call was invoked from the inside or the outside of the class
-
getClassNode
Obtains a reference to the original AST for the MetaClass if it is available at runtime- Specified by:
getClassNode
in interfaceMetaClass
- Returns:
- The original AST or null if it cannot be returned
-
toString
Returns a string representation of this metaclass -
addMetaMethod
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 interfaceMutableMetaClass
- Parameters:
method
- the MetaMethod- See Also:
initialize()
-
addMetaMethodToIndex
-
checkIfGroovyObjectMethod
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() -
setInitialized
protected void setInitialized(boolean initialized) -
chooseMethod
Chooses the correct method to use from a list of methods which match by name.- Parameters:
methodOrList
- the possible methods to choose fromarguments
- the arguments
-
doChooseMostSpecificParams
-
createErrorMessageForAmbiguity
protected static String createErrorMessageForAmbiguity(String theClassName, String name, Class[] arguments, LinkedList matches) -
handleMatches
protected static long handleMatches(long matchesDistance, LinkedList matches, Object method, long dist) -
initialize
public void initialize()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 interfaceMetaClass
-
reinitialize
protected void reinitialize() -
getMethods
Retrieves the list of MetaMethods held by the class. This list does not include MetaMethods added by groovy.lang.ExpandoMetaClass.- Specified by:
getMethods
in interfaceMetaClass
- Specified by:
getMethods
in interfaceMetaObjectProtocol
- Returns:
- A list of MetaMethods
- See Also:
MetaMethod
-
getMetaMethods
Retrieves the list of MetaMethods held by this class. This list includes MetaMethods added by groovy.lang.ExpandoMetaClass.- Specified by:
getMetaMethods
in interfaceMetaClass
- Returns:
- A list of MetaMethods
-
dropStaticMethodCache
-
dropMethodCache
-
createPojoCallSite
Create a CallSite -
createStaticSite
Create a CallSite -
createPogoCallSite
Create a CallSite -
createPogoCallCurrentSite
Create a CallSite -
createConstructorSite
Create a CallSite -
getClassInfo
Returns the ClassInfo for the contained Class- Returns:
- The ClassInfo for the contained class.
-
getVersion
public int getVersion()Returns version of the contained Class- Returns:
- The version of the contained class.
-
incVersion
public void incVersion()Increments version of the contained Class -
getAdditionalMetaMethods
Retrieves a list of additional MetaMethods held by this class- Returns:
- A list of MetaMethods
-
findPropertyInClassHierarchy
-
findMixinMethod
-
findMethodInClassHierarchy
protected static MetaMethod findMethodInClassHierarchy(Class instanceKlazz, String methodName, Class[] arguments, MetaClass metaClass) -
findOwnMethod
protected static MetaMethod findOwnMethod(Class instanceKlazz, String methodName, Class[] arguments, MetaClass metaClass, MetaMethod method) -
getSubclassMetaMethods
-
getProperty
Retrieves a property on the given object for the specified arguments.
- Specified by:
getProperty
in interfaceMetaObjectProtocol
- Parameters:
object
- The Object which the property is being retrieved fromproperty
- The name of the property- Returns:
- The properties value
- See Also:
MetaClassImpl
-
setProperty
Sets a property on the given object for the specified arguments.
- Specified by:
setProperty
in interfaceMetaObjectProtocol
- Parameters:
object
- The Object which the property is being retrieved fromproperty
- The name of the propertynewValue
- The new value- See Also:
MetaClassImpl
-
getAttribute
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 interfaceMetaObjectProtocol
- Parameters:
object
- The object to get the attribute fromattribute
- The name of the attribute- Returns:
- The attribute value
- See Also:
MetaClassImpl
-
setAttribute
Sets the value of an attribute (field). This method is to support the Groovy runtime and not for general client API usage.- Specified by:
setAttribute
in interfaceMetaObjectProtocol
- Parameters:
object
- The object to get the attribute fromattribute
- The name of the attributenewValue
- The new value of the attribute- See Also:
MetaClassImpl
-
pickMethod
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 interfaceMetaClass
- Parameters:
methodName
- the name of the method to pickarguments
- the method arguments- Returns:
- a matching MetaMethod or null
- Throws:
GroovyRuntimeException
- if there is more than one matching method
-
hasCustomInvokeMethod
public boolean hasCustomInvokeMethod()indicates is the meta class method invocation for non-static methods is done through a custom invoker object.- Returns:
- true - if the method invocation is not done by the meta class itself
-
hasCustomStaticInvokeMethod
public boolean hasCustomStaticInvokeMethod()indicates is the meta class method invocation for static methods is done through a custom invoker object.- Returns:
- true - if the method invocation is not done by the meta class itself
-
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. -
isPermissivePropertyAccess
public boolean isPermissivePropertyAccess() -
setPermissivePropertyAccess
public void setPermissivePropertyAccess(boolean permissivePropertyAccess)
-