com.atlassian.confluence.core
Class ConfluenceActionSupport

java.lang.Object
  com.opensymphony.xwork.ActionSupport
      com.atlassian.confluence.core.ConfluenceActionSupport

All Implemented Interfaces:

WebInterface, MessageHolderAware, com.opensymphony.xwork.Action, com.opensymphony.xwork.LocaleProvider, com.opensymphony.xwork.TextProvider, com.opensymphony.xwork.Validateable, com.opensymphony.xwork.ValidationAware, java.io.Serializable

Direct Known Subclasses:

AboutPageAction, AbstractBackupRestoreAction, AbstractCommandAction, AbstractEntityPaginationAction, AbstractGroupAction, AbstractLabelsForEntityAction, AbstractLogoAction, AbstractPageAwareAction, AbstractPermissionsAction, AbstractSetupAction, AbstractSetupEmailAction, AbstractSpaceAction, AbstractTrustedApplicationAction, AbstractUpdateLicenseAction, AbstractUserProfileAction, AbstractUsersAction, AbstractUserStatusJsonResultAction, AbstractViewAction, AbstractViewAttachmentsAction, AddFavouriteAction, AddLabelAction, AddLabelAjaxAction, AddSpaceToFavouriteAjaxAction, AdministrationConsoleAction, AdvancedSearchTipsAction, AjaxLoginCompleteAction, AttachedImagesAction, AttachFileAction, AttachmentNotFoundAction, AttachmentStorageSetupAction, AuthenticateAction, AutocompleteLabelsAction, BreadcrumbAction, BrowseCommentsAction, BrowseMacrosAction, BrowseShortcutsAction, CacheStatisticsAction, ChangeScheduleAction, ClearUserStatusAction, ClusterConfigurationAction, ColorsStylesheetAction, ColourPickerAction, ConfigureCaptchaAction, ConfigureLanguageAction, ConfigureLog4jAction, ConfigureRssFeedAction, ConfirmationAction, ConfirmEmailAction, ContentNameSearchAction, ContentRemigrationAction, CreateRssFeedAction, CustomHtmlAction, CustomStylesheetAction, DailyBackupAdminAction, DashboardAction, DeleteUserStatusAction, DeprecationTestAction, DraftAttachmentSearchAction, DropAuthenticationAction, EditSiteLogoAction, EditStylesheetAction, EncodingTestAction, ExternalUserConnectivityAction, FindRestrictableEntitiesAction, FlushCacheAction, FlushIndexQueueAction, FollowUserAction, ForceUpgradeAction, ForgotUserPasswordAction, FourOhFourAction, GeneralConfigurationAction, GetFutureSchedulesAction, GlobalRssFeedAction, HeartbeatAction, HelpLinkAction, HistoryAction, HomepageAction, ImportConfluenceSpaceAction, IndexAction, JobAction, LikeAction, ListNewOrUpdatedPagesAction, ListWatchersAction, LoadConsoleAction, LogoutAction, LongRunningTaskMonitorAction, MacroDetailsAction, ManageAdminTaskAction, ManagePluginsAction, ManageReferrersAction, MigrateExternalMembershipsAction, MigrateUserPropertyEntriesAction, NetworkFeedAction, NoRequireAnnotationAction, NotificationsAction, OpenSearchDescriptorAction, PageDestinationSearchAction, PageNotFoundAction, PageNotificationAction, PageNotPermittedAction, PageSummaryAction, PeopleDirectoryAction, PluginOsgiExportsAction, PopularContentAction, PurgeReferrersAction, RebuildAncestorTableAction, RefreshLicensingAction, ReindexTaskProgressAction, RemoveFavouriteAction, RemoveLabelAction, RemoveLabelAjaxAction, RemoveMailServerAction, RemoveSpaceFromFavouriteAjaxAction, RequireGetMethodAction, RequirePostMethodAction, ResetUserPasswordAction, ResumeDraftAction, SearchIndexesAction, SearchSiteAction, SecurityConfigurationAction, SendTestEmailAction, SettingsAction, SetupDBOtherAction, SiteDarkFeaturesAction, SiteSupportAction, SpacesConfigurationAction, StartClusterAction, StaticRenderingAction, SuggestLabelsAction, SummaryEmailAdminAction, ThemeColorsStylesheetAction, TinyMceEmotionsAction, TinyUrlAction, UnFollowUserAction, UploadAction, UserMacroAction, UserPopupAction, UserSearchAction, ValidateLabelAjaxAction, VelocityResultAction, ViewGadgetsAdminAction, ViewIndexQueueAction, ViewMailQueueAction, ViewMailServersAction, ViewSpaceDirectoryAction, ViewSystemClasspathAction, ViewSystemInfoAction, ViewUserHistoryAction, WysiwygConverterAction, XsrfTokenExpiredAction

public class ConfluenceActionSupport
extends com.opensymphony.xwork.ActionSupport
implements com.opensymphony.xwork.LocaleProvider, WebInterface, MessageHolderAware

Base class for all Confluence webwork actions. Mainly takes care of managing permissions, and a few other tasks that are common across all actions in the app.

See Also:

Serialized Form

Field Summary

static java.lang.String	CANCEL
static java.lang.String	DEVMODE
protected com.atlassian.event.EventManager	eventManager
protected I18NBeanFactory	i18NBeanFactory
protected LabelManager	labelManager
protected LanguageManager	languageManager
static java.lang.String	LICENSE_EXPIRED
static java.lang.String	LICENSE_USERS_EXCEEDED
protected MessageHolder	messageHolder
protected PermissionManager	permissionManager
protected boolean	permitted
protected com.atlassian.plugin.PluginAccessor	pluginAccessor
static java.lang.String	PREVIEW
protected SettingsManager	settingsManager
protected SpacePermissionManager	spacePermissionManager
protected UserAccessor	userAccessor
protected com.atlassian.plugin.web.WebInterfaceManager	webInterfaceManager

Fields inherited from class com.opensymphony.xwork.ActionSupport

LOG

Fields inherited from interface com.opensymphony.xwork.Action

ERROR, INPUT, LOGIN, NONE, SUCCESS

Constructor Summary

ConfluenceActionSupport()

Method Summary

void	addActionError(java.lang.String textKey, java.lang.Object... args) Adds an error to the current action which will be displayed to the user.
void	addActionMessage(java.lang.String textKey, java.lang.Object... args) Adds a message to the current action which will be displayed to the user.
void	addFieldError(java.lang.String fieldName, java.lang.String textKey, java.lang.Object[] args) Adds an error to the current action which will be displayed next to the specified field.
protected void	addPermissionTypeTo(java.lang.String permissionType, java.util.List<java.lang.String> permissionTypes)
protected void	addToHistory(ContentEntityObject content)
java.lang.String	doDefault() Default webwork action execution method.
java.lang.String	formatFriendlyDate(java.util.Date date)
java.lang.String	getActionName() Returns the internationalised name of the current action.
java.lang.String	getActionName(java.lang.String fullClassName)
ConfluenceUser	getAuthenticatedUser() Return the user from AuthenticatedUserThreadLocal.get().
BootstrapManager	getBootstrapManager()
protected java.lang.String	getCancel() get the value of the cancel parameter
java.lang.String	getCancelResult()
java.util.Map<java.lang.String,java.lang.Object>	getContext()
java.lang.String	getDateFormatSetting()
DateFormatter	getDateFormatter()
java.util.ResourceBundle	getDefaultResourceBundle()
java.lang.String	getDocLink(java.lang.String page) Creates a version specific documentation link for the provided page.
com.atlassian.event.EventManager	getEventManager()
FriendlyDateFormatter	getFriendlyDateFormatter()
Settings	getGlobalSettings()
ThemeHelper	getHelper()
I18NBean	getI18n()
java.util.List<Language>	getInstalledLanguages()
LabelManager	getLabelManager()
LanguageManager	getLanguageManager()
java.lang.String	getLanguageUserFriendly(java.lang.String locale)
java.util.Locale	getLocale()
LocaleManager	getLocaleManager()
java.lang.String	getLocaleString()
MessageHolder	getMessageHolder()
java.lang.String	getNiceContentType(ContentEntityObject entityObject) Deprecated. since 4.2 - use ContentUiSupport directly
protected java.util.List<java.lang.String>	getPermissionTypes()
protected java.util.List	getPermittedEntitiesOf(java.util.Iterator entities, int maxCount)
protected java.util.List	getPermittedEntitiesOf(java.util.Iterator entities, int maxCount, java.util.List criteria)
protected java.util.List	getPermittedEntitiesOf(java.util.List entities)
java.util.Date	getPreviousLoginDate()
com.atlassian.user.User	getRemoteUser() Deprecated. since 5.2. Use getAuthenticatedUser() instead.
java.util.Map	getSession()
SystemInformationService	getSystemInformationService()
java.lang.String	getText(java.lang.String key)
java.lang.String	getText(java.lang.String key, java.util.List list)
java.lang.String	getText(java.lang.String key, java.lang.Object[] args)
java.lang.String	getText(java.lang.String key, java.lang.String defaultValue) This can be used for internationalisation where a non-internationalised default string exists.
static java.lang.String	getTextStatic(java.lang.String key)
static java.lang.String	getTextStatic(java.lang.String key, java.lang.Object[] list)
java.lang.String	getTextStrict(java.lang.String key)
TimeZone	getTimeZone()
com.atlassian.user.User	getUser(java.lang.String username) Deprecated. since 5.2. Use getUserByName(String) instead.
UserAccessor	getUserAccessor()
ConfluenceUser	getUserByName(java.lang.String username) Returns user by name.
java.lang.String	getUserFullName(java.lang.String username)
protected UserInterfaceState	getUserInterfaceState()
java.lang.String	getUserLocaleDefaultDatePattern()
java.lang.String	getUserProfilePicUrl()
WebInterfaceContext	getWebInterfaceContext() Returns a context which can be passed to web items when rendering them.
com.atlassian.plugin.web.WebInterfaceManager	getWebInterfaceManager()
protected boolean	hasPermissionForSpace(java.util.List permissionTypes, Space space)
boolean	isAnonymousUser()
boolean	isCanceled() Has this action been cancelled? Used by CancellingInterceptor to determine if the action should be executed.
boolean	isDevMode() Returns true if the system property confluence.devmode is set and has the value "true".
boolean	isEmailVisible()
boolean	isExternalUserManagementEnabled()
boolean	isLabelable(java.lang.Object object)
boolean	isPermissionCheck()
boolean	isPermitted()
java.lang.String	isPermittedAsString()
boolean	isPrintableVersion()
boolean	isSharedMode() Deprecated. Since 5.1. "Shared mode" no longer supported, always returns false;
boolean	isUserStatusPluginEnabled() Temporary method until we have plugin points to require i18n keys.
boolean	isUsingHSQL() Placing this method in ConfluenceActionSupport is a bit of a hack, but it is suprisingly difficult to have a generic piece of logic that can be used in decorators.
void	setApiDateFormatService(DateFormatService dateFormatService)
void	setBootstrapManager(BootstrapManager bootstrapManager)
void	setCancel(java.lang.String cancel) Set by the "cancel" button on forms.
void	setContentUiSupport(ContentUiSupport contentUiSupport)
void	setEventManager(com.atlassian.event.EventManager eventManager)
void	setFormatSettingsManager(FormatSettingsManager formatSettingsManager)
void	setI18NBean(I18NBean i18NBean)
void	setI18NBeanFactory(I18NBeanFactory i18NBeanFactory)
void	setLabelManager(LabelManager labelManager)
void	setLanguageManager(LanguageManager languageManager)
void	setLocaleManager(LocaleManager localeManager)
void	setLoginManager(LoginManager loginManager)
void	setMessageHolder(MessageHolder messageHolder)
void	setPermissionCheck(boolean permissionCheck)
void	setPermissionManager(PermissionManager permissionManager)
void	setPluginAccessor(com.atlassian.plugin.PluginAccessor pluginAccessor)
void	setPreviousLoginDate(java.util.Date previousLoginDate)
void	setSettingsManager(SettingsManager settingsManager)
void	setSpacePermissionManager(SpacePermissionManager spacePermissionManager)
void	setSystemInformationService(SystemInformationService systemInformationService)
void	setUserAccessor(UserAccessor userAccessor)
void	setWebInterfaceManager(com.atlassian.plugin.web.WebInterfaceManager webInterfaceManager)

Methods inherited from class com.opensymphony.xwork.ActionSupport

addActionError, addActionMessage, addFieldError, execute, getActionErrors, getActionMessages, getErrorMessages, getErrors, getFieldErrors, getText, getTexts, getTexts, hasActionErrors, hasActionMessages, hasErrors, hasFieldErrors, setActionErrors, setActionMessages, setFieldErrors, validate

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.atlassian.confluence.validation.MessageHolderAware

validate

Field Detail

CANCEL

public static final java.lang.String CANCEL

See Also:

Constant Field Values

PREVIEW

public static final java.lang.String PREVIEW

See Also:

Constant Field Values

LICENSE_EXPIRED

public static final java.lang.String LICENSE_EXPIRED

See Also:

Constant Field Values

LICENSE_USERS_EXCEEDED

public static final java.lang.String LICENSE_USERS_EXCEEDED

See Also:

Constant Field Values

DEVMODE

public static final java.lang.String DEVMODE

See Also:

Constant Field Values

userAccessor

protected UserAccessor userAccessor

eventManager

protected com.atlassian.event.EventManager eventManager

spacePermissionManager

protected SpacePermissionManager spacePermissionManager

permissionManager

protected PermissionManager permissionManager

settingsManager

protected SettingsManager settingsManager

labelManager

protected LabelManager labelManager

languageManager

protected LanguageManager languageManager

i18NBeanFactory

protected I18NBeanFactory i18NBeanFactory

messageHolder

protected MessageHolder messageHolder

webInterfaceManager

protected com.atlassian.plugin.web.WebInterfaceManager webInterfaceManager

permitted

protected boolean permitted

pluginAccessor

protected com.atlassian.plugin.PluginAccessor pluginAccessor

Constructor Detail

ConfluenceActionSupport

public ConfluenceActionSupport()

Method Detail

setCancel

public void setCancel(java.lang.String cancel)

Set by the "cancel" button on forms. This tells the CancellingInterceptor that an action should not be executed, and should just return its getCancelResult() result.

Parameters:

cancel - Any non-null, non-empty string value.

isCanceled

public boolean isCanceled()

Has this action been cancelled? Used by CancellingInterceptor to determine if the action should be executed.

See Also:

setCancel(String)

getCancel

protected java.lang.String getCancel()

get the value of the cancel parameter

Returns:

the value of the cancel parameter if the action has been cancelled

doDefault

public java.lang.String doDefault()
                           throws java.lang.Exception

Default webwork action execution method.

Overrides:

doDefault in class com.opensymphony.xwork.ActionSupport

Returns:

the action result

Throws:

java.lang.Exception - if something goes wrong

getText

public java.lang.String getText(java.lang.String key)

Specified by:

getText in interface com.opensymphony.xwork.TextProvider

Overrides:

getText in class com.opensymphony.xwork.ActionSupport

getText

public java.lang.String getText(java.lang.String key,
                                java.lang.String defaultValue)

This can be used for internationalisation where a non-internationalised default string exists. If the key is null or returns a null value, then the default will be used instead.

Note the HtmlSafe annotation on this method. Ensure that you handle the defaultValue appropriately for display.

Specified by:

getText in interface com.opensymphony.xwork.TextProvider

Overrides:

getText in class com.opensymphony.xwork.ActionSupport

getText

public java.lang.String getText(java.lang.String key,
                                java.lang.Object[] args)

getText

public java.lang.String getText(java.lang.String key,
                                java.util.List list)

Specified by:

getText in interface com.opensymphony.xwork.TextProvider

Overrides:

getText in class com.opensymphony.xwork.ActionSupport

getActionName

public java.lang.String getActionName(java.lang.String fullClassName)

getActionName

public java.lang.String getActionName()

Returns the internationalised name of the current action.

Since:

3.1

getTextStrict

public java.lang.String getTextStrict(java.lang.String key)

isPrintableVersion

public boolean isPrintableVersion()

isPermittedAsString

public java.lang.String isPermittedAsString()

isPermitted

public boolean isPermitted()

getPermissionTypes

protected java.util.List<java.lang.String> getPermissionTypes()

isPermissionCheck

public boolean isPermissionCheck()

setPermissionCheck

public void setPermissionCheck(boolean permissionCheck)

getRemoteUser

@Deprecated
public com.atlassian.user.User getRemoteUser()

Deprecated. since 5.2. Use getAuthenticatedUser() instead.

getAuthenticatedUser

public ConfluenceUser getAuthenticatedUser()

Return the user from AuthenticatedUserThreadLocal.get(). This user is usually set by UserThreadLocalFilter for request threads.

Returns:

the remote user

Since:

5.2

getUserByName

public ConfluenceUser getUserByName(java.lang.String username)

Returns user by name. Lookups are cached.

Parameters:

username -

Returns:

user by name

Since:

5.2

getUser

@Deprecated
public com.atlassian.user.User getUser(java.lang.String username)

Deprecated. since 5.2. Use getUserByName(String) instead.

getUserFullName

public java.lang.String getUserFullName(java.lang.String username)

getUserProfilePicUrl

public java.lang.String getUserProfilePicUrl()

Returns:

the download path to the profile picture of the current user

addPermissionTypeTo

protected void addPermissionTypeTo(java.lang.String permissionType,
                                   java.util.List<java.lang.String> permissionTypes)

getPermittedEntitiesOf

protected java.util.List getPermittedEntitiesOf(java.util.List entities)

getPermittedEntitiesOf

protected java.util.List getPermittedEntitiesOf(java.util.Iterator entities,
                                                int maxCount,
                                                java.util.List criteria)

getPermittedEntitiesOf

protected java.util.List getPermittedEntitiesOf(java.util.Iterator entities,
                                                int maxCount)

setPreviousLoginDate

public void setPreviousLoginDate(java.util.Date previousLoginDate)

getPreviousLoginDate

public java.util.Date getPreviousLoginDate()

isExternalUserManagementEnabled

public boolean isExternalUserManagementEnabled()

addToHistory

protected void addToHistory(ContentEntityObject content)

getSession

public java.util.Map getSession()

getUserInterfaceState

protected UserInterfaceState getUserInterfaceState()

isAnonymousUser

public boolean isAnonymousUser()

isDevMode

public boolean isDevMode()

Returns true if the system property confluence.devmode is set and has the value "true".

Returns:

boolean

getCancelResult

public java.lang.String getCancelResult()

getNiceContentType

@Deprecated
public java.lang.String getNiceContentType(ContentEntityObject entityObject)

Deprecated. since 4.2 - use ContentUiSupport directly

getDefaultResourceBundle

public java.util.ResourceBundle getDefaultResourceBundle()

getGlobalSettings

public Settings getGlobalSettings()

isEmailVisible

public boolean isEmailVisible()

isLabelable

public boolean isLabelable(java.lang.Object object)

setSettingsManager

public void setSettingsManager(SettingsManager settingsManager)

hasPermissionForSpace

protected boolean hasPermissionForSpace(java.util.List permissionTypes,
                                        Space space)

getEventManager

public com.atlassian.event.EventManager getEventManager()

setEventManager

public void setEventManager(com.atlassian.event.EventManager eventManager)

setBootstrapManager

public void setBootstrapManager(BootstrapManager bootstrapManager)

getBootstrapManager

public BootstrapManager getBootstrapManager()

setSpacePermissionManager

public void setSpacePermissionManager(SpacePermissionManager spacePermissionManager)

setPermissionManager

public void setPermissionManager(PermissionManager permissionManager)

getWebInterfaceManager

public com.atlassian.plugin.web.WebInterfaceManager getWebInterfaceManager()

setWebInterfaceManager

public void setWebInterfaceManager(com.atlassian.plugin.web.WebInterfaceManager webInterfaceManager)

setLabelManager

public void setLabelManager(LabelManager labelManager)

getLabelManager

public LabelManager getLabelManager()

setLanguageManager

public void setLanguageManager(LanguageManager languageManager)

getLanguageManager

public LanguageManager getLanguageManager()

getHelper

public ThemeHelper getHelper()

getUserAccessor

public UserAccessor getUserAccessor()

setUserAccessor

public void setUserAccessor(UserAccessor userAccessor)

setLoginManager

public void setLoginManager(LoginManager loginManager)

getTextStatic

public static java.lang.String getTextStatic(java.lang.String key)

getTextStatic

public static java.lang.String getTextStatic(java.lang.String key,
                                             java.lang.Object[] list)

getLocale

public java.util.Locale getLocale()

Specified by:

getLocale in interface com.opensymphony.xwork.LocaleProvider

Overrides:

getLocale in class com.opensymphony.xwork.ActionSupport

getLocaleString

public java.lang.String getLocaleString()

getLanguageUserFriendly

public java.lang.String getLanguageUserFriendly(java.lang.String locale)

getUserLocaleDefaultDatePattern

public java.lang.String getUserLocaleDefaultDatePattern()

setApiDateFormatService

public void setApiDateFormatService(DateFormatService dateFormatService)

getInstalledLanguages

public java.util.List<Language> getInstalledLanguages()

addFieldError

public void addFieldError(java.lang.String fieldName,
                          java.lang.String textKey,
                          java.lang.Object[] args)

Adds an error to the current action which will be displayed next to the specified field. HTML-escapes any String arguments to avoid cross-site scripting problems with user input.

Parameters:

fieldName - field to apply error to

textKey - key to internationalised text

args - args to be merged with text via standard MessageFormat rules

addActionError

public void addActionError(java.lang.String textKey,
                           java.lang.Object... args)

Adds an error to the current action which will be displayed to the user. HTML-escapes any String arguments to avoid cross-site scripting problems with user input.

Parameters:

textKey - key to internationalised text

args - args to be merged with text via standard MessageFormat rules

addActionMessage

public void addActionMessage(java.lang.String textKey,
                             java.lang.Object... args)

Adds a message to the current action which will be displayed to the user. HTML-escapes any String arguments to avoid cross-site scripting problems with user input.

Parameters:

textKey - key to internationalised text

args - args to be merged with text via standard MessageFormat rules

getI18n

public I18NBean getI18n()

getDocLink

public java.lang.String getDocLink(java.lang.String page)

Creates a version specific documentation link for the provided page. This method exists because some error messages include links. Otherwise use $docBean which is available on the velocity context.

Parameters:

page - the page to link to (just the title)

Returns:

version specific documentation link.

getSystemInformationService

public SystemInformationService getSystemInformationService()

setSystemInformationService

public void setSystemInformationService(SystemInformationService systemInformationService)

setLocaleManager

public void setLocaleManager(LocaleManager localeManager)

getLocaleManager

public LocaleManager getLocaleManager()

setI18NBeanFactory

public void setI18NBeanFactory(I18NBeanFactory i18NBeanFactory)

setMessageHolder

public void setMessageHolder(MessageHolder messageHolder)

Specified by:

setMessageHolder in interface MessageHolderAware

getMessageHolder

public MessageHolder getMessageHolder()

Specified by:

getMessageHolder in interface MessageHolderAware

getTimeZone

public TimeZone getTimeZone()

getDateFormatter

public DateFormatter getDateFormatter()

getFriendlyDateFormatter

public FriendlyDateFormatter getFriendlyDateFormatter()

getDateFormatSetting

public java.lang.String getDateFormatSetting()

formatFriendlyDate

public java.lang.String formatFriendlyDate(java.util.Date date)

setFormatSettingsManager

public void setFormatSettingsManager(FormatSettingsManager formatSettingsManager)

isUsingHSQL

public boolean isUsingHSQL()

Placing this method in ConfluenceActionSupport is a bit of a hack, but it is suprisingly difficult to have a generic piece of logic that can be used in decorators.

Returns:

true if Confluence is currently using a Hypersonic database

setI18NBean

public void setI18NBean(I18NBean i18NBean)

getWebInterfaceContext

public WebInterfaceContext getWebInterfaceContext()

Description copied from interface: WebInterface

Returns a context which can be passed to web items when rendering them.

Typically, WebWork actions will implement this to provide extra details in the context such as content objects, and so on.

Specified by:

getWebInterfaceContext in interface WebInterface

isSharedMode

public boolean isSharedMode()

Deprecated. Since 5.1. "Shared mode" no longer supported, always returns false;

Returns:

false

isUserStatusPluginEnabled

public boolean isUserStatusPluginEnabled()

Temporary method until we have plugin points to require i18n keys. CONF-15428

Returns:

true if "user status" is enabled.

setPluginAccessor

public void setPluginAccessor(com.atlassian.plugin.PluginAccessor pluginAccessor)

getContext

public java.util.Map<java.lang.String,java.lang.Object> getContext()

setContentUiSupport

public void setContentUiSupport(ContentUiSupport contentUiSupport)