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

protected CommentManager	commentManager
protected Renderer	editRenderer
static int	HOT_REFERRERS_COUNT
protected NotificationManager	notificationManager
protected ReferralManager	referralManager

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

CANCEL, DEVMODE, eventManager, i18NBeanFactory, labelManager, languageManager, LICENSE_EXPIRED, LICENSE_USERS_EXCEEDED, permissionManager, permitted, 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

ViewPageAction()

Method Summary

String	execute()
String	getAttachmentsWebDavUrl()
String	getAttachmentsWebDavUrlForPage()
BlogPostsCalendar	getCalendarForThisMonth()
CaptchaManager	getCaptchaManager()
Boolean	getChildrenShowing()
Comment	getComment() Gets the currently focused comment.
String	getCommentAsXHtmlForWysiwyg()
Boolean	getCommentsShowing()
String	getDateString(Date date)
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 This method is a duplication of the method in AbstractBlogPostsAction - they really shouldn't be here.
long	getFocusedCommentId() Deprecated. since 2.8 use 'commentId' parameter from the web or getComment() from the application.
List<ReferralLink>	getHotReferrers() Return a list of ReferralLinks that point to this page.
List<ContentPermission>	getInheritedContentPermissions()
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.
NotificationManager	getNotificationManager()
String	getPageContent() Deprecated. since 4.0. This is not used anywhere.
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.
List	getPossibleAlternativesElsewhere() Deprecated. since 3.1 This action no longer uses possible alternatives so this method can be deleted. See PageNotFoundAction
List	getPossibleAlternativesInSpace() Deprecated. since 3.1 This action no longer uses possible alternatives so this method can be deleted. See PageNotFoundAction
long	getReplyToComment()
Comment	getRootComment() Deprecated. since 2.8 the default theme no longer uses a "root comment". This method will remain until the other themes do the same.
List<ContentPermission>	getThisPagePermissions()
ConfluenceTrackbackUtils	getTrackbackUtils()
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	isAttachmentsInWebDavFolder()
boolean	isEditComment()
boolean	isFavouritePage() Deprecated. since 2.8 use AbstractLabelableEntityObject.isFavourite(User).
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()
String	renderExternalLink(com.atlassian.renderer.links.Link link)
String	renderLink(String link) Deprecated. Since 4.0. See PageInfoAction.renderWikiLink(String) instead.
void	setCaptchaManager(CaptchaManager captchaManager)
void	setComment(Comment comment) Sets the currently focused comment.
void	setCommentManager(CommentManager commentManager)
void	setEditComment(boolean editComment)
void	setEditRenderer(Renderer editRenderer)
void	setFocusedCommentId(long focusedCommentId) Deprecated. since 2.8 use 'commentId' parameter from the web or setComment(Comment) from the application.
void	setNavigatingVersions(boolean navigatingVersions)
void	setNotificationManager(NotificationManager notificationManager)
void	setPageContent(String pageContent) Deprecated. since 4.0. This is not used anywhere.
void	setReferralManager(ReferralManager referralManager)
void	setReplyToComment(long replyToComment)
void	setRootCommentId(long rootCommentId) Deprecated. since 2.8 the default theme no longer uses a "root comment". This method will remain until the other themes do the same.
void	setShowChildren(Boolean showChildren)
void	setShowCommentArea(boolean showCommentArea)
void	setShowComments(Boolean showComments)
void	setWikiStyleRenderer(com.atlassian.renderer.WikiStyleRenderer wikiStyleRenderer) Deprecated. Since 4.0. See PageInfoAction.renderWikiLink(String) instead.
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, 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

getPage, getPageId, getSpace, getSpaceKey, getTitle, hasViewPagePermission, setContentPermissionManager, setPage, setSpaceManager

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

addActionError, addFieldError, addPermissionTypeTo, addToHistory, doDefault, formatFriendlyDate, getActionName, getActionName, getBootstrapManager, getCancelResult, getContext, getDateFormatSetting, getDateFormatter, getDefaultResourceBundle, getDocLink, getEventManager, getFriendlyDateFormatter, getGlobalSettings, getI18n, getInstalledLanguages, getLabelManager, getLanguageManager, getLanguageUserFriendly, getLocale, getLocaleManager, getLocaleString, getNiceContentType, getPermittedEntitiesOf, getPermittedEntitiesOf, getPermittedEntitiesOf, getPreviousLoginDate, getRandom, getRemoteUser, getSession, getSystemInformationService, getText, getText, getText, getText, getTextStatic, getTextStatic, getTextStrict, getTimeZone, getUser, getUserAccessor, getUserFullName, getUserInterfaceState, getWebInterfaceManager, hasPermissionForSpace, isAnonymousUser, isCanceled, isDevMode, isEmailVisible, isExternalUserManagementEnabled, isLabelable, isPermissionCheck, isPermittedAsString, isPrintableVersion, isSharedMode, isUserStatusPluginEnabled, isUsingHSQL, setBootstrapManager, setCancel, setContentUiSupport, setEventManager, setFormatSettingsManager, setI18NBean, setI18NBeanFactory, setLabelManager, setLanguageManager, setLocaleManager, setLoginManager, setPermissionCheck, setPermissionManager, setPluginAccessor, setPreviousLoginDate, setSettingsManager, setSpacePermissionManager, setSystemInformationService, 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, validate

Methods inherited from class java.lang.Object

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

Field Detail

HOT_REFERRERS_COUNT

public static final int HOT_REFERRERS_COUNT

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

setWikiStyleRenderer

@Deprecated
public void setWikiStyleRenderer(com.atlassian.renderer.WikiStyleRenderer wikiStyleRenderer)

Deprecated. Since 4.0. See PageInfoAction.renderWikiLink(String) instead.

setReferralManager

public void setReferralManager(ReferralManager referralManager)

setPageContent

@Deprecated
public void setPageContent(String pageContent)

Deprecated. since 4.0. This is not used anywhere.

getPageContent

@Deprecated
public String getPageContent()

Deprecated. since 4.0. This is not used anywhere.

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.

getHotReferrers

public List<ReferralLink> getHotReferrers()

Return a list of ReferralLinks that point to this page.

Returns:

a list of ReferralLinks, empty if referrers are disabled.

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

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

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()

getCommentsShowing

public Boolean getCommentsShowing()

setShowComments

public void setShowComments(Boolean showComments)

getChildrenShowing

public Boolean getChildrenShowing()

setShowChildren

public void setShowChildren(Boolean showChildren)

getNotificationManager

public NotificationManager getNotificationManager()

setNotificationManager

public void setNotificationManager(NotificationManager notificationManager)

isThreadComments

public boolean isThreadComments()

getPossibleAlternativesInSpace

@Deprecated
public List getPossibleAlternativesInSpace()

Deprecated. since 3.1 This action no longer uses possible alternatives so this method can be deleted. See PageNotFoundAction

getPossibleAlternativesElsewhere

@Deprecated
public List getPossibleAlternativesElsewhere()

Deprecated. since 3.1 This action no longer uses possible alternatives so this method can be deleted. See PageNotFoundAction

isUserWatchingPage

public boolean isUserWatchingPage()

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

See Also:

NotificationManager.getNotificationByUserAndPage(User, AbstractPage)

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.

getTrackbackUtils

public ConfluenceTrackbackUtils getTrackbackUtils()

getDateString

public String getDateString(Date date)

isAttachmentsInWebDavFolder

public boolean isAttachmentsInWebDavFolder()

getAttachmentsWebDavUrl

public String getAttachmentsWebDavUrl()

getAttachmentsWebDavUrlForPage

public String getAttachmentsWebDavUrlForPage()

renderLink

@Deprecated
public String renderLink(String link)

Deprecated. Since 4.0. See PageInfoAction.renderWikiLink(String) instead.

Parameters:

link -

Returns:

renderExternalLink

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

getReplyToComment

public long getReplyToComment()

setReplyToComment

public void setReplyToComment(long replyToComment)

getRootComment

@Deprecated
public Comment getRootComment()

Deprecated. since 2.8 the default theme no longer uses a "root comment". This method will remain until the other themes do the same.

When you have a comment thread that is too deep to display all at once, only a portion of it is displayed. To see the rest of the thread you can specify the rootCommentId of a comment in the middle of the thread to start rendering from

setRootCommentId

@Deprecated
public void setRootCommentId(long rootCommentId)

Deprecated. since 2.8 the default theme no longer uses a "root comment". This method will remain until the other themes do the same.

setFocusedCommentId

@Deprecated
public void setFocusedCommentId(long focusedCommentId)

Deprecated. since 2.8 use 'commentId' parameter from the web or setComment(Comment) from the application.

getFocusedCommentId

@Deprecated
public long getFocusedCommentId()

Deprecated. since 2.8 use 'commentId' parameter from the web or getComment() from the application.

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)

isFavouritePage

@Deprecated
public boolean isFavouritePage()

Deprecated. since 2.8 use AbstractLabelableEntityObject.isFavourite(User).

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)