org.codehaus.groovy.grails.commons.metaclass

Class DynamicMethodsExpandoMetaClass

java.lang.Object

groovy.lang.MetaClassImpl

groovy.lang.ExpandoMetaClass

org.codehaus.groovy.grails.commons.metaclass.DynamicMethodsExpandoMetaClass

All Implemented Interfaces:

groovy.lang.GroovyObject, groovy.lang.MetaClass, groovy.lang.MetaObjectProtocol, groovy.lang.MutableMetaClass

public class DynamicMethodsExpandoMetaClass
extends groovy.lang.ExpandoMetaClass

Extends ExpandoMetaClass and adds the ability to use regex to specified method matches that then get passed to the invocable closure. Example: metaClass./^findBy(\w+)$/ = { matcher, args -> } The first argument to the closure is the Regex Matcher. The second is the arguments to the method. This MetaClass allows you to implement thigns like dynamic finders in a trivial manner. The regular expression MUST start with a ^ and end with a $ otherwise it won't be regarded as a valid regex expression and an error will be thrown. Otherwise the mechanism is similar to that provided by ExpandoMetaClass WARNING: Unlike ExpandoMetaClass this MetaClass uses method proxying, hence there is a an overhead attached to its use. This makes it less suitable for use on commonly used objects like java.lang.Object or java.lang.String if performance is important to your application consider other options like the regular ExpandoMetaClass If usage can be isolated to a small set of use cases (such as dynamic finders in Grails) then there is no problem as proxying is not occuring for every method call WARNING: This MetaClass does not support inheritance heirarchies. In other words a child class will not be able to invoke a dynamically added method that exists on a super class.

Since:

0.5

Nested Class Summary

Nested classes/interfaces inherited from class groovy.lang.ExpandoMetaClass

groovy.lang.ExpandoMetaClass.ExpandoMetaConstructor, groovy.lang.ExpandoMetaClass.ExpandoMetaProperty

Nested classes/interfaces inherited from class groovy.lang.MetaClassImpl

groovy.lang.MetaClassImpl.Index, groovy.lang.MetaClassImpl.MetaConstructor

Field Summary

Fields inherited from class groovy.lang.ExpandoMetaClass

CONSTRUCTOR, inRegistry, STATIC_QUALIFIER

Fields 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 and Description
DynamicMethodsExpandoMetaClass(java.lang.Class<?> aClass) Constructs a new DynamicMethodsExpandoMetaClass given the current class.
DynamicMethodsExpandoMetaClass(java.lang.Class<?> aClass, boolean inReg) Constructs a new DynamicMethodsExpandoMetaClass given the current class and places it in the MetaClassRegistry

Method Summary

Modifier and Type	Method and Description
java.lang.Object	getProperty(java.lang.Class aClass, java.lang.Object object, java.lang.String property, boolean b, boolean b1)
java.lang.Object	getProperty(java.lang.String name)
java.lang.Object	invokeConstructor(java.lang.Object[] arg0)
java.lang.Object	invokeMethod(java.lang.Class aClass, java.lang.Object target, java.lang.String methodName, java.lang.Object[] arguments, boolean b, boolean b1)
java.lang.Object	invokeStaticMethod(java.lang.Object target, java.lang.String methodName, java.lang.Object[] arguments) Either invokes a intercepted dyanmic static method or the adapted original MetaClass.
void	setProperty(java.lang.Class aClass, java.lang.Object object, java.lang.String property, java.lang.Object newValue, boolean b, boolean b1)
void	setProperty(java.lang.String name, java.lang.Object value)

Methods inherited from class groovy.lang.ExpandoMetaClass

addMixinClass, castToMixedType, checkInitalised, createConstructorSite, createPogoCallCurrentSite, createPogoCallSite, createPojoCallSite, createStaticSite, define, disableGlobally, enableGlobally, findMixinMethod, getExpandoMethods, getExpandoProperties, getExpandoSubclassMethods, getJavaClass, getMetaClass, getMetaProperty, getMethods, getProperties, getProperty, getPropertyForSetter, getSubclassMetaMethods, hasCustomStaticInvokeMethod, hasMetaMethod, hasMetaProperty, initialize, invokeMethod, isInitialized, isModified, isSetter, isValidExpandoProperty, onGetPropertyFoundInHierarchy, onInvokeMethodFoundInHierarchy, onSetPropertyFoundInHierarchy, onSuperMethodFoundInHierarchy, onSuperPropertyFoundInHierarchy, performOperationOnMetaClass, refreshInheritedMethods, registerBeanProperty, registerInstanceMethod, registerInstanceMethod, registerStaticMethod, registerStaticMethod, registerSubclassInstanceMethod, registerSubclassInstanceMethod, retrieveConstructor, setInitialized, setMetaClass

Methods inherited from class groovy.lang.MetaClassImpl

addMetaBeanProperty, addMetaMethod, addMetaMethodToIndex, addNewInstanceMethod, addNewStaticMethod, applyPropertyDescriptors, checkIfGroovyObjectMethod, chooseMethod, clearInvocationCaches, createPogoCallCurrentSite, dropMethodCache, dropStaticMethodCache, findMethodInClassHierarchy, findOwnMethod, findPropertyInClassHierarchy, getAdditionalMetaMethods, getAttribute, getAttribute, getAttribute, getClassInfo, getClassNode, getEffectiveGetMetaProperty, getMetaMethod, getMetaMethods, getMethodWithCaching, getMethodWithoutCaching, getRegistry, getStaticMetaMethod, getSuperClasses, getTheCachedClass, getTheClass, getVersion, hasCustomInvokeMethod, hasProperty, incVersion, invokeMethod, invokeMethod, invokeMissingMethod, invokeMissingProperty, invokeStaticMissingProperty, isGroovyObject, onMixinMethodFound, pickMethod, respondsTo, respondsTo, retrieveConstructor, retrieveStaticMethod, selectConstructorAndTransformArguments, setAttribute, setAttribute, setProperties, setProperty, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

DynamicMethodsExpandoMetaClass

public DynamicMethodsExpandoMetaClass(java.lang.Class<?> aClass)

Constructs a new DynamicMethodsExpandoMetaClass given the current class. Note that this constructor will NOT place this MetaClass in the MetaClassRegistry. It is up to you to either place it in the MetaClassRegistry or call setMetaClass on GroovyObject

Parameters:

aClass - The class to create the MetaClass for

DynamicMethodsExpandoMetaClass

public DynamicMethodsExpandoMetaClass(java.lang.Class<?> aClass,
                                      boolean inReg)

Constructs a new DynamicMethodsExpandoMetaClass given the current class and places it in the MetaClassRegistry

Parameters:

aClass - The class to create the MetaClass for

Method Detail

invokeStaticMethod

public java.lang.Object invokeStaticMethod(java.lang.Object target,
                                           java.lang.String methodName,
                                           java.lang.Object[] arguments)

Either invokes a intercepted dyanmic static method or the adapted original MetaClass.

Specified by:

invokeStaticMethod in interface groovy.lang.MetaObjectProtocol

Overrides:

invokeStaticMethod in class groovy.lang.ExpandoMetaClass

Parameters:

target - The target object

methodName - The method name

arguments - The arguments to the method

Returns:

The return value

setProperty

public void setProperty(java.lang.Class aClass,
                        java.lang.Object object,
                        java.lang.String property,
                        java.lang.Object newValue,
                        boolean b,
                        boolean b1)

Specified by:

setProperty in interface groovy.lang.MetaClass

Overrides:

setProperty in class groovy.lang.ExpandoMetaClass

getProperty

public java.lang.Object getProperty(java.lang.Class aClass,
                                    java.lang.Object object,
                                    java.lang.String property,
                                    boolean b,
                                    boolean b1)

Specified by:

getProperty in interface groovy.lang.MetaClass

Overrides:

getProperty in class groovy.lang.ExpandoMetaClass

invokeConstructor

public java.lang.Object invokeConstructor(java.lang.Object[] arg0)

Specified by:

invokeConstructor in interface groovy.lang.MetaObjectProtocol

Overrides:

invokeConstructor in class groovy.lang.ExpandoMetaClass

invokeMethod

public java.lang.Object invokeMethod(java.lang.Class aClass,
                                     java.lang.Object target,
                                     java.lang.String methodName,
                                     java.lang.Object[] arguments,
                                     boolean b,
                                     boolean b1)

Specified by:

invokeMethod in interface groovy.lang.MetaClass

Overrides:

invokeMethod in class groovy.lang.ExpandoMetaClass

getProperty

public java.lang.Object getProperty(java.lang.String name)

Specified by:

getProperty in interface groovy.lang.GroovyObject

Overrides:

getProperty in class groovy.lang.ExpandoMetaClass

setProperty

public void setProperty(java.lang.String name,
                        java.lang.Object value)

Specified by:

setProperty in interface groovy.lang.GroovyObject

Overrides:

setProperty in class groovy.lang.ExpandoMetaClass