ClosureMetaClass (Groovy 6.0.0-alpha-2)

org.codehaus.groovy.runtime.metaclass.ClosureMetaClass

```
public final class ClosureMetaClass
extends MetaClassImpl
```
A metaclass for closures generated by the Groovy compiler. These classes have special characteristics this MetaClass uses. One of these is that a generated Closure has only additional doCall methods, all other methods are in the Closure class as well. To use this fact this MetaClass uses a MetaClass for Closure as static field And delegates calls to this MetaClass if needed. This allows a lean implementation for this MetaClass. Multiple generated closures will then use the same MetaClass for Closure. For static dispatching this class uses the MetaClass of Class, again all instances of this class will share that MetaClass. The Class MetaClass is initialized lazy, because most operations do not need this MetaClass.
The Closure and Class metaclasses are not replaceable.
This MetaClass is for internal usage only!
Since:
1.5

Inherited fields
Fields inherited from class	Fields
`class MetaClassImpl`	`EMPTY_ARGUMENTS, INVOKE_METHOD_METHOD, METHOD_MISSING, PROPERTY_MISSING, STATIC_METHOD_MISSING, STATIC_PROPERTY_MISSING, getPropertyMethod, invokeMethodMethod, isGroovyObject, isMap, metaMethodIndex, registry, setPropertyMethod, theCachedClass, theClass`

Constructor Summary

Constructors
Constructor and description
`ClosureMetaClass(MetaClassRegistry registry, Class theClass)` Constructs a new ClosureMetaClass for the given closure class.

Methods Summary

Methods
Type Params	Return Type	Name and description
	`public void`	`addMetaBeanProperty(MetaBeanProperty mp)` Adds a meta bean property to this metaclass.
	`public void`	`addMetaMethod(MetaMethod method)` Adds a meta method to this metaclass.
	`public void`	`addNewInstanceMethod(Method method)` Adds a new instance method to this metaclass.
	`public void`	`addNewStaticMethod(Method method)` Adds a new static method to this metaclass.
	`protected void`	`applyPropertyDescriptors(PropertyDescriptor[] propertyDescriptors)`
	`public CallSite`	`createPogoCallCurrentSite(CallSite site, Class sender, Object[] args)` Creates a POGO call site for the current class context.
	`public CallSite`	`createPogoCallSite(CallSite site, Object[] args)` Creates a POGO (Plain Old Groovy Object) call site for this metaclass.
	`public CallSite`	`createPojoCallSite(CallSite site, Object receiver, Object[] args)` Creates a POJO (Plain Old Java Object) call site for this metaclass.
	`public Object`	`getAttribute(Class sender, Object object, String attribute, boolean useSuper, boolean fromInsideClass)` Gets an attribute from the closure or the object it represents.
	`public List<MetaMethod>`	`getMetaMethods()` Returns a list of all metamethods in the Closure metaclass.
	`public MetaProperty`	`getMetaProperty(String name)` Gets the meta property for the given name from the closure metaclass.
	`public MetaMethod`	`getMethodWithoutCaching(int index, Class sender, String methodName, Class[] arguments, boolean isCallToSuper)` Gets a method without using the cache.
	`public List<MetaMethod>`	`getMethods()` Returns a list of all methods available to closures, including both closure-specific doCall methods and inherited Closure class methods.
	`public List<MetaProperty>`	`getProperties()` Returns a list of all properties available to closures.
	`public Object`	`getProperty(Class sender, Object object, String name, boolean useSuper, boolean fromInsideClass)` Gets a property on the closure or the object it represents.
	`public MetaMethod`	`getStaticMetaMethod(String name, Object[] args)` Gets a static meta method by name and argument objects.
	`public MetaMethod`	`getStaticMetaMethod(String name, Class[] argTypes)` Gets a static meta method by name and argument types.
	`public void`	`initialize()` Initializes the closure metaclass by discovering and indexing all closure-related methods.
	`public Object`	`invokeMethod(Class sender, Object object, String methodName, Object[] arguments, boolean isCallToSuper, boolean fromInsideClass)`
	`public Object`	`invokeStaticMethod(Object object, String methodName, Object[] arguments)` Invokes a static method on the closure class itself.
	`public MetaMethod`	`pickMethod(String methodName, Class[] argumentTypes)` Picks the most appropriate method from the available closure methods that matches the given method name and argument types.
	`public static void`	`resetCachedMetaClasses()` Resets the cached metaclasses for Closure and Class.
	`public List`	`respondsTo(Object obj, String name, Object[] argTypes)` Checks if this metaclass responds to the given method name with the specified argument types.
	`public List`	`respondsTo(Object obj, String name)` Checks if this metaclass responds to the given method name.
	`public Constructor`	`retrieveConstructor(Class[] arguments)` Retrieves a constructor matching the given argument types.
	`public MetaMethod`	`retrieveStaticMethod(String methodName, Class[] arguments)` Retrieves a static method with the given name and argument types.
	`public void`	`setAttribute(Class sender, Object object, String attribute, Object newValue, boolean useSuper, boolean fromInsideClass)` Sets an attribute on the closure or the object it represents.
	`public void`	`setProperties(Object bean, Map map)` Sets multiple properties on a bean.
	`public void`	`setProperty(Class sender, Object object, String name, Object newValue, boolean useSuper, boolean fromInsideClass)` Sets a property on the closure or the object it represents.

Inherited Methods Summary

Inherited Methods
Methods inherited from class	Name
`class MetaClassImpl`	addMetaBeanProperty, addMetaMethod, addMetaMethodToIndex, addNewInstanceMethod, addNewStaticMethod, applyPropertyDescriptors, checkIfGroovyObjectMethod, checkInitalised, chooseMethod, clearInvocationCaches, createConstructorSite, createErrorMessageForAmbiguity, createPogoCallCurrentSite, createPogoCallSite, createPojoCallSite, createStaticSite, createTransformMetaMethod, doChooseMostSpecificParams, dropMethodCache, dropStaticMethodCache, findMethodInClassHierarchy, findMixinMethod, findOwnMethod, findPropertyInClassHierarchy, getAdditionalMetaMethods, getAttribute, getAttribute, getAttribute, getClassInfo, getClassNode, getEffectiveGetMetaProperty, getMetaMethod, getMetaMethods, getMetaProperty, getMethodWithCaching, getMethodWithoutCaching, getMethods, getNonClosureOuter, getProperties, getProperty, getProperty, getRegistry, getStaticMetaMethod, getSubclassMetaMethods, getSuperClasses, getTheCachedClass, getTheClass, getVersion, handleMatches, hasCustomInvokeMethod, hasCustomStaticInvokeMethod, hasProperty, incVersion, initialize, invokeConstructor, invokeMethod, invokeMethod, invokeMethod, invokeMissingMethod, invokeMissingProperty, invokeStaticMethod, invokeStaticMissingProperty, isGroovyObject, isInitialized, isModified, isPermissivePropertyAccess, onGetPropertyFoundInHierarchy, onInvokeMethodFoundInHierarchy, onMixinMethodFound, onSetPropertyFoundInHierarchy, onSuperMethodFoundInHierarchy, onSuperPropertyFoundInHierarchy, pickMethod, reinitialize, respondsTo, respondsTo, retrieveConstructor, retrieveConstructor, retrieveStaticMethod, selectConstructorAndTransformArguments, setAttribute, setAttribute, setInitialized, setPermissivePropertyAccess, setProperties, setProperty, setProperty, toString

- Constructor Detail
  - public ClosureMetaClass(MetaClassRegistry registry, Class theClass)
    
    Constructs a new ClosureMetaClass for the given closure class. This metaclass handles method invocation and property access for closure instances, providing special handling for closure-specific behavior.
    Parameters:
    registry - the metaclass registry
    theClass - the closure class this metaclass represents
- Method Detail
  - public void addMetaBeanProperty(MetaBeanProperty mp)
    
    Adds a meta bean property to this metaclass. This operation is not supported for ClosureMetaClass as it is immutable.
    throws:
    UnsupportedOperationException this method is not supported for closures
    
    Parameters:
    mp - the meta bean property to add
  - public void addMetaMethod(MetaMethod method)
    
    Adds a meta method to this metaclass. This operation is not supported for ClosureMetaClass as it is immutable.
    throws:
    UnsupportedOperationException this method is not supported for closures
    
    Parameters:
    method - the meta method to add
  - public void addNewInstanceMethod(Method method)
    
    Adds a new instance method to this metaclass. This operation is not supported for ClosureMetaClass as it is immutable.
    throws:
    UnsupportedOperationException this method is not supported for closures
    
    Parameters:
    method - the method to add
  - public void addNewStaticMethod(Method method)
    
    Adds a new static method to this metaclass. This operation is not supported for ClosureMetaClass as it is immutable.
    throws:
    UnsupportedOperationException this method is not supported for closures
    
    Parameters:
    method - the static method to add
  - protected void applyPropertyDescriptors(PropertyDescriptor[] propertyDescriptors)
  - public CallSite createPogoCallCurrentSite(CallSite site, Class sender, Object[] args)
    
    Creates a POGO call site for the current class context. Provides optimized method invocation for POGO objects within a specific class context.
    Parameters:
    site - the call site
    sender - the class sending the call
    args - the arguments
    Returns:
    a POGO-specific call site
  - public CallSite createPogoCallSite(CallSite site, Object[] args)
    
    Creates a POGO (Plain Old Groovy Object) call site for this metaclass. Provides optimized method invocation for POGO objects.
    Parameters:
    site - the call site
    args - the arguments
    Returns:
    a POGO-specific call site
  - public CallSite createPojoCallSite(CallSite site, Object receiver, Object[] args)
    
    Creates a POJO (Plain Old Java Object) call site for this metaclass. This operation is not supported for ClosureMetaClass.
    throws:
    UnsupportedOperationException this method is not supported for closures
    
    Parameters:
    site - the call site
    receiver - the receiver object
    args - the arguments
    Returns:
    never returns; always throws UnsupportedOperationException
  - public Object getAttribute(Class sender, Object object, String attribute, boolean useSuper, boolean fromInsideClass)
    
    Gets an attribute from the closure or the object it represents. For Class objects, delegates to the static metaclass. For closures, checks the cached fields first before delegating to the Closure metaclass.
    Parameters:
    sender - the class that is sending this request
    object - the object to get the attribute from
    attribute - the name of the attribute
    useSuper - whether to use super resolution
    fromInsideClass - whether the call is from inside the class
    Returns:
    the attribute value
  - public List<MetaMethod> getMetaMethods()
    
    Returns a list of all metamethods in the Closure metaclass.
    Returns:
    a list of all metamethods
  - public MetaProperty getMetaProperty(String name)
    
    Gets the meta property for the given name from the closure metaclass.
    Parameters:
    name - the property name
    Returns:
    the meta property or null if not found
  - public MetaMethod getMethodWithoutCaching(int index, Class sender, String methodName, Class[] arguments, boolean isCallToSuper)
    
    Gets a method without using the cache. This operation is not supported for ClosureMetaClass.
    throws:
    UnsupportedOperationException this method is not supported for closures
    
    Parameters:
    index - the method index
    sender - the class that is sending this request
    methodName - the name of the method
    arguments - the argument types
    isCallToSuper - whether this is a call to a super method
    Returns:
    never returns; always throws UnsupportedOperationException
  - public List<MetaMethod> getMethods()
    
    Returns a list of all methods available to closures, including both closure-specific doCall methods and inherited Closure class methods.
    Returns:
    a list of all available methods
  - public List<MetaProperty> getProperties()
    
    Returns a list of all properties available to closures.
    Returns:
    a list of all available properties
  - public Object getProperty(Class sender, Object object, String name, boolean useSuper, boolean fromInsideClass)
    
    Gets a property on the closure or the object it represents. For Class objects, delegates to the static metaclass; otherwise delegates to Closure metaclass.
    Parameters:
    sender - the class that is sending this request
    object - the object to get the property from
    name - the name of the property
    useSuper - whether to use super resolution
    fromInsideClass - whether the call is from inside the class
    Returns:
    the property value
  - public MetaMethod getStaticMetaMethod(String name, Object[] args)
    
    Gets a static meta method by name and argument objects. Delegates to the Closure metaclass.
    Parameters:
    name - the name of the static method
    args - the arguments
    Returns:
    the matching static meta method, or null if not found
  - public MetaMethod getStaticMetaMethod(String name, Class[] argTypes)
    
    Gets a static meta method by name and argument types. Delegates to the Closure metaclass.
    Parameters:
    name - the name of the static method
    argTypes - the argument types
    Returns:
    the matching static meta method, or null if not found
  - public void initialize()
    
    Initializes the closure metaclass by discovering and indexing all closure-related methods.
  - public Object invokeMethod(Class sender, Object object, String methodName, Object[] arguments, boolean isCallToSuper, boolean fromInsideClass)
  - public Object invokeStaticMethod(Object object, String methodName, Object[] arguments)
    
    Invokes a static method on the closure class itself. Delegates to the static metaclass.
    Parameters:
    object - the object on which to invoke the static method
    methodName - the name of the static method
    arguments - the arguments to pass to the method
    Returns:
    the result of the method invocation
  - public MetaMethod pickMethod(String methodName, Class[] argumentTypes)
    
    Picks the most appropriate method from the available closure methods that matches the given method name and argument types.
    Parameters:
    methodName - the name of the method to pick (typically "call" or "doCall" for closures)
    argumentTypes - the types of arguments to match against method signatures
    Returns:
    the matching method, or null if no match is found
  - public static void resetCachedMetaClasses()
    
    Resets the cached metaclasses for Closure and Class. This method is used to reinitialize the metaclass caches when the system configuration changes, ensuring that any cached metaclass information is refreshed.
  - public List respondsTo(Object obj, String name, Object[] argTypes)
    
    Checks if this metaclass responds to the given method name with the specified argument types. Returns a list of methods that match the given name and signature.
    Parameters:
    obj - the object to check
    name - the method name
    argTypes - the argument types
    Returns:
    a list of matching methods, or an empty list if none match
  - public List respondsTo(Object obj, String name)
    
    Checks if this metaclass responds to the given method name. Returns a list of methods that match the given name.
    Parameters:
    obj - the object to check
    name - the method name
    Returns:
    a list of matching methods, or an empty list if none match
  - public Constructor retrieveConstructor(Class[] arguments)
    
    Retrieves a constructor matching the given argument types. This operation is not supported for ClosureMetaClass.
    throws:
    UnsupportedOperationException this method is not supported for closures
    
    Parameters:
    arguments - the argument types
    Returns:
    never returns; always throws UnsupportedOperationException
  - public MetaMethod retrieveStaticMethod(String methodName, Class[] arguments)
    
    Retrieves a static method with the given name and argument types. Closures do not support static methods, so this always returns null.
    Parameters:
    methodName - the name of the static method to retrieve
    arguments - the argument types
    Returns:
    null, as closures do not have static methods
  - public void setAttribute(Class sender, Object object, String attribute, Object newValue, boolean useSuper, boolean fromInsideClass)
    
    Sets an attribute on the closure or the object it represents. For Class objects, delegates to the static metaclass. For closures, checks the cached fields first before delegating to the Closure metaclass.
    Parameters:
    sender - the class that is sending this request
    object - the object on which to set the attribute
    attribute - the name of the attribute
    newValue - the new value for the attribute
    useSuper - whether to use super resolution
    fromInsideClass - whether the call is from inside the class
  - public void setProperties(Object bean, Map map)
    
    Sets multiple properties on a bean. This operation is not supported for ClosureMetaClass.
    throws:
    UnsupportedOperationException this method is not supported for closures
    
    Parameters:
    bean - the bean object
    map - the properties to set
  - public void setProperty(Class sender, Object object, String name, Object newValue, boolean useSuper, boolean fromInsideClass)
    
    Sets a property on the closure or the object it represents. For Class objects, delegates to the static metaclass; otherwise delegates to Closure metaclass.
    Parameters:
    sender - the class that is sending this request
    object - the object on which to set the property
    name - the name of the property
    newValue - the new value for the property
    useSuper - whether to use super resolution
    fromInsideClass - whether the call is from inside the class

Summary:
Constructor
Method

| Detail:
Constructor
Method

[Java] Class ClosureMetaClass

Constructor Summary

Methods Summary

Inherited Methods Summary

Constructor Detail

public ClosureMetaClass(MetaClassRegistry registry, Class theClass)

Method Detail

public void addMetaBeanProperty(MetaBeanProperty mp)

public void addMetaMethod(MetaMethod method)

public void addNewInstanceMethod(Method method)

public void addNewStaticMethod(Method method)

protected void applyPropertyDescriptors(PropertyDescriptor[] propertyDescriptors)

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

public CallSite createPogoCallSite(CallSite site, Object[] args)

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

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

public List<MetaMethod> getMetaMethods()

public MetaProperty getMetaProperty(String name)

public MetaMethod getMethodWithoutCaching(int index, Class sender, String methodName, Class[] arguments, boolean isCallToSuper)

public List<MetaMethod> getMethods()

public List<MetaProperty> getProperties()

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

public MetaMethod getStaticMetaMethod(String name, Object[] args)

public MetaMethod getStaticMetaMethod(String name, Class[] argTypes)

public void initialize()

public Object invokeMethod(Class sender, Object object, String methodName, Object[] arguments, boolean isCallToSuper, boolean fromInsideClass)

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

public MetaMethod pickMethod(String methodName, Class[] argumentTypes)

public static void resetCachedMetaClasses()

public List respondsTo(Object obj, String name, Object[] argTypes)

public List respondsTo(Object obj, String name)

public Constructor retrieveConstructor(Class[] arguments)

public MetaMethod retrieveStaticMethod(String methodName, Class[] arguments)

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

public void setProperties(Object bean, Map map)

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