org.opencms.workplace.commons
Class CmsAvailability

java.lang.Object
  org.opencms.workplace.CmsWorkplace
      org.opencms.workplace.tools.CmsToolDialog
          org.opencms.workplace.CmsDialog
              org.opencms.workplace.CmsMultiDialog
                  org.opencms.workplace.commons.CmsAvailability

public class CmsAvailability
extends CmsMultiDialog

Provides methods for the resource availability/notification dialog.

The following files use this class:

• /commons/availability.jsp

Since:

6.0.0

Version:

$Revision: 1.2 $

Author:

Jan Baudisch, Andreas Zahner

Field Summary

static String	DIALOG_TYPE The dialog type.
static String	PARAM_ENABLE_NOTIFICATION Request parameter name for the activation of the notifciation.
static String	PARAM_EXPIREDATE Request parameter name for the expiredate.
static String	PARAM_LEAVEEXPIRE Request parameter name for the leaveexpire.
static String	PARAM_LEAVERELEASE Request parameter name for the leaverelease.
static String	PARAM_MODIFY_SIBLINGS Request parameter name for the recursive flag.
static String	PARAM_NOTIFICATION_INTERVAL Request parameter name for the activation of the notifciation.
static String	PARAM_RECURSIVE Request parameter name for the recursive flag.
static String	PARAM_RELEASEDATE Request parameter name for the releasedate.
static String	PARAM_RESETEXPIRE Request parameter name for the resetexpire.
static String	PARAM_RESETRELEASE Request parameter name for the resetrelease.

Fields inherited from class org.opencms.workplace.CmsMultiDialog

DELIMITER_RESOURCES, PARAM_RESOURCELIST

Fields inherited from class org.opencms.workplace.CmsDialog

ACTION_CANCEL, ACTION_CLOSEPOPUP, ACTION_CLOSEPOPUP_SAVE, ACTION_CONFIRMED, ACTION_DEFAULT, ACTION_OK, ACTION_REPORT_BEGIN, ACTION_REPORT_END, ACTION_REPORT_UPDATE, ACTION_SET, ACTION_WAIT, ATTRIBUTE_THROWABLE, BUTTON_ADVANCED, BUTTON_BACK, BUTTON_CANCEL, BUTTON_CLOSE, BUTTON_CONTINUE, BUTTON_DETAILS, BUTTON_DISCARD, BUTTON_EDIT, BUTTON_OK, BUTTON_OK_NO_SUBMIT, BUTTON_SET, DIALOG_BACK, DIALOG_CANCEL, DIALOG_CONFIRMED, DIALOG_CONTINUE, DIALOG_INITIAL, DIALOG_OK, DIALOG_SET, DIALOG_WAIT, PARAM_ACTION, PARAM_CLOSELINK, PARAM_DIALOGTYPE, PARAM_ERRORSTACK, PARAM_FILE, PARAM_FRAMENAME, PARAM_ISPOPUP, PARAM_LOCK, PARAM_MESSAGE, PARAM_REDIRECT, PARAM_RESOURCE, PARAM_TARGET, PARAM_THREAD, PARAM_THREAD_HASNEXT, PARAM_TITLE, REPORT_BEGIN, REPORT_END, REPORT_UPDATE

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

PARAM_BASE, 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

CmsAvailability(CmsJspActionElement jsp)
Public constructor.

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

Method Summary

void	actionCloseDialog() Used to close the current JSP dialog.
void	actionUpdate() Performs the resource operation, will be called by the JSP page.
String	buildCheckboxEnableNotification() Creates the checkbox to enable content notification for a resource.
String	buildCheckboxModifySiblings() Creates an the checkbox to modify all siblings.
String	buildCheckRecursive() Creates the "recursive" checkbox for touching subresources of folders.
String	buildInputNotificationInterval() Creates an input field for the notification interval.
String	buildResponsibleList() Builds a String with HTML code to display the responsibles of a resource.
String	getCurrentDateTime() Returns the current date and time as String formatted in localized pattern.
String	getCurrentExpireDate() Returns the current expiredate as String formatted in localized pattern.
String	getCurrentReleaseDate() Returns the current releasedate as String formatted in localized pattern.
protected String	getLocalizedType(int flags) Returns a localized String for "Group", if the flag of a group ACE, and the localization for "User" otherwise.
String	getParamEnablenotification() Returns the value of the enable_notification parameter.
String	getParamExpiredate() Returns the value of the new expiredate parameter, or null if this parameter was not provided.
String	getParamLeaveexpire() Returns the value of the leaveexpire parameter.
String	getParamModifysiblings() Returns the value of the modify siblings parameter, or null if this parameter was not provided.
String	getParamNotificationinterval() Returns the value of the notification interval parameter, or null if this parameter was not provided.
String	getParamRecursive() Returns the value of the recursive parameter, or null if this parameter was not provided.
String	getParamReleasedate() Returns the value of the new releasedate parameter, or null if this parameter was not provided.
String	getParamResetexpire() Returns the value of the resetexpire parameter.
String	getParamResetrelease() Returns the value of the resetrelease parameter.
protected void	initWorkplaceRequestValues(CmsWorkplaceSettings settings, HttpServletRequest request) Analyzes the request for workplace parameters and adjusts the workplace settings accordingly.
protected boolean	performDialogOperation() Modifies the release and expire date of a resource, and changes the notification interval.
protected void	performSingleResource(String resName, long releaseDate, long expireDate, boolean leaveRelease, boolean leaveExpire, boolean modifyRecursive, boolean modifySiblings) Performs the availability and notification operations on a single resource.
void	setParamEnablenotification(String value) Sets the value of the enable notification parameter.
void	setParamExpiredate(String value) Sets the value of the expire date.
void	setParamLeaveexpire(String paramLeaveexpire) Sets the value of the leaveexpire parameter.
void	setParamModifysiblings(String value) Sets the value of the modify siblings parameter.
void	setParamNotificationinterval(String value) Sets the value of the new timestamp parameter.
void	setParamRecursive(String value) Sets the value of the recursive parameter.
void	setParamReleasedate(String value) Sets the value of the releasedate parameter.
void	setParamResetexpire(String paramResetexpire) Sets the value of the resetexpire parameter.
void	setParamResetrelease(String paramResetrelease) Sets the value of the resetrelease parameter.
protected void	writeProperty(String resourcePath, String propertyName, String propertyValue) Writes a property value for a resource.

Methods inherited from class org.opencms.workplace.CmsMultiDialog

addMultiOperationException, buildResourceList, checkMultiOperationException, checkResourcePermissions, getParamResourcelist, getResourceList, isMultiOperation, isOperationOnFolder, setDialogTitle, setParamResourcelist

Methods inherited from class org.opencms.workplace.CmsDialog

appendDelimiter, checkResourcePermissions, dialog, dialogBlock, dialogBlockEnd, dialogBlockStart, dialogButtonRow, dialogButtonRowEnd, dialogButtonRowStart, dialogButtons, dialogButtonsClose, dialogButtonsClose, dialogButtonsCloseDetails, dialogButtonsHtml, dialogButtonsOk, dialogButtonsOk, dialogButtonsOkCancel, dialogButtonsOkCancel, dialogButtonsOkCancelAdvanced, dialogButtonsSetOkCancel, dialogContent, dialogContentEnd, dialogContentStart, dialogEnd, dialogHead, dialogHorizontalSpacer, dialogRow, dialogRowEnd, dialogRowStart, dialogScriptSubmit, dialogSeparator, dialogSpacer, dialogStart, dialogStart, dialogSubheadline, dialogToggleStart, dialogWhiteBox, dialogWhiteBoxEnd, dialogWhiteBoxStart, getAction, getAdministrationBackLink, getCancelAction, getDialogRealUri, getDialogUri, getOnlineHelpUriCustom, getParamAction, getParamCloseLink, getParamDialogtype, getParamFramename, getParamIsPopup, getParamMessage, getParamRedirect, getParamResource, getParamTitle, getState, htmlStart, htmlStart, htmlStart, htmlStartStyle, includeErrorpage, initCmsDialog, isPopup, pageHtml, pageHtml, setAction, setOnlineHelpUriCustom, setParamAction, setParamCloseLink, setParamDialogtype, setParamFramename, setParamIsPopup, setParamMessage, setParamRedirect, setParamResource, setParamTitle

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

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

Methods inherited from class org.opencms.workplace.CmsWorkplace

addMessages, 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, keyDefault, 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

DIALOG_TYPE

public static final String DIALOG_TYPE

The dialog type.

See Also:

Constant Field Values

PARAM_ENABLE_NOTIFICATION

public static final String PARAM_ENABLE_NOTIFICATION

Request parameter name for the activation of the notifciation.

See Also:

Constant Field Values

PARAM_EXPIREDATE

public static final String PARAM_EXPIREDATE

Request parameter name for the expiredate.

See Also:

Constant Field Values

PARAM_LEAVEEXPIRE

public static final String PARAM_LEAVEEXPIRE

Request parameter name for the leaveexpire.

See Also:

Constant Field Values

PARAM_LEAVERELEASE

public static final String PARAM_LEAVERELEASE

Request parameter name for the leaverelease.

See Also:

Constant Field Values

PARAM_MODIFY_SIBLINGS

public static final String PARAM_MODIFY_SIBLINGS

Request parameter name for the recursive flag.

See Also:

Constant Field Values

PARAM_NOTIFICATION_INTERVAL

public static final String PARAM_NOTIFICATION_INTERVAL

Request parameter name for the activation of the notifciation.

See Also:

Constant Field Values

PARAM_RECURSIVE

public static final String PARAM_RECURSIVE

Request parameter name for the recursive flag.

See Also:

Constant Field Values

PARAM_RELEASEDATE

public static final String PARAM_RELEASEDATE

Request parameter name for the releasedate.

See Also:

Constant Field Values

PARAM_RESETEXPIRE

public static final String PARAM_RESETEXPIRE

Request parameter name for the resetexpire.

See Also:

Constant Field Values

PARAM_RESETRELEASE

public static final String PARAM_RESETRELEASE

Request parameter name for the resetrelease.

See Also:

Constant Field Values

Constructor Detail

CmsAvailability

public CmsAvailability(CmsJspActionElement jsp)

Public constructor.

Parameters:

jsp - an initialized JSP action element

CmsAvailability

public CmsAvailability(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

getLocalizedType

protected String getLocalizedType(int flags)

Returns a localized String for "Group", if the flag of a group ACE, and the localization for "User" otherwise.

Parameters:

flags - the flags of the ACE

Returns:

localization for "Group", if the flag belongs to a group ACE

actionCloseDialog

public void actionCloseDialog()
                       throws JspException

Description copied from class: CmsDialog

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.

Overrides:

actionCloseDialog in class CmsDialog

Throws:

JspException - if including an element fails

See Also:

CmsDialog.actionCloseDialog()

actionUpdate

public void actionUpdate()
                  throws JspException

Performs the resource operation, will be called by the JSP page.

Throws:

JspException - if problems including sub-elements occur

buildCheckboxEnableNotification

public String buildCheckboxEnableNotification()

Creates the checkbox to enable content notification for a resource.

Returns:

HTML code for the enable_notification checkbox.

buildCheckboxModifySiblings

public String buildCheckboxModifySiblings()

Creates an the checkbox to modify all siblings.

If no siblings exist for this resource, an empty string will be returned.

Returns:

HTML code for the modify siblings checkbox.

buildCheckRecursive

public String buildCheckRecursive()

Creates the "recursive" checkbox for touching subresources of folders.

Returns:

the String with the checkbox input field or an empty String for folders.

buildInputNotificationInterval

public String buildInputNotificationInterval()

Creates an input field for the notification interval.

Returns:

HTML code for the notification interval input field.

buildResponsibleList

public String buildResponsibleList()

Builds a String with HTML code to display the responsibles of a resource.

Returns:

HTML code for the responsibles of the current resource

getCurrentDateTime

public String getCurrentDateTime()

Returns the current date and time as String formatted in localized pattern.

Returns:

the current date and time as String formatted in localized pattern

getCurrentExpireDate

public String getCurrentExpireDate()

Returns the current expiredate as String formatted in localized pattern.

Returns:

the current expiredate as String formatted in localized pattern

getCurrentReleaseDate

public String getCurrentReleaseDate()

Returns the current releasedate as String formatted in localized pattern.

Returns:

the current releasedate as String formatted in localized pattern

getParamEnablenotification

public String getParamEnablenotification()

Returns the value of the enable_notification parameter.

The enable_notification parameter if content notification is enabled for this resource.

Returns:

the value of the enable_notification parameter

getParamExpiredate

public String getParamExpiredate()

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

Returns:

the value of the new expiredate parameter

getParamLeaveexpire

public String getParamLeaveexpire()

Returns the value of the leaveexpire parameter.

Returns:

the value of the leaveexpire parameter

getParamModifysiblings

public String getParamModifysiblings()

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

Returns:

the value of the modify siblings

getParamNotificationinterval

public String getParamNotificationinterval()

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

Returns:

the value of the notification interval parameter

getParamRecursive

public String getParamRecursive()

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

The recursive parameter on folders decides if all subresources of the folder should be touched, too.

Returns:

the value of the recursive parameter

getParamReleasedate

public String getParamReleasedate()

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

The releasedate parameter stores the new releasedate as String.

Returns:

the value of the new releasedate parameter

getParamResetexpire

public String getParamResetexpire()

Returns the value of the resetexpire parameter.

Returns:

the value of the resetexpire parameter

getParamResetrelease

public String getParamResetrelease()

Returns the value of the resetrelease parameter.

Returns:

the value of the resetrelease parameter

setParamEnablenotification

public void setParamEnablenotification(String value)

Sets the value of the enable notification parameter.

Parameters:

value - the value to set

setParamExpiredate

public void setParamExpiredate(String value)

Sets the value of the expire date.

Parameters:

value - the value to set

setParamLeaveexpire

public void setParamLeaveexpire(String paramLeaveexpire)

Sets the value of the leaveexpire parameter.

Parameters:

paramLeaveexpire - the value of the leaveexpire parameter

setParamModifysiblings

public void setParamModifysiblings(String value)

Sets the value of the modify siblings parameter.

Parameters:

value - the value to set

setParamNotificationinterval

public void setParamNotificationinterval(String value)

Sets the value of the new timestamp parameter.

Parameters:

value - the value to set

setParamRecursive

public void setParamRecursive(String value)

Sets the value of the recursive parameter.

Parameters:

value - the value to set

setParamReleasedate

public void setParamReleasedate(String value)

Sets the value of the releasedate parameter.

Parameters:

value - the value to set

setParamResetexpire

public void setParamResetexpire(String paramResetexpire)

Sets the value of the resetexpire parameter.

Parameters:

paramResetexpire - the value of the resetexpire parameter

setParamResetrelease

public void setParamResetrelease(String paramResetrelease)

Sets the value of the resetrelease parameter.

Parameters:

paramResetrelease - the value of the resetrelease parameter

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 CmsDialog

Parameters:

settings - the workplace settings

request - the current request

See Also:

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

performDialogOperation

protected boolean performDialogOperation()
                                  throws CmsException

Modifies the release and expire date of a resource, and changes the notification interval.

Specified by:

performDialogOperation in class CmsMultiDialog

Returns:

true, if the operation was performed, otherwise false

Throws:

CmsException - if modification is not successful

performSingleResource

protected void performSingleResource(String resName,
                                     long releaseDate,
                                     long expireDate,
                                     boolean leaveRelease,
                                     boolean leaveExpire,
                                     boolean modifyRecursive,
                                     boolean modifySiblings)
                              throws CmsException

Performs the availability and notification operations on a single resource.

Parameters:

resName - the VFS path of the resource

releaseDate - the new release date

expireDate - the new expiration date

leaveRelease - flag indicating if the release date should be left untouched

leaveExpire - flag indicating if the expiration date should be left untouched

modifyRecursive - flag indicating if the operation is recursive for folders

modifySiblings - flag indicating to include resource siblings

Throws:

CmsException - if the availability and notification operations fail

writeProperty

protected void writeProperty(String resourcePath,
                             String propertyName,
                             String propertyValue)
                      throws CmsException

Writes a property value for a resource.

Parameters:

resourcePath - the path of the resource

propertyName - the name of the property

propertyValue - the new value of the property

Throws:

CmsException - if something goes wrong