org.jrebirth.af.api.component.basic

Interface Component<R extends FacadeReady<R>>

Type Parameters:

R - A type that implements FacadeReady

All Superinterfaces:

CommandReady, FacadeReady<R>, ModelReady, ServiceReady

All Known Subinterfaces:

Behavior<D>, BehavioredComponent<C>, Command, CommandBean<WB>, Model, ModelObject<O>, MultiCommand<WB>, Service

public interface Component<R extends FacadeReady<R>>
extends FacadeReady<R>

The interface EnhancedComponent. Define the contract used to manage waves.

Author:

Sébastien Bordes

Method Summary

Modifier and Type	Method and Description
<C extends Component<?>> void	addInnerComponent(InnerComponent<C> innerComponent) Add an inner component.
<C extends Component<?>> C	getInnerComponent(InnerComponent<C> innerComponent) Get an inner component.
Component<?>	getRootComponent() Return the root component (for inner component).
void	listen(WaveChecker waveChecker, Method method, WaveType... waveType) Begin to listen the type of wave for the current component.
void	listen(WaveChecker waveChecker, WaveType... waveType) Begin to listen the type of wave for the current component.
void	listen(WaveType... waveType) Begin to listen the type of wave for the current component.
void	sendWave(Wave wave) Send a wave to the notifier.
Wave	sendWave(WaveType waveType, WaveData<?>... waveData) Send a wave to the notifier.
<WB extends WaveBean> Wave	sendWave(WaveType waveType, WB waveBean) Send a wave to the notifier.
void	setRootComponent(Component<?> rootComponent) Define the root component for an inner component.
void	unlisten(WaveType... waveTypes) Stop to listen the type of wave for the current component.

Methods inherited from interface org.jrebirth.af.api.facade.FacadeReady

getKey, getLocalFacade, release, setKey, setLocalFacade, setup

Methods inherited from interface org.jrebirth.af.api.link.ModelReady

attachUi, getModel, getModel

Methods inherited from interface org.jrebirth.af.api.link.ServiceReady

getService, getService, returnData

Methods inherited from interface org.jrebirth.af.api.link.CommandReady

callCommand, callCommand, getCommand, getCommand

Method Detail

listen

void listen(WaveType... waveType)

Begin to listen the type of wave for the current component. Wave Contract will be checked if org.jrebirth.af.core.resource.provided.JRebirthParameters.DEVELOPER_MODE parameter is true

Parameters:

waveType - the type(s) to listen

listen

void listen(WaveChecker waveChecker,
            WaveType... waveType)

Begin to listen the type of wave for the current component. Wave Contract will be checked if org.jrebirth.af.core.resource.provided.JRebirthParameters.DEVELOPER_MODE parameter is true The wave checker is used to filter the wave if the checker returns false

Parameters:

waveChecker - the wave checker used to forward the wave only if the checker return true

waveType - the type(s) to listen

listen

void listen(WaveChecker waveChecker,
            Method method,
            WaveType... waveType)

Begin to listen the type of wave for the current component. Wave Contract will be checked if org.jrebirth.af.core.resource.provided.JRebirthParameters.DEVELOPER_MODE parameter is true The wave checker is used to filter the wave if the checker returns false

Parameters:

waveChecker - the wave checker used to forward the wave only if the checker return true

method - the annotated method concerned

waveType - the type(s) to listen

unlisten

void unlisten(WaveType... waveTypes)

Stop to listen the type of wave for the current component.

Parameters:

waveTypes - the type(s) to stop to listen

sendWave

void sendWave(Wave wave)

Send a wave to the notifier. The wave will automatically be sent from JRebirthThread.

Parameters:

wave - the wave to send

sendWave

<WB extends WaveBean> Wave sendWave(WaveType waveType,
                                    WB waveBean)

Send a wave to the notifier. The wave will automatically be sent from JRebirthThread.

Parameters:

waveType - the type of wave to send

waveBean - the wave bean

Returns:

the wave created and sent to JIT, be careful when you use a strong reference it can hold a lot of objects

sendWave

Wave sendWave(WaveType waveType,
              WaveData<?>... waveData)

Send a wave to the notifier. The wave will automatically be sent from JRebirthThread.

Parameters:

waveType - the type of wave to send

waveData - the data (key-value

Returns:

the wave created and sent to JIT, be careful when you use a strong reference it can hold a lot of objects

getRootComponent

Component<?> getRootComponent()

Return the root component (for inner component).

Returns:

the root component of the inner component

setRootComponent

void setRootComponent(Component<?> rootComponent)

Define the root component for an inner component.

Parameters:

rootComponent - The root component to set.

addInnerComponent

<C extends Component<?>> void addInnerComponent(InnerComponent<C> innerComponent)

Add an inner component. It will instantiate the component from the right Facade and store it into the current component. Shall be called from AbstractComponent.initInnerComponent (protected API)

Parameters:

innerComponent - the entry that describes the inner component

keyPart - additional object that are part of the inner component's unique key

getInnerComponent

<C extends Component<?>> C getInnerComponent(InnerComponent<C> innerComponent)

Get an inner component. If the component isn't registered try to create it

Parameters:

innerComponent - the entry that describes the inner component

keyPart - additional object that are part of the inner component's unique key

Returns:

the inner component instance