Class ExpandoMetaClass
- All Implemented Interfaces:
GroovyObject,MetaClass,MetaObjectProtocol,MutableMetaClass
public class ExpandoMetaClass extends MetaClassImpl implements GroovyObject
Some examples of usage:
// defines or replaces instance method:
metaClass.myMethod = { args -> }
// defines a new instance method
metaClass.myMethod << { args -> }
// creates multiple overloaded methods of the same name
metaClass.myMethod << { String s -> } << { Integer i -> }
// defines or replaces a static method with the 'static' qualifier
metaClass.'static'.myMethod = { args -> }
// defines a new static method with the 'static' qualifier
metaClass.'static'.myMethod << { args -> }
// defines a new constructor
metaClass.constructor << { String arg -> }
// defines or replaces a constructor
metaClass.constructor = { String arg -> }
// defines a new property with an initial value of "blah"
metaClass.myProperty = "blah"
ExpandoMetaClass also supports a DSL/builder like notation to combine multiple definitions together. So instead of this:
Number.metaClass.multiply = { Amount amount -> amount.times(delegate) }
Number.metaClass.div = { Amount amount -> amount.inverse().times(delegate) }
You can also now do this:
Number.metaClass {
multiply { Amount amount -> amount.times(delegate) }
div { Amount amount -> amount.inverse().times(delegate) }
}
ExpandoMetaClass also supports runtime mixins. While @Mixin allows you to mix in new behavior
to classes you own and are designing, you can not easily mixin anything to types you didn't own, e.g.
from third party libraries or from JDK library classes.
Runtime mixins let you add a mixin on any type at runtime.
interface Vehicle {
String getName()
}
// Category annotation style
@Category(Vehicle) class FlyingAbility {
def fly() { "I'm the ${name} and I fly!" }
}
// traditional category style
class DivingAbility {
static dive(Vehicle self) { "I'm the ${self.name} and I dive!" }
}
// provided by a third-party, so can't augment using Mixin annotation
class JamesBondVehicle implements Vehicle {
String getName() { "James Bond's vehicle" }
}
// Can be added via metaClass, e.g.:
// JamesBondVehicle.metaClass.mixin DivingAbility, FlyingAbility
// Or using shorthand through DGM method on Class
JamesBondVehicle.mixin DivingAbility, FlyingAbility
assert new JamesBondVehicle().fly() ==
"I'm the James Bond's vehicle and I fly!"
assert new JamesBondVehicle().dive() ==
"I'm the James Bond's vehicle and I dive!"
As another example, consider the following class definitions:
class Student {
List schedule = []
def addLecture(String lecture) { schedule << lecture }
}
class Worker {
List schedule = []
def addMeeting(String meeting) { schedule << meeting }
}
We can mimic a form of multiple inheritance as follows:
class CollegeStudent {
static { mixin Student, Worker }
}
new CollegeStudent().with {
addMeeting('Performance review with Boss')
addLecture('Learn about Groovy Mixins')
println schedule
println mixedIn[Student].schedule
println mixedIn[Worker].schedule
}
Which outputs these lines when run:
[Performance review with Boss] [Learn about Groovy Mixins] [Performance review with Boss]Perhaps some explanation is required here. The methods and properties of Student and Worker are added to CollegeStudent. Worker is added last, so for overlapping methods, its methods will be used, e.g. when calling
schedule, it will be the schedule property (getSchedule method)
from Worker that is used. The schedule property from Student will be shadowed but the mixedIn
notation allows us to get to that too if we need as the last two lines show.
We can also be a little more dynamic and not require the CollegeStudent class to be defined at all, e.g.:
def cs = new Object()
cs.metaClass {
mixin Student, Worker
getSchedule {
mixedIn[Student].schedule + mixedIn[Worker].schedule
}
}
cs.with {
addMeeting('Performance review with Boss')
addLecture('Learn about Groovy Mixins')
println schedule
}
Which outputs this line when run:
[Learn about Groovy Mixins, Performance review with Boss]As another example, we can also define a no dup queue by mixing in some Queue and Set functionality as follows:
def ndq = new Object()
ndq.metaClass {
mixin ArrayDeque
mixin HashSet
leftShift = { Object o ->
if (!mixedIn[Set].contains(o)) {
mixedIn[Queue].push(o)
mixedIn[Set].add(o)
}
}
}
ndq << 1
ndq << 2
ndq << 1
assert ndq.size() == 2
As a final example, we sometimes need to pass such mixed in classes or objects
into Java methods which require a given static type but the ExpandoMetaClass mixin approach uses a very dynamic
approach based on duck typing rather than static interface definitions, so doesn't by default
produce objects matching the required static type. Luckily, there is a mixins capability
within ExpandoMetaClass which supports the use of Groovy's common 'as StaticType' notation to produce an object
having the correct static type so that it can be passed to the Java method call in question.
A slightly contrived example illustrating this feature:
class CustomComparator implements Comparator {
int compare(Object a, b) { return a.size() - b.size() }
}
class CustomCloseable implements Closeable {
void close() { println 'Lights out - I am closing' }
}
import static mypackage.IOUtils.closeQuietly
import static java.util.Collections.sort
def o = new Object()
o.metaClass.mixin CustomComparator, CustomCloseable
def items = ['a', 'bbb', 'cc']
sort(items, o as Comparator)
println items // => [a, cc, bbb]
closeQuietly(o as Closeable) // => Lights out - I am closing
Further details
When using the default implementations of MetaClass, methods are only allowed to be added before initialize() is called. In other words you create a new MetaClass, add some methods and then call initialize(). If you attempt to add new methods after initialize() has been called, an error will be thrown. This is to ensure that the MetaClass can operate appropriately in multi-threaded environments as it forces you to do all method additions at the beginning, before using the MetaClass.
ExpandoMetaClass differs here from the default in that it allows you to add methods after initialize has been called. This is done by setting the initialize flag internally to false and then add the methods. Since this is not thread safe it has to be done in a synchronized block. The methods to check for modification and initialization are therefore synchronized as well. Any method call done through this meta class will first check if the it is synchronized. Should this happen during a modification, then the method cannot be selected or called unless the modification is completed.
- Since:
- 1.5
-
Nested Class Summary
Nested Classes Modifier and Type Class Description protected classExpandoMetaClass.ExpandoMetaConstructorHandles the ability to use the left shift operator to append new constructorsprotected classExpandoMetaClass.ExpandoMetaPropertyInstances of this class are returned when using the<<left shift operator.Nested classes/interfaces inherited from class groovy.lang.MetaClassImpl
MetaClassImpl.Index, MetaClassImpl.MetaConstructor -
Field Summary
Fields Modifier and Type Field Description static java.lang.StringCONSTRUCTORbooleaninRegistrystatic java.lang.StringSTATIC_QUALIFIERFields inherited from class groovy.lang.MetaClassImpl
EMPTY_ARGUMENTS, getPropertyMethod, INVOKE_METHOD_METHOD, invokeMethodMethod, isGroovyObject, isMap, metaMethodIndex, METHOD_MISSING, PROPERTY_MISSING, registry, setPropertyMethod, STATIC_METHOD_MISSING, STATIC_PROPERTY_MISSING, theCachedClass, theClass -
Constructor Summary
Constructors Constructor Description ExpandoMetaClass(MetaClassRegistry registry, java.lang.Class theClass, boolean register, boolean allowChangesAfterInit, MetaMethod[] add)ExpandoMetaClass(java.lang.Class theClass)Constructs a new ExpandoMetaClass instance for the given classExpandoMetaClass(java.lang.Class theClass, boolean register)Constructs a new ExpandoMetaClass instance for the given class optionally placing the MetaClass in the MetaClassRegistry automaticallyExpandoMetaClass(java.lang.Class theClass, boolean register, boolean allowChangesAfterInit)Constructs a new ExpandoMetaClass instance for the given class optionally placing the MetaClass in the MetaClassRegistry automaticallyExpandoMetaClass(java.lang.Class theClass, boolean register, boolean allowChangesAfterInit, MetaMethod[] add)ExpandoMetaClass(java.lang.Class theClass, boolean register, MetaMethod[] add)ExpandoMetaClass(java.lang.Class theClass, MetaMethod[] add) -
Method Summary
Modifier and Type Method Description voidaddMixinClass(MixinInMetaClass mixin)java.lang.ObjectcastToMixedType(java.lang.Object obj, java.lang.Class type)protected voidcheckInitalised()checks if the initialisation of the class id complete.CallSitecreateConstructorSite(CallSite site, java.lang.Object[] args)Create a CallSiteCallSitecreatePogoCallCurrentSite(CallSite site, java.lang.Class sender, java.lang.String name, java.lang.Object[] args)CallSitecreatePogoCallSite(CallSite site, java.lang.Object[] args)Create a CallSiteCallSitecreatePojoCallSite(CallSite site, java.lang.Object receiver, java.lang.Object[] args)Create a CallSiteCallSitecreateStaticSite(CallSite site, java.lang.Object[] args)Create a CallSiteExpandoMetaClassdefine(Closure closure)static voiddisableGlobally()Call to disable the global use of ExpandoMetaClassstatic voidenableGlobally()Call to enable global use of ExpandoMetaClass within the registry.MetaMethodfindMixinMethod(java.lang.String methodName, java.lang.Class[] arguments)java.util.List<MetaMethod>getExpandoMethods()Returns a list of expando MetaMethod instances added to this ExpandoMetaClassjava.util.Collection<MetaProperty>getExpandoProperties()Returns a list of MetaBeanProperty instances added to this ExpandoMetaClassjava.util.CollectiongetExpandoSubclassMethods()java.lang.ClassgetJavaClass()MetaClassgetMetaClass()Returns the metaclass for a given class.MetaPropertygetMetaProperty(java.lang.String name)Looks up an existing MetaProperty by namejava.util.List<MetaMethod>getMethods()Overrides the behavior of parent getMethods() method to make MetaClass aware of added Expando methodsjava.util.List<MetaProperty>getProperties()Get all the properties defined for this typejava.lang.ObjectgetProperty(java.lang.Class sender, java.lang.Object object, java.lang.String name, boolean useSuper, boolean fromInsideClass)Overrides default implementation just in case getProperty method has been overridden by ExpandoMetaClassjava.lang.ObjectgetProperty(java.lang.Object object, java.lang.String name)Overrides default implementation just in case getProperty method has been overridden by ExpandoMetaClassjava.lang.ObjectgetProperty(java.lang.String property)Retrieves a property value.java.lang.StringgetPropertyForSetter(java.lang.String setterName)Returns a property name equivalent for the given setter name or null if it is not a getterprotected java.lang.ObjectgetSubclassMetaMethods(java.lang.String methodName)booleanhasCustomStaticInvokeMethod()indicates is the meta class method invocation for static methods is done through a custom invoker object.booleanhasMetaMethod(java.lang.String name, java.lang.Class[] args)Checks whether a MetaMethod for the given name and arguments existsbooleanhasMetaProperty(java.lang.String name)Returns true if the MetaClass has the given propertyvoidinitialize()Complete the initialisation process.java.lang.ObjectinvokeConstructor(java.lang.Object[] arguments)Invokes a constructor for the given arguments.java.lang.ObjectinvokeMethod(java.lang.Class sender, java.lang.Object object, java.lang.String methodName, java.lang.Object[] originalArguments, boolean isCallToSuper, boolean fromInsideClass)Overrides default implementation just in case invokeMethod has been overridden by ExpandoMetaClassjava.lang.ObjectinvokeMethod(java.lang.String name, java.lang.Object args)Invokes the given method.java.lang.ObjectinvokeStaticMethod(java.lang.Object object, java.lang.String methodName, java.lang.Object[] arguments)Overrides default implementation just in case a static invoke method has been set on ExpandoMetaClassprotected booleanisInitialized()Checks if the meta class is initialized.booleanisModified()Returns whether this MetaClassImpl has been modified.booleanisSetter(java.lang.String name, CachedClass[] args)static booleanisValidExpandoProperty(java.lang.String property)protected voidonGetPropertyFoundInHierarchy(MetaMethod method)protected voidonInvokeMethodFoundInHierarchy(MetaMethod method)protected voidonSetPropertyFoundInHierarchy(MetaMethod method)protected voidonSuperMethodFoundInHierarchy(MetaMethod method)protected voidonSuperPropertyFoundInHierarchy(MetaBeanProperty property)protected voidperformOperationOnMetaClass(groovy.lang.ExpandoMetaClass.Callable c)voidrefreshInheritedMethods(java.util.Set modifiedSuperExpandos)Called from ExpandoMetaClassCreationHandle in the registry if it exists to set up inheritance handlingvoidregisterBeanProperty(java.lang.String property, java.lang.Object newValue)Registers a new bean propertyvoidregisterInstanceMethod(MetaMethod metaMethod)Registers a new instance method for the given method name and closure on this MetaClassvoidregisterInstanceMethod(java.lang.String name, Closure closure)protected voidregisterStaticMethod(java.lang.String name, Closure callable)protected voidregisterStaticMethod(java.lang.String name, Closure callable, java.lang.Class[] paramTypes)Registers a new static method for the given method name and closure on this MetaClassvoidregisterSubclassInstanceMethod(MetaMethod metaMethod)voidregisterSubclassInstanceMethod(java.lang.String name, java.lang.Class klazz, Closure closure)MetaMethodretrieveConstructor(java.lang.Object[] args)This is a helper method added in Groovy 2.1.0, which is used only by indy.protected voidsetInitialized(boolean b)voidsetMetaClass(MetaClass metaClass)Allows the MetaClass to be replaced with a derived implementation.voidsetProperty(java.lang.Class sender, java.lang.Object object, java.lang.String name, java.lang.Object newValue, boolean useSuper, boolean fromInsideClass)Overrides default implementation just in case setProperty method has been overridden by ExpandoMetaClassvoidsetProperty(java.lang.String property, java.lang.Object newValue)Sets the given property to the new value.Methods inherited from class groovy.lang.MetaClassImpl
addMetaBeanProperty, addMetaMethod, addMetaMethodToIndex, addNewInstanceMethod, addNewStaticMethod, applyPropertyDescriptors, checkIfGroovyObjectMethod, chooseMethod, clearInvocationCaches, createErrorMessageForAmbiguity, createPogoCallCurrentSite, createTransformMetaMethod, doChooseMostSpecificParams, dropMethodCache, dropStaticMethodCache, findMethodInClassHierarchy, findOwnMethod, findPropertyInClassHierarchy, getAdditionalMetaMethods, getAttribute, getAttribute, getAttribute, getClassInfo, getClassNode, getEffectiveGetMetaProperty, getMetaMethod, getMetaMethods, getMethodWithCaching, getMethodWithoutCaching, getRegistry, getStaticMetaMethod, getSuperClasses, getTheCachedClass, getTheClass, getVersion, handleMatches, hasCustomInvokeMethod, hasProperty, incVersion, invokeMethod, invokeMethod, invokeMissingMethod, invokeMissingProperty, invokeStaticMissingProperty, isGroovyObject, isPermissivePropertyAccess, onMixinMethodFound, pickMethod, reinitialize, respondsTo, respondsTo, retrieveConstructor, retrieveStaticMethod, selectConstructorAndTransformArguments, setAttribute, setAttribute, setPermissivePropertyAccess, setProperties, setProperty, toStringMethods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
-
Field Details
-
STATIC_QUALIFIER
public static final java.lang.String STATIC_QUALIFIER- See Also:
- Constant Field Values
-
CONSTRUCTOR
public static final java.lang.String CONSTRUCTOR- See Also:
- Constant Field Values
-
inRegistry
public boolean inRegistry
-
-
Constructor Details
-
ExpandoMetaClass
public ExpandoMetaClass(java.lang.Class theClass, boolean register, boolean allowChangesAfterInit, MetaMethod[] add) -
ExpandoMetaClass
public ExpandoMetaClass(MetaClassRegistry registry, java.lang.Class theClass, boolean register, boolean allowChangesAfterInit, MetaMethod[] add) -
ExpandoMetaClass
public ExpandoMetaClass(java.lang.Class theClass)Constructs a new ExpandoMetaClass instance for the given class- Parameters:
theClass- The class that the MetaClass applies to
-
ExpandoMetaClass
-
ExpandoMetaClass
public ExpandoMetaClass(java.lang.Class theClass, boolean register)Constructs a new ExpandoMetaClass instance for the given class optionally placing the MetaClass in the MetaClassRegistry automatically- Parameters:
theClass- The class that the MetaClass applies toregister- True if the MetaClass should be registered inside the MetaClassRegistry. This defaults to true and ExpandoMetaClass will effect all instances if changed
-
ExpandoMetaClass
-
ExpandoMetaClass
public ExpandoMetaClass(java.lang.Class theClass, boolean register, boolean allowChangesAfterInit)Constructs a new ExpandoMetaClass instance for the given class optionally placing the MetaClass in the MetaClassRegistry automatically- Parameters:
theClass- The class that the MetaClass applies toregister- True if the MetaClass should be registered inside the MetaClassRegistry. This defaults to true and ExpandoMetaClass will effect all instances if changedallowChangesAfterInit- Should the meta class be modifiable after initialization. Default is false.
-
-
Method Details
-
getExpandoSubclassMethods
public java.util.Collection getExpandoSubclassMethods() -
findMixinMethod
- Overrides:
findMixinMethodin classMetaClassImpl
-
onInvokeMethodFoundInHierarchy
- Overrides:
onInvokeMethodFoundInHierarchyin classMetaClassImpl
-
onSuperMethodFoundInHierarchy
- Overrides:
onSuperMethodFoundInHierarchyin classMetaClassImpl
-
onSuperPropertyFoundInHierarchy
- Overrides:
onSuperPropertyFoundInHierarchyin classMetaClassImpl
-
onSetPropertyFoundInHierarchy
- Overrides:
onSetPropertyFoundInHierarchyin classMetaClassImpl
-
onGetPropertyFoundInHierarchy
- Overrides:
onGetPropertyFoundInHierarchyin classMetaClassImpl
-
isModified
public boolean isModified()Description copied from class:MetaClassImplReturns whether this MetaClassImpl has been modified. Since MetaClassImpl is not designed for modification this method always returns false- Specified by:
isModifiedin interfaceMutableMetaClass- Overrides:
isModifiedin classMetaClassImpl- Returns:
- false
-
registerSubclassInstanceMethod
public void registerSubclassInstanceMethod(java.lang.String name, java.lang.Class klazz, Closure closure) -
registerSubclassInstanceMethod
-
addMixinClass
-
castToMixedType
public java.lang.Object castToMixedType(java.lang.Object obj, java.lang.Class type) -
enableGlobally
public static void enableGlobally()Call to enable global use of ExpandoMetaClass within the registry. This has the advantage that inheritance will function correctly and metaclass modifications will also apply to existing objects, but has a higher memory usage on the JVM than normal Groovy -
disableGlobally
public static void disableGlobally()Call to disable the global use of ExpandoMetaClass -
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:
initializein interfaceMetaClass- Overrides:
initializein classMetaClassImpl
-
isInitialized
protected boolean isInitialized()Checks if the meta class is initialized.- Overrides:
isInitializedin classMetaClassImpl- See Also:
MetaClassImpl.isInitialized()
-
setInitialized
protected void setInitialized(boolean b)- Overrides:
setInitializedin classMetaClassImpl
-
invokeConstructor
public java.lang.Object invokeConstructor(java.lang.Object[] arguments)Description copied from interface:MetaObjectProtocolInvokes 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:
invokeConstructorin interfaceMetaObjectProtocol- Overrides:
invokeConstructorin classMetaClassImpl- Parameters:
arguments- The arguments to the constructor- Returns:
- An instance of the java.lang.Class that this MetaObjectProtocol object applies to
-
getMetaClass
Description copied from interface:GroovyObjectReturns the metaclass for a given class.- Specified by:
getMetaClassin interfaceGroovyObject- Returns:
- the metaClass of this instance
-
getProperty
public java.lang.Object getProperty(java.lang.String property)Description copied from interface:GroovyObjectRetrieves a property value.- Specified by:
getPropertyin interfaceGroovyObject- Parameters:
property- the name of the property of interest- Returns:
- the given property
-
isValidExpandoProperty
public static boolean isValidExpandoProperty(java.lang.String property) -
invokeMethod
public java.lang.Object invokeMethod(java.lang.String name, java.lang.Object args)Description copied from interface:GroovyObjectInvokes the given method.- Specified by:
invokeMethodin interfaceGroovyObject- Parameters:
name- the name of the method to callargs- the arguments to use for the method call- Returns:
- the result of invoking the method
-
setMetaClass
Description copied from interface:GroovyObjectAllows the MetaClass to be replaced with a derived implementation.- Specified by:
setMetaClassin interfaceGroovyObject- Parameters:
metaClass- the new metaclass
-
setProperty
public void setProperty(java.lang.String property, java.lang.Object newValue)Description copied from interface:GroovyObjectSets the given property to the new value.- Specified by:
setPropertyin interfaceGroovyObject- Parameters:
property- the name of the property of interestnewValue- the new value for the property
-
define
public ExpandoMetaClass define(@DelegatesTo(value=groovy.lang.ExpandoMetaClass.DefiningClosure.class,strategy=3) Closure closure) -
performOperationOnMetaClass
protected void performOperationOnMetaClass(groovy.lang.ExpandoMetaClass.Callable c) -
checkInitalised
protected void checkInitalised()Description copied from class:MetaClassImplchecks 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.- Overrides:
checkInitalisedin classMetaClassImpl
-
registerBeanProperty
public void registerBeanProperty(java.lang.String property, java.lang.Object newValue)Registers a new bean property- Parameters:
property- The property namenewValue- The properties initial value
-
registerInstanceMethod
Registers a new instance method for the given method name and closure on this MetaClass- Parameters:
metaMethod-
-
registerInstanceMethod
-
getMethods
Overrides the behavior of parent getMethods() method to make MetaClass aware of added Expando methods- Specified by:
getMethodsin interfaceMetaClass- Specified by:
getMethodsin interfaceMetaObjectProtocol- Overrides:
getMethodsin classMetaClassImpl- Returns:
- A list of MetaMethods
- See Also:
MetaObjectProtocol.getMethods()
-
getProperties
Description copied from class:MetaClassImplGet all the properties defined for this type- Specified by:
getPropertiesin interfaceMetaClass- Specified by:
getPropertiesin interfaceMetaObjectProtocol- Overrides:
getPropertiesin classMetaClassImpl- Returns:
- a list of MetaProperty objects
- See Also:
MetaProperty
-
registerStaticMethod
-
registerStaticMethod
protected void registerStaticMethod(java.lang.String name, Closure callable, java.lang.Class[] paramTypes)Registers a new static method for the given method name and closure on this MetaClass- Parameters:
name- The method namecallable- The callable Closure
-
getSubclassMetaMethods
protected java.lang.Object getSubclassMetaMethods(java.lang.String methodName)- Overrides:
getSubclassMetaMethodsin classMetaClassImpl
-
getJavaClass
public java.lang.Class getJavaClass()- Returns:
- The Java class enhanced by this MetaClass
-
refreshInheritedMethods
public void refreshInheritedMethods(java.util.Set modifiedSuperExpandos)Called from ExpandoMetaClassCreationHandle in the registry if it exists to set up inheritance handling- Parameters:
modifiedSuperExpandos- A list of modified super ExpandoMetaClass
-
getExpandoMethods
Returns a list of expando MetaMethod instances added to this ExpandoMetaClass- Returns:
- the expandoMethods
-
getExpandoProperties
Returns a list of MetaBeanProperty instances added to this ExpandoMetaClass- Returns:
- the expandoProperties
-
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)Overrides default implementation just in case invokeMethod has been overridden by ExpandoMetaClass- Specified by:
invokeMethodin interfaceMetaClass- Overrides:
invokeMethodin classMetaClassImpl- 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:
MetaClassImpl.invokeMethod(Class, Object, String, Object[], boolean, boolean)
-
invokeStaticMethod
public java.lang.Object invokeStaticMethod(java.lang.Object object, java.lang.String methodName, java.lang.Object[] arguments)Overrides default implementation just in case a static invoke method has been set on ExpandoMetaClass- Specified by:
invokeStaticMethodin interfaceMetaObjectProtocol- Overrides:
invokeStaticMethodin classMetaClassImpl- 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:
MetaClassImpl.invokeStaticMethod(Object, String, Object[])
-
getProperty
public java.lang.Object getProperty(java.lang.Class sender, java.lang.Object object, java.lang.String name, boolean useSuper, boolean fromInsideClass)Overrides default implementation just in case getProperty method has been overridden by ExpandoMetaClass- Specified by:
getPropertyin interfaceMetaClass- Overrides:
getPropertyin classMetaClassImpl- 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
- See Also:
MetaClassImpl.getProperty(Class, Object, String, boolean, boolean)
-
getProperty
public java.lang.Object getProperty(java.lang.Object object, java.lang.String name)Overrides default implementation just in case getProperty method has been overridden by ExpandoMetaClass- Specified by:
getPropertyin interfaceMetaObjectProtocol- Overrides:
getPropertyin classMetaClassImpl- Parameters:
object- The Object which the property is being retrieved fromname- The name of the property- Returns:
- The properties value
- See Also:
MetaClassImpl.getProperty(Object, String)
-
setProperty
public void setProperty(java.lang.Class sender, java.lang.Object object, java.lang.String name, java.lang.Object newValue, boolean useSuper, boolean fromInsideClass)Overrides default implementation just in case setProperty method has been overridden by ExpandoMetaClass- Specified by:
setPropertyin interfaceMetaClass- Overrides:
setPropertyin classMetaClassImpl- 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.- See Also:
MetaClassImpl.setProperty(Class, Object, String, Object, boolean, boolean)
-
getMetaProperty
Looks up an existing MetaProperty by name- Specified by:
getMetaPropertyin interfaceMetaObjectProtocol- Overrides:
getMetaPropertyin classMetaClassImpl- Parameters:
name- The name of the MetaProperty- Returns:
- The MetaProperty or null if it doesn't exist
- See Also:
MetaObjectProtocol.getMetaProperty(String)
-
hasMetaProperty
public boolean hasMetaProperty(java.lang.String name)Returns true if the MetaClass has the given property- Parameters:
name- The name of the MetaProperty- Returns:
- True it exists as a MetaProperty
-
hasMetaMethod
public boolean hasMetaMethod(java.lang.String name, java.lang.Class[] args)Checks whether a MetaMethod for the given name and arguments exists- Parameters:
name- The name of the MetaMethodargs- The arguments to the meta method- Returns:
- True if the method exists otherwise null
-
getPropertyForSetter
public java.lang.String getPropertyForSetter(java.lang.String setterName)Returns a property name equivalent for the given setter name or null if it is not a getter- Parameters:
setterName- The setter name- Returns:
- The property name equivalent
-
isSetter
-
createPojoCallSite
public CallSite createPojoCallSite(CallSite site, java.lang.Object receiver, java.lang.Object[] args)Description copied from class:MetaClassImplCreate a CallSite- Overrides:
createPojoCallSitein classMetaClassImpl
-
createStaticSite
Description copied from class:MetaClassImplCreate a CallSite- Overrides:
createStaticSitein classMetaClassImpl
-
hasCustomStaticInvokeMethod
public boolean hasCustomStaticInvokeMethod()Description copied from class:MetaClassImplindicates is the meta class method invocation for static methods is done through a custom invoker object.- Overrides:
hasCustomStaticInvokeMethodin classMetaClassImpl- Returns:
- true - if the method invocation is not done by the meta class itself
-
createPogoCallSite
Description copied from class:MetaClassImplCreate a CallSite- Overrides:
createPogoCallSitein classMetaClassImpl
-
createPogoCallCurrentSite
-
retrieveConstructor
Description copied from class:MetaClassImplThis is a helper method added in Groovy 2.1.0, which is used only by indy. This method is for internal use only.- Overrides:
retrieveConstructorin classMetaClassImpl
-
createConstructorSite
Description copied from class:MetaClassImplCreate a CallSite- Overrides:
createConstructorSitein classMetaClassImpl
-