net.sf.mmm.client.ui.base.dialog.page

Class AbstractPageDialogController<VIEW extends UiWidgetRegular & AttributeReadSlot>

java.lang.Object

net.sf.mmm.util.component.base.AbstractComponent

net.sf.mmm.util.component.base.AbstractLoggableComponent

net.sf.mmm.client.ui.base.dialog.AbstractDialogController<VIEW>

net.sf.mmm.client.ui.base.dialog.DialogController<VIEW>

net.sf.mmm.client.ui.base.dialog.page.AbstractPageDialogController<VIEW>

Type Parameters:

VIEW - is the generic type of the view.

All Implemented Interfaces:

AttributeReadVisible, AbstractDialog, Dialog, AttributeReadId<String>, AttributeReadTitle<String>

public abstract class AbstractPageDialogController<VIEW extends UiWidgetRegular & AttributeReadSlot>
extends DialogController<VIEW>

This is the abstract base implementation for the DialogController of the page.

Since:

1.0.0

Author:

Joerg Hohwiller (hohwille at users.sourceforge.net)

Field Summary

Fields inherited from interface net.sf.mmm.client.ui.api.dialog.AbstractDialog

PATTERN_DIALOG_ID

Constructor Summary

Constructors

Constructor and Description
AbstractPageDialogController() The constructor.

Method Summary

Modifier and Type	Method and Description
protected DialogSlot	doShow(DialogPlace dialogPlace) This method gets called whenever this DialogController is to be shown.
protected void	embed(DialogController<?> subDialog, DialogSlot slot) This method has to be overridden with the custom logic to embed a given DialogController as sub-dialog in a predefined slot.
String	getId() This method gets the ID used to identify this object.
String	getType() This method determines the type of this Dialog.

Methods inherited from class net.sf.mmm.client.ui.base.dialog.DialogController

getDialogManager, getUiContext, onRemoveChild, setUiContext, show

Methods inherited from class net.sf.mmm.client.ui.base.dialog.AbstractDialogController

createView, getView, isVisible, onHide, onReset, onShow, reset

Methods inherited from class net.sf.mmm.util.component.base.AbstractLoggableComponent

createLogger, doInitialize, getLogger

Methods inherited from class net.sf.mmm.util.component.base.AbstractComponent

doInitialized, getInitializationState, initialize

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface net.sf.mmm.client.ui.api.dialog.AbstractDialog

getTitle, isVisible

Constructor Detail

AbstractPageDialogController

public AbstractPageDialogController()

The constructor.

Method Detail

getType

public String getType()

This method determines the type of this Dialog. There are predefined TYPE_* constants for common types in DialogConstants. However, you can simply create additional custom types for your needs.

Returns:

the type of this Dialog.

See Also:

DialogConstants.TYPE_MAIN, DialogConstants.TYPE_HEADER, DialogConstants.TYPE_FOOTER, DialogConstants.TYPE_NAVIGATION, DialogConstants.TYPE_SIDE, DialogConstants.TYPE_ROOT

getId

public String getId()

This method gets the ID used to identify this object. An ID should be unique. The ID of a dialog should only contain ASCII letters, Latin digits, hyphens or underscores. It must NOT contain ':', ';', '&', '?', '=', '/', '\\' or ' '.

Returns:

the object's ID.

See Also:

DialogConstants.DIALOG_ID_ROOT, DialogConstants.DIALOG_ID_PAGE, DialogConstants.DIALOG_ID_HOME

doShow

protected DialogSlot doShow(DialogPlace dialogPlace)

This method gets called whenever this DialogController is to be shown. There are two cases to distinguish:

• direct
  This DialogController is identified by the given DialogPlace. It is the leaf of the DialogController-hierarchy that is to be displayed.
• indirect
  Because of a direct request to show a dialog, its parent (and ancestors) will be shown that will embed their child dialog in the DialogSlot returned by this method.

If this is the root DialogController this method will never be called.

Specified by:

doShow in class DialogController<VIEW extends UiWidgetRegular & AttributeReadSlot>

Parameters:

dialogPlace - is the DialogPlace pointing to the direct dialog to open and containing potential parameters.

Returns:

the DialogSlot identifying the parent DialogController and its slot where to embed this DialogController.

embed

protected void embed(DialogController<?> subDialog,
                     DialogSlot slot)

This method has to be overridden with the custom logic to embed a given DialogController as sub-dialog in a predefined slot. If this DialogController represents a leaf-dialog than can not have sub-dialogs this method will be never called.
Here is a typical example:

 protected void embed(DialogController subDialog, DialogSlot slot) {
   if (slot == SLOT_MAIN) {
     AbstractDialogController.getView().getMainSlot().setChild((UiWidgetRegular) subDialog.AbstractDialogController.getView());
   } else if (slot == SLOT_NAVIGATION) {
     ...
   } else {
     super.embed(subDialog, slot);
   }
 }
 

The cast to UiWidgetRegular is legal here if you are not doing odd things. See AbstractDialogController.getView() for details.

Overrides:

embed in class DialogController<VIEW extends UiWidgetRegular & AttributeReadSlot>

Parameters:

subDialog - is the DialogController of the sub-dialog to embed.

slot - is the DialogSlot identifying the location in the view where the subDialog shall be embedded.