org.jacpfx.api.component

Interface Perspective<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:

Comparable<Component<L,M>>, Component<L,M>, RootComponent<SubComponent<L,A,M>,Message<A,M>>

All Known Subinterfaces:

PerspectiveView<C,L,A,M>

public interface Perspective<L,A,M>
extends Component<L,M>, RootComponent<SubComponent<L,A,M>,Message<A,M>>

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

Author:

Andy Moncsek

Method Summary

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

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

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

Methods inherited from interface java.lang.Comparable

compareTo

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

addComponent, getComponentHandler, initComponents, registerComponent, removeAllCompnents, unregisterComponent

Method Detail

init

void init(BlockingQueue<SubComponent<L,A,M>> componentDelegateQueue,
          BlockingQueue<DelegateDTO<A,M>> messageDelegateQueue,
          Coordinator<L,A,M> messageCoordinator,
          Launcher<?> launcher)

The initialization method.

Parameters:

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

messageDelegateQueue, - messages to component

messageCoordinator, - coordinates messages to component

launcher, - the component launcher

postInit

void postInit(ComponentHandler<SubComponent<L,A,M>,Message<A,M>> componentHandler)

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

Parameters:

componentHandler, - the component handler

getSubcomponents

List<SubComponent<L,A,M>> getSubcomponents()

Returns all subcomponents in perspective.

Returns:

a list of all handled component 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

BlockingQueue<SubComponent<L,A,M>> getComponentDelegateQueue()

Returns delegate queue to delegate component to correct target

Returns:

the delegate queue

getMessageDelegateQueue

BlockingQueue<DelegateDTO<A,M>> getMessageDelegateQueue()

Returns delegate queue to delegate actions to correct target

Returns:

the delegate queue

getMessageQueue

BlockingQueue<Message<A,M>> getMessageQueue()

returns the component 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.