This section provides information on creating your own application containers.
You must first start by creating a Java class which extends the abstract core container class AppContainer
. This base class is in the com.ibm.rcp.container.core
plug-in. Much of the work is handled at the core layer for most generic container implementations. However, the core layer allows you to override several key areas of functionality to achieve the desired behavior in your container.
The Composite Application Editor provides a Landmark Editor that simplifies the creation of a container configuration. To facilitate the population of landmarks, events, actions and fields in the drop-downs of this editor, application containers should override the following methods defined in the core container:
public Map getAvailableLandmarkIdentifiers()
The container should return a Map of recognized landmark identifiers and their corresponding descriptions. The default implementation returns an empty Map.public Map getAvailableEvents()
The container should return a Map of supported events and their corresponding descriptions. The default implementation returns a Map containing the Content Complete and Data Change events. public List getSuggestedLandmarks(String landmarkIdentifier)
The container should return a list of landmark expressions that represent its current contents using the passed landmark identifier. The default implementation returns an empty List.public List getSuggestedFields(String landmarkIdentifier, String landmark)
The container should return a list of possible fields for the passed landmark expression and landmark identifier. The container must build the landmark for its current contents using the passed landmark identifier, compare it to the passed landmark expression, and if they match, return a list of fields based on the current contents.public Map getSuggestedActions()
The container should return a Map
of supported actions and their corresponding descriptions. The default implementation returns a Map
containing the Receive and Publish actions.
Implementing event handlers: XPD621
Each generic application container allows events to be declared for each of the landmarks along with actions (receive and publish) to go along with that event.
Parent topic: Generic application container framework: XPD621