LookupBuilder (CUBA 7.1 API)

java.lang.Object
- com.haulmont.cuba.gui.builders.LookupBuilder<E>

Direct Known Subclasses:

LookupClassBuilder
```
public class LookupBuilder<E extends Entity>
extends java.lang.Object
```
Lookup screen builder that is not aware of concrete screen class. It's build() method returns Screen.

Field Summary

Fields
Modifier and Type	Field and Description
`protected CollectionContainer<E>`	`container`
`protected java.lang.Class<E>`	`entityClass`
`protected HasValue<E>`	`field`
`protected java.util.function.Function<LookupBuilder<E>,Screen>`	`handler`
`protected Screens.LaunchMode`	`launchMode`
`protected ListComponent<E>`	`listComponent`
`protected ScreenOptions`	`options`
`protected FrameOwner`	`origin`
`protected java.lang.String`	`screenId`
`protected java.util.function.Consumer<java.util.Collection<E>>`	`selectHandler`
`protected java.util.function.Predicate<LookupScreen.ValidationContext<E>>`	`selectValidator`
`protected java.util.function.Function<java.util.Collection<E>,java.util.Collection<E>>`	`transformation`

Constructor Summary

Constructors
Constructor and Description
`LookupBuilder(FrameOwner origin, java.lang.Class<E> entityClass, java.util.function.Function<LookupBuilder<E>,Screen> handler)`
`LookupBuilder(LookupBuilder<E> builder)`

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`Screen`	`build()` Builds the lookup screen.
`CollectionContainer<E>`	`getContainer()` Returns container set by `withContainer(CollectionContainer)`.
`java.lang.Class<E>`	`getEntityClass()` Returns class of the entity to lookup.
`HasValue<E>`	`getField()` Returns the field component set by `withField(HasValue)`.
`Screens.LaunchMode`	`getLaunchMode()` Returns launch mode set by `withLaunchMode(Screens.LaunchMode)`.
`ListComponent<E>`	`getListComponent()` Returns list component set by `withListComponent(ListComponent)`.
`ScreenOptions`	`getOptions()` Returns screen options set by `withOptions(ScreenOptions)`.
`FrameOwner`	`getOrigin()` Returns invoking screen.
`java.lang.String`	`getScreenId()` Returns screen id set by `withScreenId(String)`.
`java.util.function.Consumer<java.util.Collection<E>>`	`getSelectHandler()` Returns selection handler set by `withSelectHandler(Consumer)`.
`java.util.function.Predicate<LookupScreen.ValidationContext<E>>`	`getSelectValidator()` Returns selection validator set by `withSelectValidator(Predicate)`.
`java.util.function.Function<java.util.Collection<E>,java.util.Collection<E>>`	`getTransformation()`
`Screen`	`show()` Builds and shows the lookup screen.
`LookupBuilder<E>`	`withContainer(CollectionContainer<E> container)` Sets `CollectionContainer` and returns the builder for chaining.
`<T extends HasValue<E>> LookupBuilder<E>`	`withField(T field)` Sets the field component and returns the builder for chaining.
`LookupBuilder<E>`	`withLaunchMode(Screens.LaunchMode launchMode)` Sets `Screens.LaunchMode` for the lookup screen and returns the builder for chaining.
`LookupBuilder<E>`	`withListComponent(ListComponent<E> target)` Sets list component and returns the builder for chaining.
`LookupBuilder<E>`	`withOpenMode(OpenMode openMode)` Sets `OpenMode` for the lookup screen and returns the builder for chaining.
`LookupBuilder<E>`	`withOptions(ScreenOptions options)` Sets `ScreenOptions` for the lookup screen and returns the builder for chaining.
`<S extends Screen & LookupScreen<E>> LookupClassBuilder<E,S>`	`withScreenClass(java.lang.Class<S> screenClass)` Sets screen class and returns the `LookupClassBuilder` for chaining.
`LookupBuilder<E>`	`withScreenId(java.lang.String screenId)` Sets screen id and returns the builder for chaining.
`LookupBuilder<E>`	`withSelectHandler(java.util.function.Consumer<java.util.Collection<E>> selectHandler)` Sets selection handler for the lookup screen and returns the builder for chaining.
`LookupBuilder<E>`	`withSelectValidator(java.util.function.Predicate<LookupScreen.ValidationContext<E>> selectValidator)` Sets selection validator for the lookup screen and returns the builder for chaining.
`LookupBuilder<E>`	`withTransformation(java.util.function.Function<java.util.Collection<E>,java.util.Collection<E>> transformation)` Sets code to transform the edited entity after editor commit and returns the builder for chaining.

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

- Field Detail
  - origin
```
protected final FrameOwner origin
```
  - entityClass
```
protected final java.lang.Class<E extends Entity> entityClass
```
  - handler
```
protected final java.util.function.Function<LookupBuilder<E extends Entity>,Screen> handler
```
  - selectValidator
```
protected java.util.function.Predicate<LookupScreen.ValidationContext<E extends Entity>> selectValidator
```
  - transformation
```
protected java.util.function.Function<java.util.Collection<E extends Entity>,java.util.Collection<E extends Entity>> transformation
```
  - selectHandler
```
protected java.util.function.Consumer<java.util.Collection<E extends Entity>> selectHandler
```
  - launchMode
```
protected Screens.LaunchMode launchMode
```
  - options
```
protected ScreenOptions options
```
  - container
```
protected CollectionContainer<E extends Entity> container
```
  - screenId
```
protected java.lang.String screenId
```
  - listComponent
```
protected ListComponent<E extends Entity> listComponent
```
  - field
```
protected HasValue<E extends Entity> field
```
- Constructor Detail
  - LookupBuilder
```
public LookupBuilder(LookupBuilder<E> builder)
```
  - LookupBuilder
```
public LookupBuilder(FrameOwner origin,
                     java.lang.Class<E> entityClass,
                     java.util.function.Function<LookupBuilder<E>,Screen> handler)
```
- Method Detail
  - withLaunchMode
```
public LookupBuilder<E> withLaunchMode(Screens.LaunchMode launchMode)
```
    Sets Screens.LaunchMode for the lookup screen and returns the builder for chaining.
    For example: builder.withLaunchMode(OpenMode.DIALOG).build();
  - withOpenMode
```
public LookupBuilder<E> withOpenMode(OpenMode openMode)
```
    Sets OpenMode for the lookup screen and returns the builder for chaining.
    For example: builder.withOpenMode(OpenMode.DIALOG).build();
  - withOptions
```
public LookupBuilder<E> withOptions(ScreenOptions options)
```
    Sets ScreenOptions for the lookup screen and returns the builder for chaining.
  - withSelectValidator
```
public LookupBuilder<E> withSelectValidator(java.util.function.Predicate<LookupScreen.ValidationContext<E>> selectValidator)
```
    Sets selection validator for the lookup screen and returns the builder for chaining.
  - withSelectHandler
```
public LookupBuilder<E> withSelectHandler(java.util.function.Consumer<java.util.Collection<E>> selectHandler)
```
    Sets selection handler for the lookup screen and returns the builder for chaining.
  - withField
```
public <T extends HasValue<E>> LookupBuilder<E> withField(T field)
```
    Sets the field component and returns the builder for chaining.
    If the field is set, the framework sets the selected entity to the field after successful lookup.
  - withScreenClass
```
public <S extends Screen & LookupScreen<E>> LookupClassBuilder<E,S> withScreenClass(java.lang.Class<S> screenClass)
```
    Sets screen class and returns the LookupClassBuilder for chaining.
    
    Parameters:
    
    screenClass - class of the screen controller
  - withScreenId
```
public LookupBuilder<E> withScreenId(java.lang.String screenId)
```
    Sets screen id and returns the builder for chaining.
    
    Parameters:
    
    screenId - identifier of the lookup screen as specified in the UiController annotation or screens.xml.
  - withListComponent
```
public LookupBuilder<E> withListComponent(ListComponent<E> target)
```
    Sets list component and returns the builder for chaining.
    The component is used to get the container if it is not set explicitly by withContainer(CollectionContainer) method. Usually, the list component is a Table or DataGrid displaying the list of entities.
  - withContainer
```
public LookupBuilder<E> withContainer(CollectionContainer<E> container)
```
    Sets CollectionContainer and returns the builder for chaining.
    The container is updated after the lookup screen is closed. If the container is Nested, the framework automatically initializes the reference to the parent entity and sets up data contexts for added One-To-Many and Many-To-Many relations.
  - withTransformation
```
public LookupBuilder<E> withTransformation(java.util.function.Function<java.util.Collection<E>,java.util.Collection<E>> transformation)
```
    Sets code to transform the edited entity after editor commit and returns the builder for chaining.
    Applied only if either field or container or listComponent is assigned.
    
    Parameters:
    
    transformation - edited entity transformation
    
    See Also:
    
    withContainer(CollectionContainer), withField(HasValue), withListComponent(ListComponent)
  - getScreenId
```
public java.lang.String getScreenId()
```
    Returns screen id set by withScreenId(String).
  - getLaunchMode
```
public Screens.LaunchMode getLaunchMode()
```
    Returns launch mode set by withLaunchMode(Screens.LaunchMode).
  - getOptions
```
public ScreenOptions getOptions()
```
    Returns screen options set by withOptions(ScreenOptions).
  - getOrigin
```
@Nonnull
public FrameOwner getOrigin()
```
    Returns invoking screen.
  - getEntityClass
```
public java.lang.Class<E> getEntityClass()
```
    Returns class of the entity to lookup.
  - getSelectHandler
```
public java.util.function.Consumer<java.util.Collection<E>> getSelectHandler()
```
    Returns selection handler set by withSelectHandler(Consumer).
  - getSelectValidator
```
public java.util.function.Predicate<LookupScreen.ValidationContext<E>> getSelectValidator()
```
    Returns selection validator set by withSelectValidator(Predicate).
  - getField
```
public HasValue<E> getField()
```
    Returns the field component set by withField(HasValue).
  - getContainer
```
public CollectionContainer<E> getContainer()
```
    Returns container set by withContainer(CollectionContainer).
  - getListComponent
```
public ListComponent<E> getListComponent()
```
    Returns list component set by withListComponent(ListComponent).
  - getTransformation
```
public java.util.function.Function<java.util.Collection<E>,java.util.Collection<E>> getTransformation()
```
  - build
```
public Screen build()
```
    Builds the lookup screen. Screen should be shown using Screen.show().
  - show
```
public Screen show()
```
    Builds and shows the lookup screen.

Class LookupBuilder<E extends Entity>

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

origin

entityClass

handler

selectValidator

transformation

selectHandler

launchMode

options

container

screenId

listComponent

field

Constructor Detail

LookupBuilder

LookupBuilder

Method Detail

withLaunchMode

withOpenMode

withOptions

withSelectValidator

withSelectHandler

withField

withScreenClass

withScreenId

withListComponent

withContainer

withTransformation

getScreenId

getLaunchMode

getOptions

getOrigin

getEntityClass

getSelectHandler

getSelectValidator

getField

getContainer

getListComponent

getTransformation

build

show