com.atlassian.confluence.pages.actions

Class ViewPageAction

java.lang.Object

com.opensymphony.xwork.ActionSupport

com.atlassian.confluence.core.ConfluenceActionSupport

com.atlassian.confluence.pages.actions.AbstractPageAwareAction

com.atlassian.confluence.pages.actions.AbstractPageAction

com.atlassian.confluence.pages.actions.ViewPageAction

All Implemented Interfaces:

Evented<ConfluenceEvent>, CommentAware, PageAware, TinyUrlAware, WebInterface, MessageHolderAware, com.opensymphony.xwork.Action, com.opensymphony.xwork.LocaleProvider, com.opensymphony.xwork.TextProvider, com.opensymphony.xwork.Validateable, com.opensymphony.xwork.ValidationAware, Serializable

Direct Known Subclasses:

PageInfoAction

public class ViewPageAction
extends AbstractPageAction
implements CommentAware, Evented<ConfluenceEvent>

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
protected CommentManager	commentManager
protected Renderer	editRenderer
protected NotificationManager	notificationManager
protected ReferralManager	referralManager
static String	REQUEST_KEY_HELPER

Fields inherited from class com.atlassian.confluence.pages.actions.AbstractPageAction

incomingLinks, linkManager, pageManager, PREVIEW, RICHTEXT, viewRenderer, wysiwygConverter

Fields inherited from class com.atlassian.confluence.pages.actions.AbstractPageAwareAction

contentPermissionManager, spaceManager

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

accessModeService, CANCEL, DEVMODE, eventManager, i18NBeanFactory, labelManager, languageManager, LICENSE_EXPIRED, LICENSE_USERS_EXCEEDED, messageHolder, permissionManager, permitted, personService, pluginAccessor, 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
ViewPageAction()

Method Summary

Modifier and Type	Method and Description
String	execute()
BlogPostsCalendar	getCalendarForThisMonth()
CaptchaManager	getCaptchaManager()
Boolean	getChildrenShowing()
CollaborativeEditingHelper	getCollaborativeEditingHelper()
Comment	getComment() Gets the currently focused comment.
String	getCommentAsXHtmlForWysiwyg()
String	getDateString(Date date)
String	getEditingUser()
ConfluenceEvent	getEventToPublish(String result) Gets the event to publish.
List	getExternalReferences()
BlogPost	getFirstPostInNextMonth(Calendar postingDate) Returns the first post in the month after the current postingDay
List<ContentPermission>	getInheritedContentPermissions()
BlogPost	getLastPostInPreviousMonth(Calendar postingDate) Returns the last post in the month before the current postingDay
NotificationManager	getNotificationManager()
long	getPageIdOfVersionAfter(AbstractPage page)
long	getPageIdOfVersionBefore(AbstractPage page)
String	getPageXHtmlContent()
Page	getParentPage() Returns the parent Page of the current Page or null if the current AbstractPage is a root page or a blogpost.
long	getReplyToComment()
List<ContentPermission>	getThisPagePermissions()
List	getViewInheritedContentPermissionSets()
WebInterfaceContext	getWebInterfaceContext() Returns a context which can be passed to web items when rendering them.
WebInterfaceContext	getWebInterfaceContext(Comment comment)
Map<Comment,String>	getXHtmlComments()
boolean	hasAnyPermissions() checks if the page has any direct contentpermissions or inherited ones
boolean	hasNextVersion(AbstractPage page)
boolean	hasPreviousVersion(AbstractPage page)
boolean	isChildrenNotShown() Used to hide the page children if we are using the left sidebar.
boolean	isEditComment()
boolean	isLatestVersionRequired() If the action can only work on the most recent version of a page, this will cause the interceptor to silently replace the version that it looks up with the most recent version, if necessary.
boolean	isNavigatingVersions()
boolean	isPageRequired() If the action requires that the page be set before being run, then it should return true to this method.
boolean	isPermitted()
boolean	isShowCommentArea()
boolean	isThreadComments()
boolean	isUserWatchingPage() Returns true if the user is watching the current page.
boolean	isUserWatchingSpace() Returns true if the user is watching the page/blog's space for the respective ContentType.
boolean	isViewPermissionRequired()
protected boolean	pageIsLatestVersionAndDoesNotHaveSpace()
String	renderExternalLink(com.atlassian.renderer.links.Link link)
void	setCaptchaManager(CaptchaManager captchaManager)
void	setCollaborativeEditingHelper(CollaborativeEditingHelper collaborativeEditingHelper)
void	setComment(Comment comment) Sets the currently focused comment.
void	setCommentManager(CommentManager commentManager)
void	setEditComment(boolean editComment)
void	setEditRenderer(Renderer editRenderer)
void	setNavigatingVersions(boolean navigatingVersions)
void	setNotificationManager(NotificationManager notificationManager)
void	setReferralManager(ReferralManager referralManager)
void	setReplyToComment(long replyToComment)
void	setShowChildren(Boolean showChildren)
void	setShowCommentArea(boolean showCommentArea)
void	setThemeManager(ThemeManager themeManager)
void	setXhtmlContent(XhtmlContent xhtmlContent)

Methods inherited from class com.atlassian.confluence.pages.actions.AbstractPageAction

displayDatePath, getAttachmentSourceContent, getAvailableSpaces, getBeanKey, getBlogPost, getEditorVersion, getHelper, getIncomingLinks, getLabels, getMode, getNextPost, getNumberOfAttachmentsAsString, getNumberOfLabelsAsString, getPermissionTypes, getPermittedChildren, getPostingDate, getPostingDay, getPreviousPost, getPreviousVersion, getSpaceManager, getSuggestedLabels, getTinyUrl, hasAttachFilePermissions, hasPermittedChildren, isSpaceAdmin, isSuperUser, isUserWatchingOwnContent, setConfluenceWysiwygConverter, setEditorManager, setLinkManager, setMode, setPageManager, setPostingDate, setViewRenderer

Methods inherited from class com.atlassian.confluence.pages.actions.AbstractPageAwareAction

getFriendlyDateFormatterHelper, getPage, getPageId, getSpace, getSpaceKey, getTitle, isCollaborativeContent, setContentPermissionManager, setPage, setSpaceManager

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

addActionError, addActionMessage, addFieldError, addPermissionTypeTo, addToHistory, doDefault, formatFriendlyDate, getAccessMode, getActionName, getActionName, getAuthenticatedUser, getBootstrapManager, getCancel, getCancelResult, getConfluenceAccessManager, getContext, getCurrentRequest, getCurrentSession, getDateFormatSetting, getDateFormatter, getDefaultResourceBundle, getDefaultTimeZone, getDocLink, getEventManager, getFriendlyDateFormatter, getFrontendServiceURL, getGlobalSettings, getI18n, getInstalledLanguages, getLabelManager, getLanguageJs, getLanguageManager, getLanguageUserFriendly, getLocale, getLocaleManager, getLocaleString, getMessageHolder, getNiceContentType, getPermissionManager, getPermittedEntitiesOf, getPermittedEntitiesOf, getPermittedEntitiesOf, getPersonService, getPreviousLoginDate, getRemoteUser, getSession, getSystemInformationService, getText, getText, getText, getText, getTextStatic, getTextStatic, getTextStrict, getTimeZone, getUserAccessor, getUserByName, getUserFullName, getUserHasBrowseUsersPermission, getUserHasLicensedAccess, getUserInterfaceState, getUserLocaleDefaultDatePattern, getUserProfilePicUrl, getWebInterfaceManager, hasPermissionForSpace, isAnonymousUser, isCanceled, isDevMode, isEmailVisible, isExternalUserManagementEnabled, isLabelable, isPrintableVersion, isSkipAccessCheck, isUserStatusPluginEnabled, isUsingH2, isUsingHSQL, setAccessModeService, setApiDateFormatService, setApiPersonService, setBootstrapManager, setCancel, setConfluenceAccessManager, setContentUiSupport, setEventManager, setFormatSettingsManager, setI18NBean, setI18NBeanFactory, setLabelManager, setLanguageManager, setLocaleManager, setLoginManager, setMessageHolder, setPermissionManager, setPluginAccessor, setPreviousLoginDate, setServletRequestSupplier, setSettingsManager, setSkipAccessCheck, setSpacePermissionManager, setSystemInformationService, setTimeZoneManager, setUserAccessor, setWebInterfaceManager, withServletRequestSupplier

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, 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.pages.actions.PageAware

isEditPermissionRequired

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

validate

Field Detail

REQUEST_KEY_HELPER

public static final String REQUEST_KEY_HELPER

See Also:

Constant Field Values

referralManager

protected ReferralManager referralManager

notificationManager

protected NotificationManager notificationManager

commentManager

protected CommentManager commentManager

editRenderer

protected Renderer editRenderer

Constructor Detail

ViewPageAction

public ViewPageAction()

Method Detail

getComment

public Comment getComment()

Gets the currently focused comment. Might be the comment from a permalink, a comment being replied to, or a comment being edited. Returns null if no comment is active.

Specified by:

getComment in interface CommentAware

Returns:

the comment which is focused

setComment

public void setComment(Comment comment)

Sets the currently focused comment. Might be the comment from a permalink, a comment being replied to, or a comment being edited. Set to null if no comment is active.

Used by the CommentAwareInterceptor.

Specified by:

setComment in interface CommentAware

Parameters:

comment - the comment which is to be focused

setReferralManager

public void setReferralManager(ReferralManager referralManager)

getParentPage

public Page getParentPage()

Returns the parent Page of the current Page or null if the current AbstractPage is a root page or a blogpost.

getExternalReferences

public List getExternalReferences()

isPageRequired

public boolean isPageRequired()

Description copied from interface: PageAware

If the action requires that the page be set before being run, then it should return true to this method. If the action requires a page, but no page is available, then the interceptor will automatically redirect to the 'pagenotfound' result

Specified by:

isPageRequired in interface PageAware

Overrides:

isPageRequired in class AbstractPageAwareAction

Returns:

true if the action requires a page in order to execute

isLatestVersionRequired

public boolean isLatestVersionRequired()

Description copied from interface: PageAware

If the action can only work on the most recent version of a page, this will cause the interceptor to silently replace the version that it looks up with the most recent version, if necessary.

Specified by:

isLatestVersionRequired in interface PageAware

Overrides:

isLatestVersionRequired in class AbstractPageAwareAction

Returns:

true if the action requires the most recent version of a page

isViewPermissionRequired

public boolean isViewPermissionRequired()

Specified by:

isViewPermissionRequired in interface PageAware

Overrides:

isViewPermissionRequired in class AbstractPageAwareAction

Returns:

true if the action requires a check on the view page level permissions on this page

getEditingUser

@Internal
public String getEditingUser()

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

pageIsLatestVersionAndDoesNotHaveSpace

protected boolean pageIsLatestVersionAndDoesNotHaveSpace()

getEventToPublish

public ConfluenceEvent getEventToPublish(String result)

Description copied from interface: Evented

Gets the event to publish.

Specified by:

getEventToPublish in interface Evented<ConfluenceEvent>

Parameters:

result - the result of the action executing.

Returns:

the event. Can be null, in which case no event will be published.

getPageXHtmlContent

public String getPageXHtmlContent()

getXHtmlComments

public Map<Comment,String> getXHtmlComments()

getChildrenShowing

public Boolean getChildrenShowing()

setShowChildren

public void setShowChildren(Boolean showChildren)

getNotificationManager

public NotificationManager getNotificationManager()

setNotificationManager

public void setNotificationManager(NotificationManager notificationManager)

isThreadComments

public boolean isThreadComments()

isUserWatchingPage

public boolean isUserWatchingPage()

Returns true if the user is watching the current page. Returns false otherwise, or if the user is anonymous.

isUserWatchingSpace

public boolean isUserWatchingSpace()

Returns true if the user is watching the page/blog's space for the respective ContentType. For example, if getPage returns a BlogPost and the user is only watching Pages in the Space, this method returns false.

getDateString

public String getDateString(Date date)

renderExternalLink

public String renderExternalLink(com.atlassian.renderer.links.Link link)

getReplyToComment

public long getReplyToComment()

setReplyToComment

public void setReplyToComment(long replyToComment)

getCalendarForThisMonth

public BlogPostsCalendar getCalendarForThisMonth()

getFirstPostInNextMonth

public BlogPost getFirstPostInNextMonth(Calendar postingDate)

Returns the first post in the month after the current postingDay

This method is a duplication of the method in AbstractBlogPostsAction - they really shouldn't be here.

Returns:

BlogPost for the first post in the next month, null otherwise

See Also:

AbstractBlogPostsAction

getLastPostInPreviousMonth

public BlogPost getLastPostInPreviousMonth(Calendar postingDate)

Returns the last post in the month before the current postingDay

This method is a duplication of the method in AbstractBlogPostsAction - they really shouldn't be here.

Returns:

BlogPost for the last post in the previous month, null otherwise

See Also:

AbstractBlogPostsAction

getInheritedContentPermissions

public List<ContentPermission> getInheritedContentPermissions()

getThisPagePermissions

public List<ContentPermission> getThisPagePermissions()

getPageIdOfVersionBefore

public long getPageIdOfVersionBefore(AbstractPage page)

getPageIdOfVersionAfter

public long getPageIdOfVersionAfter(AbstractPage page)

hasPreviousVersion

public boolean hasPreviousVersion(AbstractPage page)

hasNextVersion

public boolean hasNextVersion(AbstractPage page)

isShowCommentArea

public boolean isShowCommentArea()

setShowCommentArea

public void setShowCommentArea(boolean showCommentArea)

isEditComment

public boolean isEditComment()

setEditComment

public void setEditComment(boolean editComment)

isNavigatingVersions

public boolean isNavigatingVersions()

setNavigatingVersions

public void setNavigatingVersions(boolean navigatingVersions)

setCommentManager

public void setCommentManager(CommentManager commentManager)

getCommentAsXHtmlForWysiwyg

public String getCommentAsXHtmlForWysiwyg()

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 AbstractPageAction

getWebInterfaceContext

public WebInterfaceContext getWebInterfaceContext(Comment comment)

getCaptchaManager

public CaptchaManager getCaptchaManager()

setCaptchaManager

public void setCaptchaManager(CaptchaManager captchaManager)

isPermitted

public boolean isPermitted()

Overrides:

isPermitted in class AbstractPageAwareAction

getViewInheritedContentPermissionSets

public List getViewInheritedContentPermissionSets()

hasAnyPermissions

public boolean hasAnyPermissions()

checks if the page has any direct contentpermissions or inherited ones

setEditRenderer

public void setEditRenderer(Renderer editRenderer)

setXhtmlContent

public void setXhtmlContent(XhtmlContent xhtmlContent)

setThemeManager

public void setThemeManager(ThemeManager themeManager)

isChildrenNotShown

public boolean isChildrenNotShown()

Used to hide the page children if we are using the left sidebar. It's necessary to do it like this because a theme may not override page.vmd.

Returns:

true if children are not shown, and false if it's the opposite.

setCollaborativeEditingHelper

@ExperimentalApi
public void setCollaborativeEditingHelper(CollaborativeEditingHelper collaborativeEditingHelper)

getCollaborativeEditingHelper

@ExperimentalApi
public CollaborativeEditingHelper getCollaborativeEditingHelper()