CachedMethod (Groovy 6.0.0-alpha-1)

org.codehaus.groovy.reflection.CachedMethod

All Implemented Interfaces and Traits:

Comparable
```
public class CachedMethod
extends MetaMethod
implements Comparable
```
Caches reflection information about a single method for fast lookup and invocation.
Extends MetaMethod and implements Comparable for method sorting. Provides efficient access to method metadata and supports call site optimization.

Field Summary

Fields
Modifiers	Name	Description
`static CachedMethod[]`	`EMPTY_ARRAY`	An empty array constant representing zero cached methods.
`CachedClass`	`cachedClass`	The cached class that declares this method.

Inherited fields
Fields inherited from class	Fields
`class MetaMethod`	`EMPTY_ARRAY`

Constructor Summary

Constructors
Constructor and description
`CachedMethod(CachedClass clazz, Method method)` Constructs a `CachedMethod` for the given method within a cached class.
`CachedMethod(Method method)` Constructs a `CachedMethod` for the given Java method.

Methods Summary

Methods
Type Params	Return Type	Name and description
	`public boolean`	`canAccessLegally(Class<?> callerClass)` Checks whether the given caller class can legally access this method.
	`public int`	`compareTo(Object other)` Compares this cached method with another method-like object for ordering.
	`public CallSite`	`createPogoMetaMethodSite(CallSite site, MetaClassImpl metaClass, Class[] params)` Creates an optimized call site for invoking this method on POGO (Groovy) objects.
	`public CallSite`	`createPojoMetaMethodSite(CallSite site, MetaClassImpl metaClass, Class[] params)` Creates an optimized call site for invoking this method on POJO (plain Java) objects.
	`public CallSite`	`createStaticMetaMethodSite(CallSite site, MetaClassImpl metaClass, Class[] params)` Creates an optimized call site for invoking this static method.
	`public boolean`	`equals(Object other)` Checks equality with another method.
	`public static CachedMethod`	`find(Method method)` Finds a `CachedMethod` corresponding to the specified Java method by searching the cached methods of its declaring class.
`<T extends Annotation>`	`public T`	`getAnnotation(Class<T> annotationClass)` Returns the annotation of the specified type on this method, if present.
	`public Method`	`getCachedMethod()` Returns the underlying Java method, making it accessible if necessary.
	`public CachedClass`	`getDeclaringClass()` Returns the cached class that declares this method.
	`public String`	`getDescriptor()` Returns the bytecode method descriptor for this method (e.g., "(II)Z").
	`public int`	`getModifiers()` Returns the modifiers of this method (e.g., public, static, synchronized).
	`public String`	`getName()` Returns the name of this method.
	`public Class[]`	`getPT()` Returns the native Java parameter types of this method.
	`public ParameterTypes`	`getParamTypes()` Returns the parameter type information for this method.
	`public int`	`getParamsCount()` Returns the number of parameters this method accepts.
	`public Class`	`getReturnType()` Returns the return type of this method.
	`public String`	`getSignature()` Returns the complete method signature (name + bytecode descriptor).
	`public CachedMethod`	`getTransformedMethod()` Returns the transformed version of this method, if one exists.
	`public int`	`hashCode()` Returns the hash code for this cached method based on the underlying Java method.
	`public final Object`	`invoke(Object object, Object[] arguments)` Invokes this method on the given object with the specified arguments.
	`public boolean`	`isSynthetic()` Returns whether this method is synthetic (generated by the compiler).
	`public final Method`	`setAccessible()` Makes this method accessible and returns the underlying Java method.
	`public void`	`setTransformedMethod(CachedMethod transformedMethod)` Sets the transformed version of this method.
	`public String`	`toString()` Returns the string representation of the underlying Java method.

Inherited Methods Summary

Inherited Methods
Methods inherited from class	Name
`class MetaMethod`	`checkParameters, clone, doMethodInvoke, equal, equal, getDeclaringClass, getDescriptor, getModifiers, getMopName, getName, getReturnType, getSignature, invoke, isAbstract, isCacheable, isDefault, isMethod, isSame, processDoMethodInvokeException, toString`
`class ParameterTypes`	`coerceArgumentsToClasses, correctArguments, getNativeParameterTypes, getPT, getParameterTypes, isValidExactMethod, isValidExactMethod, isValidMethod, isValidMethod, isVargsMethod, isVargsMethod, setParametersTypes`

- Field Detail
  - public static final CachedMethod[] EMPTY_ARRAY
    
    An empty array constant representing zero cached methods.
  - public final CachedClass cachedClass
    
    The cached class that declares this method.
- Constructor Detail
  - public CachedMethod(CachedClass clazz, Method method)
    
    Constructs a CachedMethod for the given method within a cached class.
    Parameters:
    clazz - the cached class that declares this method
    method - the Java method to cache
  - public CachedMethod(Method method)
    
    Constructs a CachedMethod for the given Java method. Automatically resolves the cached class from the method's declaring class.
    Parameters:
    method - the Java method to cache
- Method Detail
  - public boolean canAccessLegally(Class<?> callerClass)
    
    Checks whether the given caller class can legally access this method.
    Parameters:
    callerClass - the class attempting to access this method
    Returns:
    true if access is allowed; false otherwise
  - public int compareTo(Object other)
    
    Compares this cached method with another method-like object for ordering. Comparison is based on method name, return type, parameters, and declaring class.
    Parameters:
    other - the object to compare with (typically another CachedMethod or Method)
    Returns:
    a negative, zero, or positive value if this method is less than, equal to, or greater than the other
  - public CallSite createPogoMetaMethodSite(CallSite site, MetaClassImpl metaClass, Class[] params)
    
    Creates an optimized call site for invoking this method on POGO (Groovy) objects. Attempts to compile the method for maximum performance.
    Parameters:
    site - the call site being created
    metaClass - the metaclass of the target object's class
    params - the parameter types of the call
    Returns:
    a call site optimized for POGO invocation
  - public CallSite createPojoMetaMethodSite(CallSite site, MetaClassImpl metaClass, Class[] params)
    
    Creates an optimized call site for invoking this method on POJO (plain Java) objects. Attempts to compile the method for maximum performance.
    Parameters:
    site - the call site being created
    metaClass - the metaclass of the target object's class
    params - the parameter types of the call
    Returns:
    a call site optimized for POJO invocation
  - public CallSite createStaticMetaMethodSite(CallSite site, MetaClassImpl metaClass, Class[] params)
    
    Creates an optimized call site for invoking this static method. Attempts to compile the method for maximum performance.
    Parameters:
    site - the call site being created
    metaClass - the metaclass associated with the static method
    params - the parameter types of the call
    Returns:
    a call site optimized for static method invocation
  - public boolean equals(Object other)
    
    Checks equality with another method. Two methods are equal if they represent the same underlying Java method.
    Parameters:
    other - the object to compare with
    Returns:
    true if this method equals the other object; false otherwise
  - public static CachedMethod find(Method method)
    
    Finds a CachedMethod corresponding to the specified Java method by searching the cached methods of its declaring class.
    Parameters:
    method - the method to find
    Returns:
    the cached method, or null if not found
  - <T extends Annotation> public T getAnnotation(Class<T> annotationClass)
    
    Returns the annotation of the specified type on this method, if present.
    Type Parameters:
    T - the annotation type
    Parameters:
    annotationClass - the class of the annotation to retrieve
    Returns:
    the annotation instance, or null if not present
  - public Method getCachedMethod()
    
    Returns the underlying Java method, making it accessible if necessary.
    Returns:
    the cached method with accessibility ensured
  - public CachedClass getDeclaringClass()
    
    Returns the cached class that declares this method.
    Returns:
    the declaring cached class
  - public String getDescriptor()
    
    Returns the bytecode method descriptor for this method (e.g., "(II)Z"). The descriptor encodes parameter and return types in JVM format.
    Returns:
    the method descriptor string
  - public int getModifiers()
    
    Returns the modifiers of this method (e.g., public, static, synchronized). See Modifier for modifier constants.
    Returns:
    the method modifiers
  - public String getName()
    
    Returns the name of this method.
    Returns:
    the method name
  - public Class[] getPT()
    
    Returns the native Java parameter types of this method.
    Returns:
    an array of parameter classes
  - public ParameterTypes getParamTypes()
    
    Returns the parameter type information for this method.
    Note: This method always returns null and is retained for compatibility.
    Returns:
    null
  - public int getParamsCount()
    
    Returns the number of parameters this method accepts.
    Returns:
    the parameter count
  - public Class getReturnType()
    
    Returns the return type of this method.
    Returns:
    the method's return class
  - public String getSignature()
    
    Returns the complete method signature (name + bytecode descriptor). For example: "toString()Ljava/lang/String;"
    Returns:
    the method signature
  - public CachedMethod getTransformedMethod()
    
    Returns the transformed version of this method, if one exists. Transformed methods are compiler-optimized variants.
    Returns:
    the transformed method, or null if no transformation exists
  - public int hashCode()
    
    Returns the hash code for this cached method based on the underlying Java method.
    Returns:
    the hash code
  - public final Object invoke(Object object, Object[] arguments)
    
    Invokes this method on the given object with the specified arguments. Handles accessibility, exception wrapping, and method invocation.
    throws:
    InvokerInvocationException if the method raises a checked exception or illegal access occurs
    throws:
    RuntimeException if the method raises an uncaught exception (except MissingMethodException)
    
    Parameters:
    object - the target object (may be null for static methods)
    arguments - the arguments to pass to the method
    Returns:
    the result of the method invocation
  - public boolean isSynthetic()
    
    Returns whether this method is synthetic (generated by the compiler).
    Returns:
    true if this method is synthetic; false otherwise
  - public final Method setAccessible()
    
    Makes this method accessible and returns the underlying Java method. Synonym for getCachedMethod().
    Returns:
    the cached method with accessibility ensured
  - public void setTransformedMethod(CachedMethod transformedMethod)
    
    Sets the transformed version of this method.
    Parameters:
    transformedMethod - the transformed method, or null to clear
  - public String toString()
    
    Returns the string representation of the underlying Java method.
    Returns:
    a string representation of this cached method

Summary:
Field
Constructor
Method

| Detail:
Field
Constructor
Method

[Java] Class CachedMethod

Field Summary

Constructor Summary

Methods Summary

Inherited Methods Summary

Field Detail

public static final CachedMethod[] EMPTY_ARRAY

public final CachedClass cachedClass

Constructor Detail

public CachedMethod(CachedClass clazz, Method method)

public CachedMethod(Method method)

Method Detail

public boolean canAccessLegally(Class<?> callerClass)

public int compareTo(Object other)

public CallSite createPogoMetaMethodSite(CallSite site, MetaClassImpl metaClass, Class[] params)

public CallSite createPojoMetaMethodSite(CallSite site, MetaClassImpl metaClass, Class[] params)

public CallSite createStaticMetaMethodSite(CallSite site, MetaClassImpl metaClass, Class[] params)

public boolean equals(Object other)

public static CachedMethod find(Method method)

<T extends Annotation> public T getAnnotation(Class<T> annotationClass)

public Method getCachedMethod()

public CachedClass getDeclaringClass()

public String getDescriptor()

public int getModifiers()

public String getName()

public Class[] getPT()

public ParameterTypes getParamTypes()

public int getParamsCount()

public Class getReturnType()

public String getSignature()

public CachedMethod getTransformedMethod()

public int hashCode()

public final Object invoke(Object object, Object[] arguments)

public boolean isSynthetic()

public final Method setAccessible()

public void setTransformedMethod(CachedMethod transformedMethod)

public String toString()