Closure (Groovy (1.1-rc-3))

java.lang.Object
- groovy.lang.GroovyObjectSupport
- - groovy.lang.Closure

All Implemented Interfaces:

GroovyObject, java.lang.Cloneable, java.lang.Runnable

Direct Known Subclasses:

CurriedClosure, IteratorClosureAdapter, MethodClosure
```
public abstract class Closure
extends GroovyObjectSupport
implements java.lang.Cloneable, java.lang.Runnable
```
Represents any closure object in Groovy.
Groovy allows instances of Closures to be called in a short form. For example:
```
   def a = 1
   def c = {a}
   assert c() == 1
 
```
To be able to use a Closure in this way with your own subclass, you need to provide a doCall method with any signature you want to. This ensures that getMaximumNumberOfParameters() and getParameterTypes() will work too without any additional code. If no doCall method is provided a closure must be used in its long form like
```
   def a = 1
   def c = {a}
   assert c.call() == 1
 
```
Version:

$Revision: 9482 $

Author:

James Strachan, John Wilson, Jochen Theodorou, Graeme Rocher

Field Summary

Fields
Modifier and Type	Field and Description
`static int`	`DELEGATE_FIRST` With this resolveStrategy set the closure will attempt to resolve property references to the delegate first
`static int`	`DELEGATE_ONLY` With this resolveStrategy set the closure will resolve property references to the delegate only and entirely bypass the owner
`static int`	`DONE`
`protected int`	`maximumNumberOfParameters`
`static int`	`OWNER_FIRST` With this resolveStrategy set the closure will attempt to resolve property references to the owner first
`static int`	`OWNER_ONLY` With this resolveStrategy set the closure will resolve property references to the owner only and not call the delegate at all
`static int`	`SKIP`
`static int`	`TO_SELF` With this resolveStrategy set the closure will resolve property references to itself and go through the usual MetaClass look-up process.

Constructor Summary

Constructors
Constructor and Description

Closure(java.lang.Object owner)

Closure(java.lang.Object owner, java.lang.Object thisObject)

Constructors
Constructor and Description
`Closure(java.lang.Object owner)`
`Closure(java.lang.Object owner, java.lang.Object thisObject)`

Method Summary

Methods
Modifier and Type	Method and Description
`Closure`	`asWritable()`
`java.lang.Object`	`call()` Invokes the closure without any parameters, returning any value if applicable.
`java.lang.Object`	`call(java.lang.Object arguments)` Invokes the closure, returning any value if applicable.
`java.lang.Object`	`call(java.lang.Object[] args)`
`java.lang.Object`	`clone()`
`Closure`	`curry(java.lang.Object[] arguments)` Support for closure currying
`java.lang.Object`	`getDelegate()`
`int`	`getDirective()`
`int`	`getMaximumNumberOfParameters()`
`java.lang.Object`	`getOwner()`
`java.lang.Class[]`	`getParameterTypes()`
`java.lang.Object`	`getProperty(java.lang.String property)`
`int`	`getResolveStrategy()` Gets the strategy which the closure users to resolve methods and properties
`java.lang.Object`	`getThisObject()`
`boolean`	`isCase(java.lang.Object candidate)`
`void`	`run()`
`void`	`setDelegate(java.lang.Object delegate)` Allows the delegate to be changed such as when performing markup building
`void`	`setDirective(int directive)`
`void`	`setProperty(java.lang.String property, java.lang.Object newValue)` Sets the given property to the new value
`void`	`setResolveStrategy(int resolveStrategy)` Sets the strategy which the closure uses to resolve property references.
`protected static java.lang.Object`	`throwRuntimeException(java.lang.Throwable throwable)`

Methods inherited from class groovy.lang.GroovyObjectSupport
getMetaClass, invokeMethod, setMetaClass

Methods inherited from class java.lang.Object
equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - OWNER_FIRST
```
public static final int OWNER_FIRST
```
    With this resolveStrategy set the closure will attempt to resolve property references to the owner first
    
    See Also:
    Constant Field Values
  - DELEGATE_FIRST
```
public static final int DELEGATE_FIRST
```
    With this resolveStrategy set the closure will attempt to resolve property references to the delegate first
    
    See Also:
    Constant Field Values
  - OWNER_ONLY
```
public static final int OWNER_ONLY
```
    With this resolveStrategy set the closure will resolve property references to the owner only and not call the delegate at all
    
    See Also:
    Constant Field Values
  - DELEGATE_ONLY
```
public static final int DELEGATE_ONLY
```
    With this resolveStrategy set the closure will resolve property references to the delegate only and entirely bypass the owner
    
    See Also:
    Constant Field Values
  - TO_SELF
```
public static final int TO_SELF
```
    With this resolveStrategy set the closure will resolve property references to itself and go through the usual MetaClass look-up process. This allows the developer to override getProperty using ExpandoMetaClass of the closure itself
    
    See Also:
    Constant Field Values
  - maximumNumberOfParameters
```
protected int maximumNumberOfParameters
```
  - DONE
```
public static final int DONE
```
    See Also:
    Constant Field Values
  - SKIP
```
public static final int SKIP
```
    See Also:
    Constant Field Values
- Constructor Detail
  - Closure
```
public Closure(java.lang.Object owner,
       java.lang.Object thisObject)
```
  - Closure
```
public Closure(java.lang.Object owner)
```
- Method Detail
  - setResolveStrategy
```
public void setResolveStrategy(int resolveStrategy)
```
    Sets the strategy which the closure uses to resolve property references. The default is Closure.OWNER_FIRST
    
    Parameters:
    resolveStrategy - The resolve strategy to set
    See Also:
    DELEGATE_FIRST, DELEGATE_ONLY, OWNER_FIRST, OWNER_ONLY, TO_SELF
  - getResolveStrategy
```
public int getResolveStrategy()
```
    Gets the strategy which the closure users to resolve methods and properties
    
    Returns:
    The resolve strategy
    See Also:
    DELEGATE_FIRST, DELEGATE_ONLY, OWNER_FIRST, OWNER_ONLY, TO_SELF
  - getThisObject
```
public java.lang.Object getThisObject()
```
  - getProperty
```
public java.lang.Object getProperty(java.lang.String property)
```
    Specified by:
    
    getProperty in interface GroovyObject
    
    Overrides:
    
    getProperty in class GroovyObjectSupport
    
    Returns:
    the given property
  - setProperty
```
public void setProperty(java.lang.String property,
               java.lang.Object newValue)
```
    Description copied from interface: GroovyObject
    
    Sets the given property to the new value
    
    Specified by:
    
    setProperty in interface GroovyObject
    
    Overrides:
    
    setProperty in class GroovyObjectSupport
  - isCase
```
public boolean isCase(java.lang.Object candidate)
```
  - call
```
public java.lang.Object call()
```
    Invokes the closure without any parameters, returning any value if applicable.
    
    Returns:
    the value if applicable or null if there is no return statement in the closure
  - call
```
public java.lang.Object call(java.lang.Object[] args)
```
  - call
```
public java.lang.Object call(java.lang.Object arguments)
```
    Invokes the closure, returning any value if applicable.
    
    Parameters:
    arguments - could be a single value or a List of values
    
    Returns:
    the value if applicable or null if there is no return statement in the closure
  - throwRuntimeException
```
protected static java.lang.Object throwRuntimeException(java.lang.Throwable throwable)
```
  - getOwner
```
public java.lang.Object getOwner()
```
    Returns:
    the owner Object to which method calls will go which is typically the outer class when the closure is constructed
  - getDelegate
```
public java.lang.Object getDelegate()
```
    Returns:
    the delegate Object to which method calls will go which is typically the outer class when the closure is constructed
  - setDelegate
```
public void setDelegate(java.lang.Object delegate)
```
    Allows the delegate to be changed such as when performing markup building
    
    Parameters:
    delegate - the new delegate
  - getParameterTypes
```
public java.lang.Class[] getParameterTypes()
```
    Returns:
    the parameter types of the longest doCall method of this closure
  - getMaximumNumberOfParameters
```
public int getMaximumNumberOfParameters()
```
    Returns:
    the maximum number of parameters a doCall methos of this closure can take
  - asWritable
```
public Closure asWritable()
```
    Returns:
    a version of this closure which implements Writable
  - run
```
public void run()
```
    Specified by:
    
    run in interface java.lang.Runnable
  - curry
```
public Closure curry(java.lang.Object[] arguments)
```
    Support for closure currying
    
    Parameters:
    arguments - the arguments to bind
    
    Returns:
    the new closure with its arguments bound
  - clone
```
public java.lang.Object clone()
```
    Overrides:
    
    clone in class java.lang.Object
  - getDirective
```
public int getDirective()
```
    Returns:
    Returns the directive.
  - setDirective
```
public void setDirective(int directive)
```
    Parameters:
    directive - The directive to set.

Class Closure

Field Summary

Constructor Summary

Method Summary

Methods inherited from class groovy.lang.GroovyObjectSupport

Methods inherited from class java.lang.Object

Field Detail

OWNER_FIRST

DELEGATE_FIRST

OWNER_ONLY

DELEGATE_ONLY

TO_SELF

maximumNumberOfParameters

DONE

SKIP

Constructor Detail

Closure

Closure

Method Detail

setResolveStrategy

getResolveStrategy

getThisObject

getProperty

setProperty

isCase

call

call

call

throwRuntimeException

getOwner

getDelegate

setDelegate

getParameterTypes

getMaximumNumberOfParameters

asWritable

run

curry

clone

getDirective

setDirective