org.opencms.workplace
Class CmsDialog

java.lang.Object
  org.opencms.workplace.CmsWorkplace
      org.opencms.workplace.tools.CmsToolDialog
          org.opencms.workplace.CmsDialog

Direct Known Subclasses:

A_CmsGallery, A_CmsListDialog, CmsChacc, CmsChaccBrowser, CmsChnav, CmsChtype, CmsCopy, CmsCopyToProject, CmsDelete, CmsDialogElements, CmsDisplayResource, CmsEditor, CmsEditPointer, CmsHelpTemplateBean, CmsHistory, CmsLock, CmsMove, CmsNewResource, CmsOpenGallery, CmsReplace, CmsReport, CmsSecure, CmsTabDialog, CmsTouch, CmsUndelete, CmsUndoChanges, CmsWidgetDialog

public class CmsDialog
extends CmsToolDialog

Provides methods for building the dialog windows of OpenCms.

Since:

6.0.0

Version:

$Revision: 1.95 $

Author:

Andreas Zahner

Field Summary

static int	ACTION_CANCEL Value for the action: cancel.
static int	ACTION_CLOSEPOPUP Value for the action: close popup window.
static int	ACTION_CLOSEPOPUP_SAVE Value for the action: save & close popup window.
static int	ACTION_CONFIRMED Value for the action: confirmed.
static int	ACTION_DEFAULT Value for the action: default (show initial dialog form).
static int	ACTION_OK Value for the action: ok.
static int	ACTION_REPORT_BEGIN Value for the action: begin the report.
static int	ACTION_REPORT_END Value for the action: end the report.
static int	ACTION_REPORT_UPDATE Value for the action: update the report.
static int	ACTION_SET Value for the action: button "set" clicked.
static int	ACTION_WAIT Value for the action: wait (show please wait screen).
protected static String	ATTRIBUTE_THROWABLE Key name for the throwable attribute.
static int	BUTTON_ADVANCED Constant for the "Advanced" button in the build button methods.
static int	BUTTON_BACK Constant for the "Back" button in the build button methods.
static int	BUTTON_CANCEL Constant for the "Cancel" button in the build button methods.
static int	BUTTON_CLOSE Constant for the "Close" button in the build button methods.
static int	BUTTON_CONTINUE Constant for the "Continue" button in the build button methods.
static int	BUTTON_DETAILS Constant for the "Details" button in the build button methods.
static int	BUTTON_DISCARD Constant for the "Discard" button in the build button methods (same function as "Cancel" button but different text on button.
static int	BUTTON_EDIT Constant for the "Edit" button in the build button methods (same function as "Ok" button but different text on button.
static int	BUTTON_OK Constant for the "OK" button in the build button methods.
static int	BUTTON_OK_NO_SUBMIT Constant for the "OK" button in the build button methods (without form submission).
static int	BUTTON_SET Constant for the "Set" button in the build button methods.
static String	DIALOG_BACK Request parameter value for the action: back.
static String	DIALOG_CANCEL Request parameter value for the action: cancel.
static String	DIALOG_CONFIRMED Request parameter value for the action: dialog confirmed.
static String	DIALOG_CONTINUE Request parameter value for the action: continue.
static String	DIALOG_INITIAL Request parameter value for the action: initial call.
static String	DIALOG_OK Request parameter value for the action: ok.
static String	DIALOG_SET Request parameter value for the action: set.
static String	DIALOG_WAIT Request parameter value for the action: show please wait screen.
static String	PARAM_ACTION Request parameter name for the action.
static String	PARAM_CLOSELINK Request parameter name for the closelink.
static String	PARAM_DIALOGTYPE Request parameter name for the dialog type.
static String	PARAM_ERRORSTACK Request parameter name for the error stack.
static String	PARAM_FILE Request parameter name for the file.
static String	PARAM_FRAMENAME Request parameter name for the frame name.
static String	PARAM_ISPOPUP Request parameter name for the "is popup" flag.
static String	PARAM_LOCK Request parameter name for the lock.
static String	PARAM_MESSAGE Request parameter name for the error message.
static String	PARAM_REDIRECT Request parameter name for the redirect flag.
static String	PARAM_RESOURCE Request parameter name for the resource.
static String	PARAM_TARGET Request parameter name for the target.
static String	PARAM_THREAD Request parameter name for the thread id.
static String	PARAM_THREAD_HASNEXT Request parameter name for indicating if another thread is following the current one.
static String	PARAM_TITLE Request parameter name for the dialog title.
static String	REPORT_BEGIN Request parameter value for the action: begin the report.
static String	REPORT_END Request parameter value for the action: end the report.
static String	REPORT_UPDATE Request parameter value for the action: update the report.

Fields inherited from class org.opencms.workplace.tools.CmsToolDialog

PARAM_PATH, PARAM_ROOT, PARAM_STYLE, STYLE_NEW

Fields inherited from class org.opencms.workplace.CmsWorkplace

DEBUG, DEFAULT_LANGUAGE, DEFAULT_LOCALE, DIALOG_PATH_COMMON, FILE_DIALOG_CLOSE, FILE_DIALOG_SCREEN_CONFIRM, FILE_DIALOG_SCREEN_ERROR, FILE_DIALOG_SCREEN_ERRORPAGE, FILE_DIALOG_SCREEN_WAIT, FILE_EXPLORER_FILELIST, FILE_REPORT_OUTPUT, HTML_END, HTML_START, PARAM_WP_EXPLORER_RESOURCE, PARAM_WP_PROJECT, PARAM_WP_SITE, PATH_DIALOGS, PATH_WORKPLACE, REQUEST_ATTRIBUTE_MULTIPART, REQUEST_ATTRIBUTE_RELOADTREE, RFS_PATH_RESOURCES, SESSION_WORKPLACE_CLASS, TEMP_FILE_PREFIX, VFS_DIR_DEFAULTBODIES, VFS_DIR_TEMPLATES, VFS_PATH_COMMONS, VFS_PATH_EDITORS, VFS_PATH_GALLERIES, VFS_PATH_LOCALES, VFS_PATH_MODULES, VFS_PATH_RESOURCES, VFS_PATH_SYSTEM, VFS_PATH_VIEWS, VFS_PATH_WORKPLACE

Constructor Summary

CmsDialog(CmsJspActionElement jsp)
Public constructor with JSP action element.

CmsDialog(PageContext context, HttpServletRequest req, HttpServletResponse res)
Public constructor with JSP variables.

Method Summary

void	actionCloseDialog() Used to close the current JSP dialog.
protected String	appendDelimiter(String attribute) Appends a space char.
protected boolean	checkResourcePermissions(CmsPermissionSet required, boolean neededForFolder) Checks if the permissions of the current user on the resource to use in the dialog are sufficient.
protected boolean	checkResourcePermissions(CmsPermissionSet required, boolean neededForFolder, CmsMessageContainer errorMessage) Checks if the permissions of the current user on the resource to use in the dialog are sufficient.
String	dialog(int segment, String attributes) Builds the outer dialog window border.
String	dialogBlock(int segment, String headline, boolean error) Builds a block with 3D border and optional subheadline in the dialog content area.
String	dialogBlockEnd() Builds the end HTML for a block with 3D border in the dialog content area.
String	dialogBlockStart(String headline) Builds the start HTML for a block with 3D border and optional subheadline in the dialog content area.
String	dialogButtonRow(int segment) Builds the button row under the dialog content area without the buttons.
String	dialogButtonRowEnd() Builds the end of the button row under the dialog content area without the buttons.
String	dialogButtonRowStart() Builds the start of the button row under the dialog content area without the buttons.
String	dialogButtons(int[] buttons, String[] attributes) Builds the html for the button row under the dialog content area, including buttons.
String	dialogButtonsClose() Builds a button row with a single "close" button.
String	dialogButtonsClose(String closeAttribute) Builds a button row with a single "close" button.
String	dialogButtonsCloseDetails(String closeAttribute, String detailsAttribute) Builds a button row with a "close" and a "details" button.
protected void	dialogButtonsHtml(StringBuffer result, int button, String attribute) Renders the HTML for a single input button of a specified type.
String	dialogButtonsOk() Builds a button row with a single "ok" button.
String	dialogButtonsOk(String okAttribute) Builds a button row with a single "ok" button.
String	dialogButtonsOkCancel() Builds a button row with an "ok" and a "cancel" button.
String	dialogButtonsOkCancel(String okAttributes, String cancelAttributes) Builds a button row with an "ok" and a "cancel" button.
String	dialogButtonsOkCancelAdvanced(String okAttributes, String cancelAttributes, String advancedAttributes) Builds a button row with an "ok", a "cancel" and an "advanced" button.
String	dialogButtonsSetOkCancel(String setAttributes, String okAttributes, String cancelAttributes) Builds a button row with a "set", an "ok", and a "cancel" button.
String	dialogContent(int segment, String title) Builds the content area of the dialog window.
String	dialogContentEnd() Returns the end html for the content area of the dialog window.
String	dialogContentStart(String title) Returns the start html for the content area of the dialog window.
String	dialogEnd() Returns the end html for the outer dialog window border.
String	dialogHead(String title) Builds the title of the dialog window.
String	dialogHorizontalSpacer(int width) Builds an invisible horiziontal spacer with the specified width.
String	dialogRow(int segment) Builds a dialog line without break (display: block).
String	dialogRowEnd() Builds the end of a dialog line without break (display: block).
String	dialogRowStart() Builds the start of a dialog line without break (display: block).
String	dialogScriptSubmit() Builds the standard javascript for submitting the dialog.
String	dialogSeparator() Builds a horizontal separator line in the dialog content area.
String	dialogSpacer() Builds a space between two elements in the dialog content area.
String	dialogStart() Returns the start html for the outer dialog window border.
String	dialogStart(String attributes) Returns the start html for the outer dialog window border.
String	dialogSubheadline(String headline) Builds a subheadline in the dialog content area.
String	dialogToggleStart(String headline, String id, boolean show) Builds the HTML code to fold and unfild a white-box.
String	dialogWhiteBox(int segment) Builds a white box in the dialog content area.
String	dialogWhiteBoxEnd() Builds the end of a white box in the dialog content area.
String	dialogWhiteBoxStart() Builds the start of a white box in the dialog content area.
int	getAction() Returns the action value.
protected String	getAdministrationBackLink() Returns the link URL to get back one folder in the administration view.
String	getCancelAction() Returns the action to be carried out after a click on the cancel button..
String	getDialogRealUri() Returns the http URI of the current dialog, to be used as value for the "action" attribute of a html form.
String	getDialogUri() Returns the http URI of the current dialog, to be used as value for the "action" attribute of a html form.
String	getOnlineHelpUriCustom() Returns the custom mapping for the online help.
String	getParamAction() Returns the value of the action parameter, or null if this parameter was not provided.
String	getParamCloseLink() Returns the value of the closelink parameter, or null if this parameter was not provided.
String	getParamDialogtype() Returns the value of the dialogtype parameter, or null if this parameter was not provided.
String	getParamFramename() Returns the value of the frame name parameter.
String	getParamIsPopup() Returns the ispopup parameter.
String	getParamMessage() Returns the value of the message parameter, or null if this parameter was not provided.
String	getParamRedirect() Returns the value of the redirect flag parameter.
String	getParamResource() Returns the value of the file parameter, or null if this parameter was not provided.
String	getParamTitle() Returns the value of the title parameter, or null if this parameter was not provided.
String	getState() Gets a formatted file state string.
String	htmlStart() Builds the start html of the page, including setting of DOCTYPE and inserting a header with the content-type.
String	htmlStart(String helpUrl) Builds the start html of the page, including setting of DOCTYPE and inserting a header with the content-type.
String	htmlStart(String helpUrl, String title) Builds the start html of the page, including setting of DOCTYPE and inserting a header with the content-type.
String	htmlStartStyle(String title, String stylesheet) Builds the start html of the page, including setting of DOCTYPE, inserting a header with the content-type and choosing an individual style sheet.
void	includeErrorpage(CmsWorkplace wp, Throwable t) Displays the throwable on the error page and logs the error.
static CmsDialog	initCmsDialog(PageContext context, HttpServletRequest req, HttpServletResponse res) Returns an initialized CmsDialog instance that is read from the request attributes.
protected void	initWorkplaceRequestValues(CmsWorkplaceSettings settings, HttpServletRequest request) Analyzes the request for workplace parameters and adjusts the workplace settings accordingly.
boolean	isPopup() Returns the "isPopup" flag.
String	pageHtml(int segment, String helpUrl) Builds the start html of the page, including setting of DOCTYPE and inserting a header with the content-type.
String	pageHtml(int segment, String helpUrl, String title) Builds the start html of the page, including setting of DOCTYPE and inserting a header with the content-type.
protected void	setAction(int value) Sets the action value.
void	setOnlineHelpUriCustom(String uri) Set the custom mapping for the online help.
void	setParamAction(String value) Sets the value of the action parameter.
void	setParamCloseLink(String value) Sets the value of the closelink parameter.
void	setParamDialogtype(String value) Sets the value of the dialogtype parameter.
void	setParamFramename(String value) Sets the value of the frame name parameter.
void	setParamIsPopup(String value) Sets the ispopup parameter.
void	setParamMessage(String value) Sets the value of the message parameter.
void	setParamRedirect(String redirect) Sets the value of the redirect flag parameter.
void	setParamResource(String value) Sets the value of the file parameter.
void	setParamTitle(String value) Sets the value of the title parameter.

Methods inherited from class org.opencms.workplace.tools.CmsToolDialog

dialogTitle, getAdminTool, getCurrentToolPath, getParamPath, getParamRoot, getParamStyle, getParentPath, getToolManager, iconsBlockArea, iconsBlockAreaEnd, iconsBlockAreaStart, initAdminTool, pageBody, pageHtmlStyle, setParamPath, setParamRoot, setParamStyle, useNewStyle

Methods inherited from class org.opencms.workplace.CmsWorkplace

addMessages, allParamsAsHidden, allParamsAsRequest, allParamValues, bodyEnd, bodyStart, bodyStart, buildSelect, buildSelect, button, button, buttonBar, buttonBar, buttonBarHorizontalLine, buttonBarLabel, buttonBarLabel, buttonBarLine, buttonBarLineSpacer, buttonBarSeparator, buttonBarSpacer, buttonBarStartTab, calendarIncludes, calendarIncludes, calendarInit, calendarInit, checkLock, checkLock, decodeParamValue, fillParamValues, fillParamValues, getBroadcastMessageString, getCalendarDate, getCalendarJavaDateFormat, getCalendarLocalizedTime, getCms, getEncoding, getExplorerFileListFullUri, getFrameSource, getJsp, getLocale, getMacroResolver, getMessages, getMultiPartFileItems, getParameterMap, getResourceUri, getResourceUri, getSession, getSettings, getSkinUri, getStyleUri, getStyleUri, getStyleUri, htmlEnd, initMessages, initSettings, initUserSettings, initWorkplaceMembers, initWorkplaceSettings, isForwarded, isHelpEnabled, isSubElement, key, key, key, nullToEmpty, paramsAsHidden, paramsAsHidden, paramsAsParameterMap, paramsAsRequest, paramValues, resolveMacros, sendCmsRedirect, sendForward, setForwarded, shortKey, switchToCurrentProject, switchToTempProject

Methods inherited from class java.lang.Object

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

Field Detail

ACTION_CANCEL

public static final int ACTION_CANCEL

Value for the action: cancel.

See Also:

Constant Field Values

ACTION_CLOSEPOPUP

public static final int ACTION_CLOSEPOPUP

Value for the action: close popup window.

See Also:

Constant Field Values

ACTION_CLOSEPOPUP_SAVE

public static final int ACTION_CLOSEPOPUP_SAVE

Value for the action: save & close popup window.

See Also:

Constant Field Values

ACTION_CONFIRMED

public static final int ACTION_CONFIRMED

Value for the action: confirmed.

See Also:

Constant Field Values

ACTION_DEFAULT

public static final int ACTION_DEFAULT

Value for the action: default (show initial dialog form).

See Also:

Constant Field Values

ACTION_OK

public static final int ACTION_OK

Value for the action: ok.

See Also:

Constant Field Values

ACTION_REPORT_BEGIN

public static final int ACTION_REPORT_BEGIN

Value for the action: begin the report.

See Also:

Constant Field Values

ACTION_REPORT_END

public static final int ACTION_REPORT_END

Value for the action: end the report.

See Also:

Constant Field Values

ACTION_REPORT_UPDATE

public static final int ACTION_REPORT_UPDATE

Value for the action: update the report.

See Also:

Constant Field Values

ACTION_SET

public static final int ACTION_SET

Value for the action: button "set" clicked.

See Also:

Constant Field Values

ACTION_WAIT

public static final int ACTION_WAIT

Value for the action: wait (show please wait screen).

See Also:

Constant Field Values

BUTTON_ADVANCED

public static final int BUTTON_ADVANCED

Constant for the "Advanced" button in the build button methods.

See Also:

Constant Field Values

BUTTON_BACK

public static final int BUTTON_BACK

Constant for the "Back" button in the build button methods.

See Also:

Constant Field Values

BUTTON_CANCEL

public static final int BUTTON_CANCEL

Constant for the "Cancel" button in the build button methods.

See Also:

Constant Field Values

BUTTON_CLOSE

public static final int BUTTON_CLOSE

Constant for the "Close" button in the build button methods.

See Also:

Constant Field Values

BUTTON_CONTINUE

public static final int BUTTON_CONTINUE

Constant for the "Continue" button in the build button methods.

See Also:

Constant Field Values

BUTTON_DETAILS

public static final int BUTTON_DETAILS

Constant for the "Details" button in the build button methods.

See Also:

Constant Field Values

BUTTON_DISCARD

public static final int BUTTON_DISCARD

Constant for the "Discard" button in the build button methods (same function as "Cancel" button but different text on button.

See Also:

Constant Field Values

BUTTON_EDIT

public static final int BUTTON_EDIT

Constant for the "Edit" button in the build button methods (same function as "Ok" button but different text on button.

See Also:

Constant Field Values

BUTTON_OK

public static final int BUTTON_OK

Constant for the "OK" button in the build button methods.

See Also:

Constant Field Values

BUTTON_OK_NO_SUBMIT

public static final int BUTTON_OK_NO_SUBMIT

Constant for the "OK" button in the build button methods (without form submission).

See Also:

Constant Field Values

BUTTON_SET

public static final int BUTTON_SET

Constant for the "Set" button in the build button methods.

See Also:

Constant Field Values

DIALOG_BACK

public static final String DIALOG_BACK

Request parameter value for the action: back.

See Also:

Constant Field Values

DIALOG_CANCEL

public static final String DIALOG_CANCEL

Request parameter value for the action: cancel.

See Also:

Constant Field Values

DIALOG_CONFIRMED

public static final String DIALOG_CONFIRMED

Request parameter value for the action: dialog confirmed.

See Also:

Constant Field Values

DIALOG_CONTINUE

public static final String DIALOG_CONTINUE

Request parameter value for the action: continue.

See Also:

Constant Field Values

DIALOG_INITIAL

public static final String DIALOG_INITIAL

Request parameter value for the action: initial call.

See Also:

Constant Field Values

DIALOG_OK

public static final String DIALOG_OK

Request parameter value for the action: ok.

See Also:

Constant Field Values

DIALOG_SET

public static final String DIALOG_SET

Request parameter value for the action: set.

See Also:

Constant Field Values

DIALOG_WAIT

public static final String DIALOG_WAIT

Request parameter value for the action: show please wait screen.

See Also:

Constant Field Values

PARAM_ACTION

public static final String PARAM_ACTION

Request parameter name for the action.

See Also:

Constant Field Values

PARAM_CLOSELINK

public static final String PARAM_CLOSELINK

Request parameter name for the closelink.

See Also:

Constant Field Values

PARAM_DIALOGTYPE

public static final String PARAM_DIALOGTYPE

Request parameter name for the dialog type.

See Also:

Constant Field Values

PARAM_ERRORSTACK

public static final String PARAM_ERRORSTACK

Request parameter name for the error stack.

See Also:

Constant Field Values

PARAM_FILE

public static final String PARAM_FILE

Request parameter name for the file.

See Also:

Constant Field Values

PARAM_FRAMENAME

public static final String PARAM_FRAMENAME

Request parameter name for the frame name.

See Also:

Constant Field Values

PARAM_ISPOPUP

public static final String PARAM_ISPOPUP

Request parameter name for the "is popup" flag.

See Also:

Constant Field Values

PARAM_LOCK

public static final String PARAM_LOCK

Request parameter name for the lock.

See Also:

Constant Field Values

PARAM_MESSAGE

public static final String PARAM_MESSAGE

Request parameter name for the error message.

See Also:

Constant Field Values

PARAM_REDIRECT

public static final String PARAM_REDIRECT

Request parameter name for the redirect flag.

See Also:

Constant Field Values

PARAM_RESOURCE

public static final String PARAM_RESOURCE

Request parameter name for the resource.

See Also:

Constant Field Values

PARAM_TARGET

public static final String PARAM_TARGET

Request parameter name for the target.

See Also:

Constant Field Values

PARAM_THREAD

public static final String PARAM_THREAD

Request parameter name for the thread id.

See Also:

Constant Field Values

PARAM_THREAD_HASNEXT

public static final String PARAM_THREAD_HASNEXT

Request parameter name for indicating if another thread is following the current one.

See Also:

Constant Field Values

PARAM_TITLE

public static final String PARAM_TITLE

Request parameter name for the dialog title.

See Also:

Constant Field Values

REPORT_BEGIN

public static final String REPORT_BEGIN

Request parameter value for the action: begin the report.

See Also:

Constant Field Values

REPORT_END

public static final String REPORT_END

Request parameter value for the action: end the report.

See Also:

Constant Field Values

REPORT_UPDATE

public static final String REPORT_UPDATE

Request parameter value for the action: update the report.

See Also:

Constant Field Values

ATTRIBUTE_THROWABLE

protected static final String ATTRIBUTE_THROWABLE

Key name for the throwable attribute.

See Also:

Constant Field Values

Constructor Detail

CmsDialog

public CmsDialog(CmsJspActionElement jsp)

Public constructor with JSP action element.

Parameters:

jsp - an initialized JSP action element

CmsDialog

public CmsDialog(PageContext context,
                 HttpServletRequest req,
                 HttpServletResponse res)

Public constructor with JSP variables.

Parameters:

context - the JSP page context

req - the JSP request

res - the JSP response

Method Detail

initCmsDialog

public static CmsDialog initCmsDialog(PageContext context,
                                      HttpServletRequest req,
                                      HttpServletResponse res)

Returns an initialized CmsDialog instance that is read from the request attributes.

This method is used by dialog elements. The dialog elements do not initialize their own workplace class, but use the initialized instance of the "master" class. This is required to ensure that parameters of the "master" class can properly be kept on the dialog elements.

To prevent null pointer exceptions, an empty dialog is returned if nothing is found in the request attributes.

Parameters:

context - the JSP page context

req - the JSP request

res - the JSP response

Returns:

an initialized CmsDialog instance that is read from the request attributes

actionCloseDialog

public void actionCloseDialog()
                       throws JspException

Used to close the current JSP dialog.

This method tries to include the URI stored in the workplace settings. This URI is determined by the frame name, which has to be set in the framename parameter.

Throws:

JspException - if including an element fails

dialog

public String dialog(int segment,
                     String attributes)

Builds the outer dialog window border.

Parameters:

segment - the HTML segment (START / END)

attributes - optional additional attributes for the opening dialog table

Returns:

a dialog window start / end segment

dialogBlock

public String dialogBlock(int segment,
                          String headline,
                          boolean error)

Builds a block with 3D border and optional subheadline in the dialog content area.

Parameters:

segment - the HTML segment (START / END)

headline - the headline String for the block

error - if true, an error block will be created

Returns:

3D block start / end segment

dialogBlockEnd

public String dialogBlockEnd()

Builds the end HTML for a block with 3D border in the dialog content area.

Returns:

3D block start / end segment

dialogBlockStart

public String dialogBlockStart(String headline)

Builds the start HTML for a block with 3D border and optional subheadline in the dialog content area.

Parameters:

headline - the headline String for the block

Returns:

3D block start / end segment

dialogButtonRow

public String dialogButtonRow(int segment)

Builds the button row under the dialog content area without the buttons.

Parameters:

segment - the HTML segment (START / END)

Returns:

the button row start / end segment

dialogButtonRowEnd

public String dialogButtonRowEnd()

Builds the end of the button row under the dialog content area without the buttons.

Returns:

the button row end segment

dialogButtonRowStart

public String dialogButtonRowStart()

Builds the start of the button row under the dialog content area without the buttons.

Returns:

the button row start segment

dialogButtons

public String dialogButtons(int[] buttons,
                            String[] attributes)

Builds the html for the button row under the dialog content area, including buttons.

Parameters:

buttons - array of constants of which buttons to include in the row

attributes - array of Strings for additional button attributes

Returns:

the html for the button row under the dialog content area, including buttons

dialogButtonsClose

public String dialogButtonsClose()

Builds a button row with a single "close" button.

Returns:

the button row

dialogButtonsClose

public String dialogButtonsClose(String closeAttribute)

Builds a button row with a single "close" button.

Parameters:

closeAttribute - additional attributes for the "close" button

Returns:

the button row

dialogButtonsCloseDetails

public String dialogButtonsCloseDetails(String closeAttribute,
                                        String detailsAttribute)

Builds a button row with a "close" and a "details" button.

Parameters:

closeAttribute - additional attributes for the "close" button

detailsAttribute - additional attributes for the "details" button

Returns:

the button row

dialogButtonsOk

public String dialogButtonsOk()

Builds a button row with a single "ok" button.

Returns:

the button row

dialogButtonsOk

public String dialogButtonsOk(String okAttribute)

Builds a button row with a single "ok" button.

Parameters:

okAttribute - additional attributes for the "ok" button

Returns:

the button row

dialogButtonsOkCancel

public String dialogButtonsOkCancel()

Builds a button row with an "ok" and a "cancel" button.

Returns:

the button row

dialogButtonsOkCancel

public String dialogButtonsOkCancel(String okAttributes,
                                    String cancelAttributes)

Builds a button row with an "ok" and a "cancel" button.

Parameters:

okAttributes - additional attributes for the "ok" button

cancelAttributes - additional attributes for the "cancel" button

Returns:

the button row

dialogButtonsOkCancelAdvanced

public String dialogButtonsOkCancelAdvanced(String okAttributes,
                                            String cancelAttributes,
                                            String advancedAttributes)

Builds a button row with an "ok", a "cancel" and an "advanced" button.

Parameters:

okAttributes - additional attributes for the "ok" button

cancelAttributes - additional attributes for the "cancel" button

advancedAttributes - additional attributes for the "advanced" button

Returns:

the button row

dialogButtonsSetOkCancel

public String dialogButtonsSetOkCancel(String setAttributes,
                                       String okAttributes,
                                       String cancelAttributes)

Builds a button row with a "set", an "ok", and a "cancel" button.

Parameters:

setAttributes - additional attributes for the "set" button

okAttributes - additional attributes for the "ok" button

cancelAttributes - additional attributes for the "cancel" button

Returns:

the button row

dialogContent

public String dialogContent(int segment,
                            String title)

Builds the content area of the dialog window.

Parameters:

segment - the HTML segment (START / END)

title - the title String for the dialog window

Returns:

a content area start / end segment

dialogContentEnd

public String dialogContentEnd()

Returns the end html for the content area of the dialog window.

Returns:

the end html for the content area of the dialog window

dialogContentStart

public String dialogContentStart(String title)

Returns the start html for the content area of the dialog window.

Parameters:

title - the title for the dialog

Returns:

the start html for the content area of the dialog window

dialogEnd

public String dialogEnd()

Returns the end html for the outer dialog window border.

Returns:

the end html for the outer dialog window border

dialogHead

public String dialogHead(String title)

Builds the title of the dialog window.

Parameters:

title - the title String for the dialog window

Returns:

the HTML title String for the dialog window

dialogHorizontalSpacer

public String dialogHorizontalSpacer(int width)

Builds an invisible horiziontal spacer with the specified width.

Parameters:

width - the width of the spacer in pixels

Returns:

an invisible horiziontal spacer with the specified width

dialogRow

public String dialogRow(int segment)

Builds a dialog line without break (display: block).

Parameters:

segment - the HTML segment (START / END)

Returns:

a row start / end segment

dialogRowEnd

public String dialogRowEnd()

Builds the end of a dialog line without break (display: block).

Returns:

the row end segment

dialogRowStart

public String dialogRowStart()

Builds the start of a dialog line without break (display: block).

Returns:

the row start segment

dialogScriptSubmit

public String dialogScriptSubmit()

Builds the standard javascript for submitting the dialog.

Overrides:

dialogScriptSubmit in class CmsToolDialog

Returns:

the standard javascript for submitting the dialog

dialogSeparator

public String dialogSeparator()

Builds a horizontal separator line in the dialog content area.

Returns:

a separator element

dialogSpacer

public String dialogSpacer()

Builds a space between two elements in the dialog content area.

Returns:

a space element

dialogStart

public String dialogStart()

Returns the start html for the outer dialog window border.

Returns:

the start html for the outer dialog window border

dialogStart

public String dialogStart(String attributes)

Returns the start html for the outer dialog window border.

Parameters:

attributes - optional html attributes to insert

Returns:

the start html for the outer dialog window border

dialogSubheadline

public String dialogSubheadline(String headline)

Builds a subheadline in the dialog content area.

Parameters:

headline - the desired headline string

Returns:

a subheadline element

dialogToggleStart

public String dialogToggleStart(String headline,
                                String id,
                                boolean show)

Builds the HTML code to fold and unfild a white-box.

Parameters:

headline - the heading to display

id - the id of the toggle

show - true if the white box is open at the beginning

Returns:

HTML code to fold and unfild a white-box

dialogWhiteBox

public String dialogWhiteBox(int segment)

Builds a white box in the dialog content area.

Parameters:

segment - the HTML segment (START / END)

Returns:

the white box start / end segment

dialogWhiteBoxEnd

public String dialogWhiteBoxEnd()

Builds the end of a white box in the dialog content area.

Returns:

the white box end segment

dialogWhiteBoxStart

public String dialogWhiteBoxStart()

Builds the start of a white box in the dialog content area.

Returns:

the white box start segment

getAction

public int getAction()

Returns the action value.

The action value is used on JSP pages to select the proper action in a large "switch" statement.

Returns:

the action value

getCancelAction

public String getCancelAction()

Returns the action to be carried out after a click on the cancel button..

Returns:

the action to be carried out after a click on the cancel button.

getDialogRealUri

public String getDialogRealUri()

Returns the http URI of the current dialog, to be used as value for the "action" attribute of a html form.

This URI is the real one.

Returns:

the http URI of the current dialog

getDialogUri

public String getDialogUri()

Returns the http URI of the current dialog, to be used as value for the "action" attribute of a html form.

This URI could not be really the real one...

Returns:

the http URI of the current dialog

getOnlineHelpUriCustom

public String getOnlineHelpUriCustom()

Returns the custom mapping for the online help.

Returns:

the custom mapping for the online help

getParamAction

public String getParamAction()

Returns the value of the action parameter, or null if this parameter was not provided.

The action parameter is very important, it will select the dialog action to perform. The value of the getAction() method will be initialized from the action parameter.

Returns:

the value of the action parameter

getParamCloseLink

public String getParamCloseLink()

Returns the value of the closelink parameter, or null if this parameter was not provided.

Returns:

the value of the closelink parameter

getParamDialogtype

public String getParamDialogtype()

Returns the value of the dialogtype parameter, or null if this parameter was not provided.

This parameter is very important. It must match to the localization keys, e.g. "copy" for the copy dialog.

This parameter must be set manually by the subclass during first initialization.

Returns:

the value of the dialogtype parameter

getParamFramename

public String getParamFramename()

Returns the value of the frame name parameter.

Returns:

the value of the errorstack parameter

getParamIsPopup

public String getParamIsPopup()

Returns the ispopup parameter.

Use this parameter to indicate that the dialog is shown in a popup window.

Returns:

the ispopup parameter

getParamMessage

public String getParamMessage()

Returns the value of the message parameter, or null if this parameter was not provided.

The message parameter is used on dialogs to show any text message.

Returns:

the value of the message parameter

getParamRedirect

public String getParamRedirect()

Returns the value of the redirect flag parameter.

Returns:

the value of the redirect flag parameter

getParamResource

public String getParamResource()

Returns the value of the file parameter, or null if this parameter was not provided.

The file parameter selects the file on which the dialog action is to be performed.

Returns:

the value of the file parameter

getParamTitle

public String getParamTitle()

Returns the value of the title parameter, or null if this parameter was not provided.

This parameter is used to build the title of the dialog. It is a parameter so that the title can be passed to included elements.

Returns:

the value of the title parameter

getState

public String getState()
                throws CmsException

Gets a formatted file state string.

Returns:

formatted state string

Throws:

CmsException - if something goes wrong

htmlStart

public String htmlStart()

Builds the start html of the page, including setting of DOCTYPE and inserting a header with the content-type.

Returns:

the start html of the page

htmlStart

public String htmlStart(String helpUrl)

Builds the start html of the page, including setting of DOCTYPE and inserting a header with the content-type.

This overloads the default method of the parent class.

Overrides:

htmlStart in class CmsWorkplace

Parameters:

helpUrl - the key for the online help to include on the page

Returns:

the start html of the page

htmlStart

public String htmlStart(String helpUrl,
                        String title)

Builds the start html of the page, including setting of DOCTYPE and inserting a header with the content-type.

Parameters:

helpUrl - the key for the online help to include on the page

title - the title for the page

Returns:

the start html of the page

htmlStartStyle

public String htmlStartStyle(String title,
                             String stylesheet)

Builds the start html of the page, including setting of DOCTYPE, inserting a header with the content-type and choosing an individual style sheet.

Parameters:

title - the title for the page

stylesheet - the style sheet to include

Returns:

the start html of the page

includeErrorpage

public void includeErrorpage(CmsWorkplace wp,
                             Throwable t)
                      throws JspException

Displays the throwable on the error page and logs the error.

Parameters:

wp - the workplace class

t - the throwable to be displayed on the errorpage

Throws:

JspException - if the include of the errorpage jsp fails

isPopup

public boolean isPopup()

Returns the "isPopup" flag.

Returns:

the "isPopup" flag

pageHtml

public String pageHtml(int segment,
                       String helpUrl)

Builds the start html of the page, including setting of DOCTYPE and inserting a header with the content-type.

This overloads the default method of the parent class.

Overrides:

pageHtml in class CmsWorkplace

Parameters:

segment - the HTML segment (START / END)

helpUrl - the url for the online help to include on the page

Returns:

the start html of the page

pageHtml

public String pageHtml(int segment,
                       String helpUrl,
                       String title)

Builds the start html of the page, including setting of DOCTYPE and inserting a header with the content-type.

This overloads the default method of the parent class.

Parameters:

segment - the HTML segment (START / END)

helpUrl - the url for the online help to include on the page

title - the title for the page

Returns:

the start html of the page

setOnlineHelpUriCustom

public void setOnlineHelpUriCustom(String uri)

Set the custom mapping for the online help.

This value will be set to a javascript variable called onlineHelpUriCustom. If it is set, the top.head javascript for the online help will use this value.

This method should be called from initWorkplaceRequestValues(CmsWorkplaceSettings, HttpServletRequest), CmsWorkplace.initWorkplaceMembers(CmsJspActionElement) or from the jsp if the dialog class is used for several actions. It should be used whenever the online help mapping does not work (due to jsp - forwards).

Parameters:

uri - the left hand value in mapping.properties for the online help pages

setParamAction

public void setParamAction(String value)

Sets the value of the action parameter.

Parameters:

value - the value to set

setParamCloseLink

public void setParamCloseLink(String value)

Sets the value of the closelink parameter.

Parameters:

value - the value to set

setParamDialogtype

public void setParamDialogtype(String value)

Sets the value of the dialogtype parameter.

Parameters:

value - the value to set

setParamFramename

public void setParamFramename(String value)

Sets the value of the frame name parameter.

Parameters:

value - the value to set

setParamIsPopup

public void setParamIsPopup(String value)

Sets the ispopup parameter.

Parameters:

value - the ispopup parameter value

setParamMessage

public void setParamMessage(String value)

Sets the value of the message parameter.

Parameters:

value - the value to set

setParamRedirect

public void setParamRedirect(String redirect)

Sets the value of the redirect flag parameter.

Parameters:

redirect - the value of the redirect flag parameter

setParamResource

public void setParamResource(String value)

Sets the value of the file parameter.

Parameters:

value - the value to set

setParamTitle

public void setParamTitle(String value)

Sets the value of the title parameter.

Parameters:

value - the value to set

appendDelimiter

protected String appendDelimiter(String attribute)

Appends a space char. between tag attribs.

Parameters:

attribute - a tag attribute

Returns:

the tag attribute with a leading space char.

checkResourcePermissions

protected boolean checkResourcePermissions(CmsPermissionSet required,
                                           boolean neededForFolder)

Checks if the permissions of the current user on the resource to use in the dialog are sufficient.

Automatically generates a CmsMessageContainer object with an error message and stores it in the users session.

Parameters:

required - the required permissions for the dialog

neededForFolder - if true, the permissions are required for the parent folder of the resource (e.g. for editors)

Returns:

true if the permissions are sufficient, otherwise false

checkResourcePermissions

protected boolean checkResourcePermissions(CmsPermissionSet required,
                                           boolean neededForFolder,
                                           CmsMessageContainer errorMessage)

Checks if the permissions of the current user on the resource to use in the dialog are sufficient.

Automatically generates a CmsMessageContainer object with an error message and stores it in the users session.

Parameters:

required - the required permissions for the dialog

neededForFolder - if true, the permissions are required for the parent folder of the resource (e.g. for editors)

errorMessage - the message container that is stored in the session in case the permissions are not sufficient

Returns:

true if the permissions are sufficient, otherwise false

dialogButtonsHtml

protected void dialogButtonsHtml(StringBuffer result,
                                 int button,
                                 String attribute)

Renders the HTML for a single input button of a specified type.

Parameters:

result - a string buffer where the rendered HTML gets appended to

button - a integer key to identify the button

attribute - an optional string with possible tag attributes, or null

getAdministrationBackLink

protected String getAdministrationBackLink()

Returns the link URL to get back one folder in the administration view.

Returns:

the link URL to get back one folder in the administration view

initWorkplaceRequestValues

protected void initWorkplaceRequestValues(CmsWorkplaceSettings settings,
                                          HttpServletRequest request)

Description copied from class: CmsWorkplace

Analyzes the request for workplace parameters and adjusts the workplace settings accordingly.

Overrides:

initWorkplaceRequestValues in class CmsToolDialog

Parameters:

settings - the workplace settings

request - the current request

See Also:

CmsWorkplace.initWorkplaceRequestValues(org.opencms.workplace.CmsWorkplaceSettings, javax.servlet.http.HttpServletRequest)

setAction

protected void setAction(int value)

Sets the action value.

Parameters:

value - the action value