org.quickstart.api.component

Interface IPerspective<L,A,M>

Type Parameters:

L - defines the message listener type

A - defines the basic event type

M - defines the basic message type

All Superinterfaces:

java.lang.Comparable<IComponent<L,M>>, IComponent<L,M>, IRootComponent<ISubComponent<L,A,M>,Message<A,M>>

All Known Subinterfaces:

IPerspectiveView<C,L,A,M>

public interface IPerspective<L,A,M>
extends IComponent<L,M>, IRootComponent<ISubComponent<L,A,M>,Message<A,M>>

Defines a perspective, a perspective is a root component handled by an workbench and contains sub-components such as visible UI components or background components. A workbench can handle one or more perspectives (1-n) and every perspective can handle one ore more components (1-n).

Author:

Andy Moncsek

Method Summary

Modifier and Type	Method and Description
java.util.concurrent.BlockingQueue<ISubComponent<L,A,M>>	getComponentDelegateQueue() Returns delegate queue to delegate components to correct target
java.util.concurrent.BlockingQueue<IDelegateDTO<A,M>>	getMessageDelegateQueue() Returns delegate queue to delegate actions to correct target
java.util.concurrent.BlockingQueue<Message<A,M>>	getMessageQueue() returns the components coordinator message queue;
Injectable	getPerspective() Returns the injected perspective representation.
java.util.List<ISubComponent<L,A,M>>	getSubcomponents() Returns all subcomponents in perspective.
void	handlePerspective(Message<A,M> message) Handle a message call on perspective instance.
void	init(java.util.concurrent.BlockingQueue<ISubComponent<L,A,M>> componentDelegateQueue, java.util.concurrent.BlockingQueue<IDelegateDTO<A,M>> messageDelegateQueue, ICoordinator<L,A,M> messageCoordinator, Launcher<?> launcher) The initialization method.
void	postInit(IComponentHandler<ISubComponent<L,A,M>,Message<A,M>> componentHandler) post init method to set correct component handler and to initialize components depending on objects created in startUp sequence.

Methods inherited from interface org.jacpfx.api.component.IComponent

getContext, getLocaleID, getResourceBundleLocation, isStarted, setLocaleID, setResourceBundleLocation, setStarted

Methods inherited from interface java.lang.Comparable

compareTo

Methods inherited from interface org.jacpfx.api.component.IRootComponent

addComponent, getComponentHandler, initComponents, registerComponent, removeAllCompnents, unregisterComponent

Method Detail

init

void init(java.util.concurrent.BlockingQueue<ISubComponent<L,A,M>> componentDelegateQueue,
          java.util.concurrent.BlockingQueue<IDelegateDTO<A,M>> messageDelegateQueue,
          ICoordinator<L,A,M> messageCoordinator,
          Launcher<?> launcher)

The initialization method.

Parameters:

componentDelegateQueue, - components that should be delegated to an other perspective

messageDelegateQueue, - messages to components

messageCoordinator, - coordinates messages to components

launcher, - the component launcher

postInit

void postInit(IComponentHandler<ISubComponent<L,A,M>,Message<A,M>> componentHandler)

post init method to set correct component handler and to initialize components depending on objects created in startUp sequence.

Parameters:

componentHandler, - the component handler

getSubcomponents

java.util.List<ISubComponent<L,A,M>> getSubcomponents()

Returns all subcomponents in perspective.

Returns:

a list of all handled components in current perspective.

handlePerspective

void handlePerspective(Message<A,M> message)

Handle a message call on perspective instance. This method should be override to handle the layout of an perspective.

Parameters:

message, - the message to perspective.

getComponentDelegateQueue

java.util.concurrent.BlockingQueue<ISubComponent<L,A,M>> getComponentDelegateQueue()

Returns delegate queue to delegate components to correct target

Returns:

the delegate queue

getMessageDelegateQueue

java.util.concurrent.BlockingQueue<IDelegateDTO<A,M>> getMessageDelegateQueue()

Returns delegate queue to delegate actions to correct target

Returns:

the delegate queue

getMessageQueue

java.util.concurrent.BlockingQueue<Message<A,M>> getMessageQueue()

returns the components coordinator message queue;

Returns:

message queue

getPerspective

Injectable getPerspective()

Returns the injected perspective representation. This Injectable is the implementation of a perspective which includes all handle methods.

Returns:

the perspective implementation.