View (docs 0.5.0-930919a0 API)

Type Parameters:

T - type of the elements in this view

All Known Subinterfaces:

BinaryView<T>, TaskView<T>, VariantView<T>
```
public interface View<T>
```
A view of a collection that are created and configured as they are required.

Since:

0.4

Method Summary

All Methods Instance Methods Abstract Methods Default Methods
Modifier and Type	Method and Description
`void`	`configureEach(Action<? super T> action)` Registers an action to execute to configure each element in the view.
`<S extends T> void`	`configureEach(Class<S> type, Action<? super S> action)` Registers an action to execute to configure each element in the view.
`default <S extends T> void`	`configureEach(Class<S> type, groovy.lang.Closure<Void> closure)` Registers a closure to execute to configure each element in the view.
`default void`	`configureEach(groovy.lang.Closure<Void> closure)` Registers a closure to execute to configure each element in the view.
`void`	`configureEach(Spec<? super T> spec, Action<? super T> action)` Registers an action to execute to configure each element in the view matching the given specification.
`default void`	`configureEach(Spec<? super T> spec, groovy.lang.Closure<Void> closure)` Registers a closure to execute to configure each element in the view matching the given specification.
`Provider<List<T>>`	`filter(Spec<? super T> spec)` Returns a single list containing all elements matching the given specification.
`<S> Provider<List<S>>`	`flatMap(Transformer<? extends Iterable<S>,? super T> mapper)` Returns a single list containing all elements yielded from results of mapper function being invoked on each element of this view.
`Set<T>`	`get()` Returns the contents of this view as a `Set` of `<T>` instances.
`Provider<Set<T>>`	`getElements()` Returns the contents of this view as a `Provider` of `<T>` instances.
`<S> Provider<List<S>>`	`map(Transformer<? extends S,? super T> mapper)` Returns a list containing the results of applying the given mapper function to each element in the view.
`<S extends T> View<S>`	`withType(Class<S> type)` Returns a view containing the objects in this view of the given type.

- Method Detail
  - configureEach
```
void configureEach(Action<? super T> action)
```
    Registers an action to execute to configure each element in the view. The action is only executed for those elements that are required. Fails if any element has already been finalized.
    
    Parameters:
    
    action - The action to execute on each element for configuration.
  - configureEach
```
default void configureEach(@DelegatesTo(type="T",strategy=1)
                           groovy.lang.Closure<Void> closure)
```
    Registers a closure to execute to configure each element in the view. The action is only executed for those elements that are required. Fails if any element has already been finalized.
    
    Parameters:
    
    closure - The closure to execute on each element for configuration.
  - configureEach
```
<S extends T> void configureEach(Class<S> type,
                                 Action<? super S> action)
```
    Registers an action to execute to configure each element in the view. The action is only executed for those elements that are required. Fails if any matching element has already been finalized. This method is equivalent to view.withType(Foo).configureEach { ... }.
    
    Type Parameters:
    
    S - the base type of the element to configure.
    
    Parameters:
    
    type - the type of binary to select.
    
    action - the action to execute on each element for configuration.
  - configureEach
```
default <S extends T> void configureEach(Class<S> type,
                                         @DelegatesTo(type="S",strategy=1)
                                         groovy.lang.Closure<Void> closure)
```
    Registers a closure to execute to configure each element in the view. The action is only executed for those elements that are required. Fails if any matching element has already been finalized. This method is equivalent to view.withType(Foo).configureEach { ... }.
    
    Type Parameters:
    
    S - the base type of the element to configure.
    
    Parameters:
    
    type - the type of binary to select.
    
    closure - the closure to execute on each element for configuration.
  - configureEach
```
void configureEach(Spec<? super T> spec,
                   Action<? super T> action)
```
    Registers an action to execute to configure each element in the view matching the given specification. The action is only executed for those elements that are required. Fails if any element has already been finalized.
    
    Parameters:
    
    spec - a specification to satisfy. The spec is applied to each binary prior to configuration.
    
    action - the action to execute on each element for configuration.
    
    Since:
    
    0.4
  - configureEach
```
default void configureEach(Spec<? super T> spec,
                           @DelegatesTo(type="S",strategy=1)
                           groovy.lang.Closure<Void> closure)
```
    Registers a closure to execute to configure each element in the view matching the given specification. The action is only executed for those elements that are required. Fails if any element has already been finalized.
    
    Parameters:
    
    spec - a specification to satisfy. The spec is applied to each binary prior to configuration.
    
    closure - the closure to execute on each element for configuration.
    
    Since:
    
    0.4
  - withType
```
<S extends T> View<S> withType(Class<S> type)
```
    Returns a view containing the objects in this view of the given type. The returned view is live, so that when matching objects are later added to this view, they are also visible in the filtered view.
    
    Type Parameters:
    
    S - the base type of the element of the new view.
    
    Parameters:
    
    type - the type of element to find.
    
    Returns:
    
    the matching element as a View, never null.
  - getElements
```
Provider<Set<T>> getElements()
```
    Returns the contents of this view as a Provider of <T> instances.
    The returned Provider is live, and tracks changes of the view.
    
    Returns:
    
    a provider containing all the elements included in this view.
  - get
```
Set<T> get()
```
    Returns the contents of this view as a Set of <T> instances.
    
    Returns:
    
    a set containing all the elements included in this view.
  - map
```
<S> Provider<List<S>> map(Transformer<? extends S,? super T> mapper)
```
    Returns a list containing the results of applying the given mapper function to each element in the view.
    The returned Provider is live, and tracks changes of the view.
    
    Type Parameters:
    
    S - the type of the mapped elements
    
    Parameters:
    
    mapper - a transform function to apply on each element of this view
    
    Returns:
    
    a provider containing the transformed elements included in this view.
  - flatMap
```
<S> Provider<List<S>> flatMap(Transformer<? extends Iterable<S>,? super T> mapper)
```
    Returns a single list containing all elements yielded from results of mapper function being invoked on each element of this view.
    The returned Provider is live, and tracks changes of the view.
    
    Type Parameters:
    
    S - the type of the mapped elements
    
    Parameters:
    
    mapper - a transform function to apply on each element of this view
    
    Returns:
    
    a provider containing the mapped elements of this view.
  - filter
```
Provider<List<T>> filter(Spec<? super T> spec)
```
    Returns a single list containing all elements matching the given specification.
    The returned Provider is live, and tracks changes of the view.
    
    Parameters:
    
    spec - a specification to satisfy
    
    Returns:
    
    a provider containing the filtered elements of this view.

Interface View<T>

Method Summary

Method Detail

configureEach

configureEach

configureEach

configureEach

configureEach

configureEach

withType

getElements

get

map

flatMap

filter