public class MetaClassImpl extends Object implements MetaClass, MutableMetaClass
MetaClass
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.
|
Modifier and Type | Field and 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 and Description |
---|
MetaClassImpl(Class theClass)
Constructor that sets the methods to null
|
MetaClassImpl(Class theClass,
MetaMethod[] add)
Constructor
|
MetaClassImpl(MetaClassRegistry registry,
Class theClass)
Constructor with registry setting methods to null
|
MetaClassImpl(MetaClassRegistry registry,
Class theClass,
MetaMethod[] add)
Constructor with registry
|
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(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 invokeMethod
|
protected 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 CallSite
|
CallSite |
createPogoCallCurrentSite(CallSite site,
Class sender,
Object[] args)
Create a CallSite
|
CallSite |
createPogoCallSite(CallSite site,
Object[] args)
Create a CallSite
|
CallSite |
createPojoCallSite(CallSite site,
Object receiver,
Object[] args)
Create a CallSite
|
CallSite |
createStaticSite(CallSite site,
Object[] args)
Create a CallSite
|
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 class
|
Object |
getAttribute(Class sender,
Object receiver,
String messageName,
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 Class
|
ClassNode |
getClassNode()
Obtains a reference to the original AST for the MetaClass if it is available at runtime
|
MetaProperty |
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 MetaMethod
|
List<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 exist
|
List<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 type
|
Object |
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 metaclass
|
MetaMethod |
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 MetaMethod
|
protected Object |
getSubclassMetaMethods(String methodName) |
protected LinkedList<CachedClass> |
getSuperClasses() |
CachedClass |
getTheCachedClass()
Returns the cached class for this metaclass
|
Class |
getTheClass()
Returns the class this object this is the metaclass of.
|
int |
getVersion()
Returns version of the contained Class
|
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 name
|
void |
incVersion()
Increments version of the contained Class
|
void |
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 wether the class represented by this metaclass instance is an instance of the GroovyObject class
|
protected boolean |
isInitialized() |
boolean |
isModified()
Returns whether this MetaClassImpl has been modified.
|
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.
|
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).
|
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 set
|
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.
|
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
|
protected static final String STATIC_METHOD_MISSING
protected static final String STATIC_PROPERTY_MISSING
protected static final String METHOD_MISSING
protected static final String PROPERTY_MISSING
protected static final String INVOKE_METHOD_METHOD
protected final Class theClass
protected final CachedClass theCachedClass
protected MetaMethod getPropertyMethod
protected MetaMethod invokeMethodMethod
protected MetaMethod setPropertyMethod
protected MetaClassRegistry registry
protected final boolean isGroovyObject
protected final boolean isMap
public static final Object[] EMPTY_ARGUMENTS
protected final MetaMethodIndex metaMethodIndex
public MetaClassImpl(Class theClass, MetaMethod[] add)
theClass
- The class this is the metaclass doradd
- The methods for this classpublic MetaClassImpl(Class theClass)
theClass
- The class this is the metaclass dorpublic MetaClassImpl(MetaClassRegistry registry, Class theClass, MetaMethod[] add)
registry
- The metaclass registry for this MetaClasstheClass
- The classadd
- The methodspublic MetaClassImpl(MetaClassRegistry registry, Class theClass)
registry
- The metaclass registry for this MetaClasstheClass
- The classpublic final CachedClass getTheCachedClass()
public MetaClassRegistry getRegistry()
public List respondsTo(Object obj, String name, Object[] argTypes)
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
respondsTo
in interface MetaObjectProtocol
obj
- The object to inspectname
- The name of the method of interestargTypes
- The argument types to match againstMetaObjectProtocol.respondsTo(Object, String, Object[])
public List respondsTo(Object obj, String name)
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
respondsTo
in interface MetaObjectProtocol
obj
- The object to inspectname
- The name of the method of interestMetaObjectProtocol.respondsTo(Object, String)
public MetaProperty hasProperty(Object obj, String name)
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
hasProperty
in interface MetaObjectProtocol
obj
- The object to inspectname
- The name of the propertyMetaObjectProtocol.hasProperty(Object,String)
public MetaProperty getMetaProperty(String name)
MetaObjectProtocol
getMetaProperty
in interface MetaObjectProtocol
name
- The name of the MetaPropertyMetaObjectProtocol.getMetaProperty(String)
public MetaMethod getStaticMetaMethod(String name, Object[] argTypes)
MetaObjectProtocol
getStaticMetaMethod
in interface MetaObjectProtocol
name
- The name of the MetaMethodargTypes
- The argument typesMetaObjectProtocol.getStaticMetaMethod(String, Object[])
public MetaMethod getMetaMethod(String name, Object[] argTypes)
MetaObjectProtocol
getMetaMethod
in interface MetaObjectProtocol
name
- The name of the MetaMethodargTypes
- Array containing - 1) the argument values (using which their types are then inferred), or 2) the corresponding argument typesMetaObjectProtocol.getMetaMethod(String, Object[])
public Class getTheClass()
getTheClass
in interface MetaObjectProtocol
public boolean isGroovyObject()
protected LinkedList<CachedClass> getSuperClasses()
public boolean isModified()
isModified
in interface MutableMetaClass
public void addNewInstanceMethod(Method method)
addNewInstanceMethod
in interface MutableMetaClass
method
- The method to be addedpublic void addNewStaticMethod(Method method)
addNewStaticMethod
in interface MutableMetaClass
method
- The method to be addedpublic Object invokeMethod(Object object, String methodName, Object arguments)
invokeMethod
in interface MetaObjectProtocol
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.MetaObjectProtocol.invokeMethod(Object, String, Object[])
public Object invokeMissingMethod(Object instance, String methodName, Object[] arguments)
invokeMissingMethod
in interface MetaClass
instance
- The object the method should be invoked on.methodName
- The name of the method to invoke.arguments
- The arguments to the invoked method.MissingMethodException
public Object invokeMissingProperty(Object instance, String propertyName, Object optionalValue, boolean isGetter)
invokeMissingProperty
in interface MetaClass
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
- Wether the method is a getterprotected void onSuperPropertyFoundInHierarchy(MetaBeanProperty property)
protected void onMixinMethodFound(MetaMethod method)
protected void onSuperMethodFoundInHierarchy(MetaMethod method)
protected void onInvokeMethodFoundInHierarchy(MetaMethod method)
protected void onSetPropertyFoundInHierarchy(MetaMethod method)
protected void onGetPropertyFoundInHierarchy(MetaMethod method)
protected Object invokeStaticMissingProperty(Object instance, String propertyName, Object optionalValue, boolean isGetter)
instance
- The instancepropertyName
- The name of the propertyoptionalValue
- The value in the case of a setterisGetter
- True if its a getterpublic Object invokeMethod(Object object, String methodName, Object[] originalArguments)
invokeMethod
in interface MetaObjectProtocol
object
- The object which the method was invoked onmethodName
- The name of the methodoriginalArguments
- The arguments to the methodMetaClass.invokeMethod(Class, Object, String, Object[], boolean, boolean)
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
invokeMethod
in interface MetaClass
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 classMetaClass.invokeMethod(Class, Object, String, Object[], boolean, boolean)
public MetaMethod getMethodWithCaching(Class sender, String methodName, Object[] arguments, boolean isCallToSuper)
public Constructor retrieveConstructor(Class[] arguments)
public MetaMethod retrieveStaticMethod(String methodName, Object[] arguments)
public MetaMethod getMethodWithoutCaching(Class sender, String methodName, Class[] arguments, boolean isCallToSuper)
public Object invokeStaticMethod(Object object, String methodName, Object[] arguments)
MetaObjectProtocol
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
invokeStaticMethod
in interface MetaObjectProtocol
object
- An instance of the class returned by the getTheClass() method or the class itselfmethodName
- The name of the methodarguments
- The arguments to the methodMissingMethodException
public Object invokeConstructor(Object[] arguments)
MetaObjectProtocol
invokeConstructor
in interface MetaObjectProtocol
arguments
- The arguments to the constructorpublic int selectConstructorAndTransformArguments(int numberOfConstructors, Object[] arguments)
MetaClass
selectConstructorAndTransformArguments
in interface MetaClass
numberOfConstructors
- The number of constructorsarguments
- The argumentsprotected void checkInitalised()
IllegalStateException
- if the initialisation is incomplete yetpublic MetaMethod retrieveConstructor(Object[] arguments)
public void setProperties(Object bean, Map map)
public Object getProperty(Class sender, Object object, String name, boolean useSuper, boolean fromInsideClass)
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
getProperty
in interface MetaClass
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
- ??public MetaProperty getEffectiveGetMetaProperty(Class sender, Object object, String name, boolean useSuper)
public List<MetaProperty> getProperties()
getProperties
in interface MetaClass
getProperties
in interface MetaObjectProtocol
MetaProperty
protected void applyPropertyDescriptors(PropertyDescriptor[] propertyDescriptors)
public void addMetaBeanProperty(MetaBeanProperty mp)
addMetaBeanProperty
in interface MutableMetaClass
mp
- The MetaBeanPropertypublic 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
setProperty
in interface MetaClass
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.public Object getAttribute(Class sender, Object receiver, String messageName, boolean useSuper)
getAttribute
in interface MetaClass
sender
- The class of the object that requested the attributereceiver
- The instancemessageName
- The name of the attributeuseSuper
- Whether to look-up on the super class or notpublic Object getAttribute(Class sender, Object object, String attribute, boolean useSuper, boolean fromInsideClass)
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.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
setAttribute
in interface MetaClass
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 classpublic ClassNode getClassNode()
getClassNode
in interface MetaClass
public String toString()
public void addMetaMethod(MetaMethod method)
addMetaMethod
in interface MutableMetaClass
method
- the MetaMethodinitialize()
protected void addMetaMethodToIndex(MetaMethod method, MetaMethodIndex.Header header)
protected final void checkIfGroovyObjectMethod(MetaMethod metaMethod)
metaMethod
- The metaMethod instanceGroovyObject
protected boolean isInitialized()
protected Object chooseMethod(String methodName, Object methodOrList, Class[] arguments)
methodOrList
- the possible methods to choose fromarguments
- public void initialize()
initialize
in interface MetaClass
public List<MetaMethod> getMethods()
getMethods
in interface MetaClass
getMethods
in interface MetaObjectProtocol
MetaMethod
public List<MetaMethod> getMetaMethods()
getMetaMethods
in interface MetaClass
protected void dropStaticMethodCache(String name)
protected void dropMethodCache(String name)
public CallSite createPojoCallSite(CallSite site, Object receiver, Object[] args)
public CallSite createPogoCallSite(CallSite site, Object[] args)
public CallSite createPogoCallCurrentSite(CallSite site, Class sender, Object[] args)
public CallSite createConstructorSite(CallSite site, Object[] args)
public ClassInfo getClassInfo()
public int getVersion()
public void incVersion()
public MetaMethod[] getAdditionalMetaMethods()
protected MetaBeanProperty findPropertyInClassHierarchy(String propertyName, CachedClass theClass)
protected MetaMethod findMixinMethod(String methodName, Class[] arguments)
protected static MetaMethod findMethodInClassHierarchy(Class instanceKlazz, String methodName, Class[] arguments, MetaClass metaClass)
protected static MetaMethod findOwnMethod(Class instanceKlazz, String methodName, Class[] arguments, MetaClass metaClass, MetaMethod method)
public Object getProperty(Object object, String property)
Retrieves a property on the given object for the specified arguments.
getProperty
in interface MetaObjectProtocol
object
- The Object which the property is being retrieved fromproperty
- The name of the propertyMetaClassImpl
public void setProperty(Object object, String property, Object newValue)
Sets a property on the given object for the specified arguments.
setProperty
in interface MetaObjectProtocol
object
- The Object which the property is being retrieved fromproperty
- The name of the propertynewValue
- The new valueMetaClassImpl
public Object getAttribute(Object object, String attribute)
getAttribute
in interface MetaObjectProtocol
object
- The object to get the attribute fromattribute
- The name of the attributeMetaClassImpl
public void setAttribute(Object object, String attribute, Object newValue)
setAttribute
in interface MetaObjectProtocol
object
- The object to get the attribute fromattribute
- The name of the attributenewValue
- The new value of the attributeMetaClassImpl
public MetaMethod pickMethod(String methodName, Class[] arguments)
pickMethod
in interface MetaClass
methodName
- the name of the method to pickarguments
- the method argumentsGroovyRuntimeException
- if there is more than one matching methodpublic boolean hasCustomInvokeMethod()
public boolean hasCustomStaticInvokeMethod()
protected void clearInvocationCaches()