This section provides information about creating your own application containers.
You must start by creating a Java class that 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. The core layer, however, allows you to override several key areas of functionality to achieve the wanted 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-down menus of this editor, application containers override the following methods defined in the core container:
public Map getAvailableLandmarkIdentifiers()
The container returns a Map of recognized landmark identifiers and their corresponding descriptions. The default implementation returns an empty Map.public Map getAvailableEvents()
The container returns 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 returns 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 returns 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 returns a Map
of supported actions and their corresponding descriptions. The default implementation returns a Map
containing the Receive and Publish actions.
Implementing event handlers: XPD622
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: XPD622