com.atlassian.confluence.plugins.labels.actions

Class ViewLabelAction

java.lang.Object

com.opensymphony.xwork.ActionSupport

com.atlassian.confluence.core.ConfluenceActionSupport

com.atlassian.confluence.spaces.actions.AbstractSpaceAction

com.atlassian.confluence.plugins.labels.actions.AbstractLabelDisplayingAction

com.atlassian.confluence.plugins.labels.actions.ViewLabelAction

All Implemented Interfaces:

WebInterface, SpaceAware, Spaced, MessageHolderAware, com.opensymphony.xwork.Action, com.opensymphony.xwork.LocaleProvider, com.opensymphony.xwork.TextProvider, com.opensymphony.xwork.Validateable, com.opensymphony.xwork.ValidationAware, Serializable

public class ViewLabelAction
extends AbstractLabelDisplayingAction

Action for viewing a label. The label can be specified by either using the labels name(s) or the labels id(s), but not both. The names and ids are the parameters passed in, and used for null-input validation, but are not "maintained" once the labels they point to are retrieved. This means that the names and ids fields have trivial state after retrieveLabels has been called and should not be accessed via getter methods.

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static int	ITEMS_PER_PAGE The default number of content to be displayed on each page.
protected PaginationSupport	paginationSupport Pagination support to assist in the display of the list of content associated with the label.
List	preloadedPage

Fields inherited from class com.atlassian.confluence.plugins.labels.actions.AbstractLabelDisplayingAction

MAX_LABELS

Fields inherited from class com.atlassian.confluence.spaces.actions.AbstractSpaceAction

key, notificationManager, space, spaceManager, themeManager, wikiStyleRenderer

Fields inherited from class com.atlassian.confluence.core.ConfluenceActionSupport

CANCEL, DEVMODE, eventManager, i18NBeanFactory, labelManager, languageManager, LICENSE_EXPIRED, LICENSE_USERS_EXCEEDED, messageHolder, permissionManager, permitted, pluginAccessor, PREVIEW, settingsManager, spacePermissionManager, userAccessor, 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

Constructors

Constructor and Description
ViewLabelAction()

Method Summary

Modifier and Type	Method and Description
String	execute()
DisplayableLabel	getAddLabel(Label label) Returns a DisplayableLabel representing the currently viewed labels and the given label.
List	getContent()
String	getDescription()
FriendlyDateFormatterHelper	getFriendlyDateFormatterHelper()
DisplayableLabel	getLabel() Returns a DisplayableLabel based on all the labels being viewed.
List	getLabels()
List<DisplayableLabel>	getOtherLabels(Labelable content) Returns the first nine global labels on the given content that are not this.label.
PaginationSupport	getPaginationSupport()
String	getPaginationUrl()
List	getPreloadedPage()
List	getRelated()
DisplayableLabel	getRemoveLabel(Label label) Returns a DisplayableLabel representing the currently viewed labels, minus the given label.
WebInterfaceContext	getWebInterfaceContext() Returns a context which can be passed to web items when rendering them.
boolean	isViewPermissionRequired() For viewing individual labels, we don't require view permission on any particular space (actually, this doesn't matter right now - but might in the future!)
void	setDescription(String description)
void	setIds(long[] ids)
void	setSearchManager(SearchManager searchManager)
void	setStartIndex(int startIndex)
void	validate()

Methods inherited from class com.atlassian.confluence.plugins.labels.actions.AbstractLabelDisplayingAction

getPopularLabels, getRecentLabels, isSpaceRequired

Methods inherited from class com.atlassian.confluence.spaces.actions.AbstractSpaceAction

getKey, getPermissionTypes, getSpace, getSpaceKey, getSubscribableName, getThemeManager, hasSpaceIA, isAdminUser, isPermitted, isPersonalSpace, isSuperUser, isUserWatchingSpace, isValidSpaceKey, setKey, setNotificationManager, setSpace, setSpaceManager, setThemeManager, setWikiStyleRenderer

Methods inherited from class com.atlassian.confluence.core.ConfluenceActionSupport

addActionError, addActionMessage, addFieldError, addPermissionTypeTo, addToHistory, doDefault, formatFriendlyDate, getActionName, getActionName, getAuthenticatedUser, getBootstrapManager, getCancel, getCancelResult, getContext, getDateFormatSetting, getDateFormatter, getDefaultResourceBundle, getDefaultTimeZone, getDocLink, getEventManager, getFriendlyDateFormatter, getGlobalSettings, getHelper, getI18n, getInstalledLanguages, getLabelManager, getLanguageManager, getLanguageUserFriendly, getLocale, getLocaleManager, getLocaleString, getMessageHolder, getNiceContentType, getPermittedEntitiesOf, getPermittedEntitiesOf, getPermittedEntitiesOf, getPreviousLoginDate, getRemoteUser, getSession, getSystemInformationService, getText, getText, getText, getText, getTextStatic, getTextStatic, getTextStrict, getTimeZone, getUser, getUserAccessor, getUserByName, getUserFullName, getUserInterfaceState, getUserLocaleDefaultDatePattern, getUserProfilePicUrl, getWebInterfaceManager, hasPermissionForSpace, isAnonymousUser, isCanceled, isDevMode, isEmailVisible, isExternalUserManagementEnabled, isLabelable, isPermissionCheck, isPermittedAsString, isPrintableVersion, isSharedMode, isUserStatusPluginEnabled, isUsingH2, isUsingHSQL, setApiDateFormatService, setBootstrapManager, setCancel, setContentUiSupport, setEventManager, setFormatSettingsManager, setI18NBean, setI18NBeanFactory, setLabelManager, setLanguageManager, setLocaleManager, setLoginManager, setMessageHolder, setPermissionCheck, setPermissionManager, setPluginAccessor, setPreviousLoginDate, setSettingsManager, setSpacePermissionManager, setSystemInformationService, setTimeZoneManager, setUserAccessor, setWebInterfaceManager

Methods inherited from class com.opensymphony.xwork.ActionSupport

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

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.spaces.actions.SpaceAware

setSpace

Methods inherited from interface com.atlassian.confluence.spaces.Spaced

getSpace

Field Detail

ITEMS_PER_PAGE

public static final int ITEMS_PER_PAGE

The default number of content to be displayed on each page.

See Also:

Constant Field Values

paginationSupport

protected PaginationSupport paginationSupport

Pagination support to assist in the display of the list of content associated with the label.

preloadedPage

public List preloadedPage

Constructor Detail

ViewLabelAction

public ViewLabelAction()

Method Detail

setIds

public void setIds(long[] ids)

setStartIndex

public void setStartIndex(int startIndex)

setSearchManager

public void setSearchManager(SearchManager searchManager)

getLabels

public List getLabels()

getContent

public List getContent()

getRelated

public List getRelated()

getPaginationSupport

public PaginationSupport getPaginationSupport()

validate

public void validate()

Specified by:

validate in interface MessageHolderAware

Specified by:

validate in interface com.opensymphony.xwork.Validateable

Overrides:

validate in class com.opensymphony.xwork.ActionSupport

execute

public String execute()
               throws Exception

Specified by:

execute in interface com.opensymphony.xwork.Action

Overrides:

execute in class com.opensymphony.xwork.ActionSupport

Throws:

Exception

isViewPermissionRequired

public boolean isViewPermissionRequired()

For viewing individual labels, we don't require view permission on any particular space (actually, this doesn't matter right now - but might in the future!)

Specified by:

isViewPermissionRequired in interface SpaceAware

Overrides:

isViewPermissionRequired in class AbstractLabelDisplayingAction

Returns:

true if the action requires view space permission

getOtherLabels

public List<DisplayableLabel> getOtherLabels(Labelable content)

Returns the first nine global labels on the given content that are not this.label. It is expected that the view will only display the first eight such labels, and use the ninth as a signal that a "..." is required

Parameters:

content - the content to get labels for

Returns:

a list of Labels with size between 0 and 8 inclusive. Not null.

getPreloadedPage

public List getPreloadedPage()

getLabel

public DisplayableLabel getLabel()

Returns a DisplayableLabel based on all the labels being viewed.

getAddLabel

public DisplayableLabel getAddLabel(Label label)

Returns a DisplayableLabel representing the currently viewed labels and the given label.

For example, if the current viewed labels are "a+b" and the passed label is "c", it returns a DisplayableLabel of "a+b+c"

Sorts the labels by title before returning them, so the order is canonical.

getRemoveLabel

public DisplayableLabel getRemoveLabel(Label label)

Returns a DisplayableLabel representing the currently viewed labels, minus the given label.

For example, if the current viewed labels are "a+b+c" and the passed label is "a", it returns a DisplayableLabel of "b+c"

Sorts the labels by title before returning them, so the order is canonical.

getPaginationUrl

public String getPaginationUrl()

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

Overrides:

getWebInterfaceContext in class ConfluenceActionSupport

getDescription

public String getDescription()

setDescription

public void setDescription(String description)

getFriendlyDateFormatterHelper

public FriendlyDateFormatterHelper getFriendlyDateFormatterHelper()