com.haulmont.cuba.gui.components

Interface DataLoadCoordinator

All Superinterfaces:

Facet

public interface DataLoadCoordinator
extends Facet

Controls triggering of data loaders and provides support for automatic linking data loaders to data containers and visual components.

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	DataLoadCoordinator.LikeClause Type of the LIKE clause.
static interface	DataLoadCoordinator.Trigger Load trigger.

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	DEFAULT_COMPONENT_PREFIX
static java.lang.String	DEFAULT_CONTAINER_PREFIX

Method Summary

Modifier and Type	Method and Description
void	addOnComponentValueChangedLoadTrigger(DataLoader loader, Component component, java.lang.String param, DataLoadCoordinator.LikeClause likeClause) Adds trigger on visual component ValueChangeEvent.
void	addOnContainerItemChangedLoadTrigger(DataLoader loader, InstanceContainer container, java.lang.String param) Adds trigger on data container ItemChangeEvent.
void	addOnFrameOwnerEventLoadTrigger(DataLoader loader, java.lang.Class eventClass) Adds trigger on screen/fragment event.
void	configureAutomatically() Configures triggers automatically relying upon parameter prefixes.
java.util.List<DataLoadCoordinator.Trigger>	getTriggers() Returns configured triggers.
void	setComponentPrefix(java.lang.String value) Sets parameter prefix to denote a visual component.
void	setContainerPrefix(java.lang.String value) Sets parameter prefix to denote a data container.

Methods inherited from interface com.haulmont.cuba.gui.components.Facet

getId, getOwner, setId, setOwner

Field Detail

DEFAULT_CONTAINER_PREFIX

static final java.lang.String DEFAULT_CONTAINER_PREFIX

See Also:

Constant Field Values

DEFAULT_COMPONENT_PREFIX

static final java.lang.String DEFAULT_COMPONENT_PREFIX

See Also:

Constant Field Values

Method Detail

setContainerPrefix

void setContainerPrefix(java.lang.String value)

Sets parameter prefix to denote a data container.

setComponentPrefix

void setComponentPrefix(java.lang.String value)

Sets parameter prefix to denote a visual component.

addOnFrameOwnerEventLoadTrigger

void addOnFrameOwnerEventLoadTrigger(DataLoader loader,
                                     java.lang.Class eventClass)

Adds trigger on screen/fragment event.

Parameters:

loader - loader

eventClass - event class

addOnContainerItemChangedLoadTrigger

void addOnContainerItemChangedLoadTrigger(DataLoader loader,
                                          InstanceContainer container,
                                          @Nullable
                                          java.lang.String param)

Adds trigger on data container ItemChangeEvent.

Parameters:

loader - loader

container - master data container

param - loader parameter

addOnComponentValueChangedLoadTrigger

void addOnComponentValueChangedLoadTrigger(DataLoader loader,
                                           Component component,
                                           @Nullable
                                           java.lang.String param,
                                           DataLoadCoordinator.LikeClause likeClause)

Adds trigger on visual component ValueChangeEvent.

Parameters:

loader - loader

component - component which must implement HasValue

param - loader parameter

likeClause - whether the condition using the parameter is a LIKE clause

configureAutomatically

void configureAutomatically()

Configures triggers automatically relying upon parameter prefixes. All data containers that don't have a prefixed parameter in the query string, are configured to be triggered on BeforeShowEvent or AttachEvent.

getTriggers

java.util.List<DataLoadCoordinator.Trigger> getTriggers()

Returns configured triggers.