public interface MetaObjectProtocol
An interface that defines the API usable by clients of Groovy's Meta Object Protocol (MOP). These methods are implemented by the reference implementation of the MetaClass interface.
Type Params | Return Type | Name and description |
---|---|---|
|
public Object |
getAttribute(Object object, String attribute) Retrieves an attribute of an instance of the class returned by the getTheClass() method. |
|
public MetaMethod |
getMetaMethod(String name, Object[] args) Retrieves an instance MetaMethod for the given name and argument values, using the types of the argument values to establish the chosen MetaMethod |
|
public MetaProperty |
getMetaProperty(String name) Returns a MetaProperty for the given name or null if it doesn't exist |
|
public List<MetaMethod> |
getMethods() Obtain a list of all the meta methods available on this metaclass |
|
public List<MetaProperty> |
getProperties() Obtain a list of all meta properties available on this metaclass |
|
public Object |
getProperty(Object object, String property) Retrieves a property of an instance of the class returned by the getTheClass() method. |
|
public MetaMethod |
getStaticMetaMethod(String name, Object[] args) Retrieves a static MetaMethod for the given name and argument values, using the types of the arguments to establish the chosen MetaMethod |
|
public Class |
getTheClass() Retrieves that Java Class that the attached Meta behaviours apply to |
|
public MetaProperty |
hasProperty(Object obj, String name) |
|
public Object |
invokeConstructor(Object[] arguments) Invokes a constructor for the given arguments. |
|
public Object |
invokeMethod(Object object, String methodName, Object[] arguments) Invokes a method on the given Object with the given name and arguments. |
|
public Object |
invokeMethod(Object object, String methodName, Object arguments) Invokes a method on the given object, with the given name and single argument. |
|
public Object |
invokeStaticMethod(Object object, String methodName, Object[] arguments) Invokes a static method on the given Object with the given name and arguments. |
|
public List<MetaMethod> |
respondsTo(Object obj, String name, Object[] argTypes) |
|
public List<MetaMethod> |
respondsTo(Object obj, String name) |
|
public void |
setAttribute(Object object, String attribute, Object newValue) Sets an attribute of an instance of the class returned by the getTheClass() method. |
|
public void |
setProperty(Object object, String property, Object newValue) Sets a property of an instance of the class returned by the getTheClass() method. |
Retrieves an attribute of an instance of the class returned by the getTheClass() method.
What this means is largely down to the MetaClass implementation, however the default case would result in attempt to read a field of the instance.
object
- An instance of the class returned by the getTheClass() methodattribute
- The name of the attribute to retrieve the value forRetrieves an instance MetaMethod for the given name and argument values, using the types of the argument values to establish the chosen MetaMethod
name
- The name of the MetaMethodargs
- Array containing - 1) the argument values (using which their types are then inferred), or 2) the corresponding argument typesReturns a MetaProperty for the given name or null if it doesn't exist
name
- The name of the MetaPropertyObtain a list of all the meta methods available on this metaclass
Obtain a list of all meta properties available on this metaclass
Retrieves a property of an instance of the class returned by the getTheClass() method.
What this means is largely down to the MetaClass implementation, however the default case would result in an attempt to invoke a JavaBean getter, or if no such getter exists a public field of the instance.
object
- An instance of the class returned by the getTheClass() methodproperty
- The name of the property to retrieve the value forRetrieves a static MetaMethod for the given name and argument values, using the types of the arguments to establish the chosen MetaMethod
name
- The name of the MetaMethodargs
- The argument typesRetrieves that Java Class that the attached Meta behaviours apply to
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
obj
- The object to inspectname
- The name of the propertyInvokes 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
arguments
- The arguments to the constructorInvokes a method on the given Object with the given name and arguments. The MetaClass will attempt to pick the best method for the given name and arguments. If a method cannot be invoked a MissingMethodException will be thrown.
object
- The instance which the method is invoked onmethodName
- The name of the methodarguments
- The arguments to the methodInvokes a method on the given object, with the given name and single argument.
object
- The Object to invoke the method onmethodName
- The name of the methodarguments
- The argument to the methodInvokes a static method on the given Object with the given name and arguments.
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
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 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
obj
- The object to inspectname
- The name of the method of interestargTypes
- The argument types to match against
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
obj
- The object to inspectname
- The name of the method of interestSets an attribute of an instance of the class returned by the getTheClass() method.
What this means is largely down to the MetaClass implementation, however the default case would result in an attempt to set a field of the instance.
object
- An instance of the class returned by the getTheClass() methodattribute
- The name of the attribute to setnewValue
- The new value of the attributeSets a property of an instance of the class returned by the getTheClass() method.
What this means is largely down to the MetaClass implementation, however the default case would result in an attempt to invoke a JavaBean setter, or if no such setter exists to set a public field of the instance.
object
- An instance of the class returned by the getTheClass() methodproperty
- The name of the property to setnewValue
- The new value of the property