PromiseFactory (Grails Async 6.0.0-M1)

```
interface PromiseFactory
```
An interface capable of creating Promise instances. The Promises static methods use this interface to create promises. The default Promise creation mechanism can be overridden by setting Promises.setPromiseFactory
Authors:
Graeme Rocher
Since:
2.3

Methods Summary

Methods
Type Params	Return Type	Name and description
	`abstract void`	`addPromiseDecoratorLookupStrategy(PromiseDecoratorLookupStrategy lookupStrategy)` Adds a PromiseDecoratorLookupStrategy.
`<T>`	`abstract groovy.lang.Closure<T>`	`applyDecorators(groovy.lang.Closure<T> c, java.util.List<PromiseDecorator> decorators)` Applies the registered decorators to the given closure
`<T>`	`abstract Promise<T>`	`createBoundPromise(T value)` Creates a promise with a value pre-bound to it
`<T>`	`abstract Promise<T>`	`createPromise(java.lang.Class<T> returnType)` Creates an unfulfilled promise that returns the given type
	`abstract Promise<java.lang.Void>`	`createPromise()` Creates an unfulfilled promise that returns void
`<K, V>`	`abstract Promise<java.util.Map<K, V>>`	`createPromise(java.util.Map<K, V> map)` Creates a promise from the given map where the values of the map are either closures or Promise instances
`<K, V>`	`abstract Promise<java.util.Map<K, V>>`	`createPromise(java.util.Map<K, V> map, java.util.List<PromiseDecorator> decorators)` Creates a promise from the given map where the values of the map are either closures or Promise instances
`<T>`	`abstract Promise<java.util.List<T>>`	`createPromise(Promise<T>[] promises)` Creates a promise from one or more other promises
`<T>`	`abstract Promise<T>`	`createPromise(groovy.lang.Closure<T>[] closures)` Creates a promise from one or many closures
`<T>`	`abstract Promise<T>`	`createPromise(groovy.lang.Closure<T> closure, java.util.List<PromiseDecorator> decorators)` Creates a promise from one or many closures
`<T>`	`abstract Promise<java.util.List<T>>`	`createPromise(java.util.List<groovy.lang.Closure<T>> closures, java.util.List<PromiseDecorator> decorators)` Creates a promise from one or many closures
`<T>`	`abstract Promise<java.util.List<T>>`	`createPromise(java.util.List<groovy.lang.Closure<T>> closures)` Creates a promise from one or many closures
`<T>`	`abstract Promise<java.util.List<T>>`	`onComplete(java.util.List<Promise<T>> promises, groovy.lang.Closure<T> callable)` Executes the given callback when the list of promises completes
`<T>`	`abstract Promise<java.util.List<T>>`	`onError(java.util.List<Promise<T>> promises, groovy.lang.Closure<?> callable)` Executes the given callback if an error occurs for the list of promises
`<T>`	`abstract java.util.List<T>`	`waitAll(Promise<T>[] promises)` Synchronously waits for all promises to complete returning a list of values
`<T>`	`abstract java.util.List<T>`	`waitAll(java.util.List<Promise<T>> promises)` Synchronously waits for all promises to complete returning a list of values
`<T>`	`abstract java.util.List<T>`	`waitAll(java.util.List<Promise<T>> promises, long timeout, java.util.concurrent.TimeUnit units)` Synchronously waits for all promises to complete returning a list of values

- Method Detail
  - abstract void addPromiseDecoratorLookupStrategy(PromiseDecoratorLookupStrategy lookupStrategy)
    
    Adds a PromiseDecoratorLookupStrategy. The strategy implementation must be stateless, do not add a strategy that contains state
    Parameters:
    lookupStrategy - The lookup strategy
  - <T> abstract groovy.lang.Closure<T> applyDecorators(groovy.lang.Closure<T> c, java.util.List<PromiseDecorator> decorators)
    
    Applies the registered decorators to the given closure
    Parameters:
    c - The closure
    decorators - The decorators
    Returns:
    The decorated closure
  - <T> abstract Promise<T> createBoundPromise(T value)
    
    Creates a promise with a value pre-bound to it
    Parameters:
    value - The value
    Type Parameters:
    T - The type of the value
    Returns:
    A Promise
  - <T> abstract Promise<T> createPromise(java.lang.Class<T> returnType)
    
    Creates an unfulfilled promise that returns the given type
    Parameters:
    returnType - The return type
    Type Parameters:
    T - The type of the class
    Returns:
    The unfulfilled promise
  - abstract Promise<java.lang.Void> createPromise()
    
    Creates an unfulfilled promise that returns void
    Returns:
    The unfulfilled promise
  - <K, V> abstract Promise<java.util.Map<K, V>> createPromise(java.util.Map<K, V> map)
    
    Creates a promise from the given map where the values of the map are either closures or Promise instances
    Parameters:
    map - The map
    Returns:
    A promise
  - <K, V> abstract Promise<java.util.Map<K, V>> createPromise(java.util.Map<K, V> map, java.util.List<PromiseDecorator> decorators)
    
    Creates a promise from the given map where the values of the map are either closures or Promise instances
    Parameters:
    map - The map
    Returns:
    A promise
  - <T> abstract Promise<java.util.List<T>> createPromise(Promise<T>[] promises)
    
    Creates a promise from one or more other promises
    Parameters:
    promises - The promises
    Returns:
    The promise
  - <T> abstract Promise<T> createPromise(groovy.lang.Closure<T>[] closures)
    
    Creates a promise from one or many closures
    Parameters:
    closures - One or many closures
    Returns:
    A promise
  - <T> abstract Promise<T> createPromise(groovy.lang.Closure<T> closure, java.util.List<PromiseDecorator> decorators)
    
    Creates a promise from one or many closures
    Parameters:
    closure - A closure
    Returns:
    A promise
  - <T> abstract Promise<java.util.List<T>> createPromise(java.util.List<groovy.lang.Closure<T>> closures, java.util.List<PromiseDecorator> decorators)
    
    Creates a promise from one or many closures
    Parameters:
    closures - One or many closures
    Returns:
    A promise
  - <T> abstract Promise<java.util.List<T>> createPromise(java.util.List<groovy.lang.Closure<T>> closures)
    
    Creates a promise from one or many closures
    Parameters:
    closures - One or many closures
    Returns:
    A promise
  - <T> abstract Promise<java.util.List<T>> onComplete(java.util.List<Promise<T>> promises, groovy.lang.Closure<T> callable)
    
    Executes the given callback when the list of promises completes
    Parameters:
    promises - The promises
    callable - The callback to execute
  - <T> abstract Promise<java.util.List<T>> onError(java.util.List<Promise<T>> promises, groovy.lang.Closure<?> callable)
    
    Executes the given callback if an error occurs for the list of promises
    Parameters:
    promises - The promises The promises
    callable - The error callback to execute
  - <T> abstract java.util.List<T> waitAll(Promise<T>[] promises)
    
    Synchronously waits for all promises to complete returning a list of values
    Parameters:
    promises - The promises
    Returns:
    The list of bound values
  - <T> abstract java.util.List<T> waitAll(java.util.List<Promise<T>> promises)
    
    Synchronously waits for all promises to complete returning a list of values
    Parameters:
    promises - The promises
    Returns:
    The list of bound values
  - <T> abstract java.util.List<T> waitAll(java.util.List<Promise<T>> promises, long timeout, java.util.concurrent.TimeUnit units)
    
    Synchronously waits for all promises to complete returning a list of values
    Parameters:
    promises - The promises
    Returns:
    The list of bound values

Summary:
Method

| Detail:
Method

Groovy Documentation

[Groovy] Interface PromiseFactory

Methods Summary

Method Detail

abstract void addPromiseDecoratorLookupStrategy(PromiseDecoratorLookupStrategy lookupStrategy)

<T> abstract groovy.lang.Closure<T> applyDecorators(groovy.lang.Closure<T> c, java.util.List<PromiseDecorator> decorators)

<T> abstract Promise<T> createBoundPromise(T value)

<T> abstract Promise<T> createPromise(java.lang.Class<T> returnType)

abstract Promise<java.lang.Void> createPromise()

<K, V> abstract Promise<java.util.Map<K, V>> createPromise(java.util.Map<K, V> map)

<K, V> abstract Promise<java.util.Map<K, V>> createPromise(java.util.Map<K, V> map, java.util.List<PromiseDecorator> decorators)

<T> abstract Promise<java.util.List<T>> createPromise(Promise<T>[] promises)

<T> abstract Promise<T> createPromise(groovy.lang.Closure<T>[] closures)

<T> abstract Promise<T> createPromise(groovy.lang.Closure<T> closure, java.util.List<PromiseDecorator> decorators)

<T> abstract Promise<java.util.List<T>> createPromise(java.util.List<groovy.lang.Closure<T>> closures, java.util.List<PromiseDecorator> decorators)

<T> abstract Promise<java.util.List<T>> createPromise(java.util.List<groovy.lang.Closure<T>> closures)

<T> abstract Promise<java.util.List<T>> onComplete(java.util.List<Promise<T>> promises, groovy.lang.Closure<T> callable)

<T> abstract Promise<java.util.List<T>> onError(java.util.List<Promise<T>> promises, groovy.lang.Closure<?> callable)

<T> abstract java.util.List<T> waitAll(Promise<T>[] promises)

<T> abstract java.util.List<T> waitAll(java.util.List<Promise<T>> promises)

<T> abstract java.util.List<T> waitAll(java.util.List<Promise<T>> promises, long timeout, java.util.concurrent.TimeUnit units)