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:

CommentAware, PageAware, TinyUrlAware, WebInterface, Action, LocaleProvider, TextProvider, Validateable, ValidationAware, Serializable

Direct Known Subclasses:

PageInfoAction

public class ViewPageAction
extends AbstractPageAction
implements CommentAware

See Also:

Serialized Form

Field Summary

protected CommentManager	commentManager
static int	HOT_REFERRERS_COUNT
protected NotificationManager	notificationManager
protected ReferralManager	referralManager
protected WikiStyleRenderer	wikiStyleRenderer

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

incomingLinks, isXHtml, linkManager, MARKUP, pageManager, PREVIEW, RICHTEXT, 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)
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	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()
long	getPageIdOfVersionAfter(AbstractPage page)
long	getPageIdOfVersionBefore(AbstractPage page)
String	getPageXHtmlContent()
List	getPossibleAlternativesElsewhere()
List	getPossibleAlternativesInSpace() If the page doesn't exist, we look for pages that it may have been renamed to.
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.
ConfluenceTrackbackUtils	getTrackbackUtils()
List	getViewInheritedContentPermissionSets()
WebInterfaceContext	getWebInterfaceContext() Returns a context which can be passed to web items when rendering them.
WebInterfaceContext	getWebInterfaceContext(Comment comment)
Map	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 ContentEntityObject.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()
boolean	isViewPermissionRequired()
String	renderExternalLink(Link link)
String	renderLink(String link)
void	setCaptchaManager(CaptchaManager captchaManager)
void	setComment(Comment comment) Sets the currently focused comment.
void	setCommentManager(CommentManager commentManager)
void	setEditComment(boolean editComment)
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)
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(WikiStyleRenderer wikiStyleRenderer)

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

displayDatePath, generateAncestryBreadcrumbs, getAvailableSpaces, getBeanKey, getBlogPost, getEditor, getEditorVersion, getHelper, getIncomingLinks, getMARKUP, getMode, getNextPost, getPermissionTypes, getPermittedChildren, getPostingDate, getPostingDay, getPostingDayOfMonth, getPostingMonth, getPostingMonthNumeric, getPostingYear, getPREVIEW, getPreviousPost, getPreviousVersion, getRICHTEXT, getShowMarkup, getSpaceManager, getSuggestedLabels, getSupportWysiwyg, getTinyUrl, getUseWysiwyg, getXhtml, hasAttachFilePermissions, hasPermittedChildren, hasSetPagePermissionsPermission, isSpaceAdmin, setBreadcrumbsManager, setConfluenceWysiwygConverter, setEditorManager, setLinkManager, setMode, setPageManager, setPostingDate, setXhtml

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, getBootstrapManager, getCancelResult, getDateFormatter, getDefaultResourceBundle, getEventManager, getFriendlyDateFormatter, getGlobalHelper, getGlobalSettings, getI18n, getInstalledLanguages, getLabelManager, getLanguageManager, getLanguageUserFriendly, getLocale, getLocaleManager, getLocaleString, getNiceContentType, getPermittedEntitiesOf, getPermittedEntitiesOf, getPermittedEntitiesOf, getPreviousLoginDate, getRandom, getRemoteUser, getSession, getSpaceHelper, 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, setEventManager, setFormatSettingsManager, setI18NBean, setI18NBeanFactory, setLabelManager, setLanguageManager, setLocaleManager, setPermissionCheck, setPermissionManager, setPluginAccessor, setPreviousLoginDate, setSettingsManager, setSpacePermissionManager, 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

wikiStyleRenderer

protected WikiStyleRenderer wikiStyleRenderer

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

public void setWikiStyleRenderer(WikiStyleRenderer wikiStyleRenderer)

setReferralManager

public void setReferralManager(ReferralManager referralManager)

setPageContent

public void setPageContent(String pageContent)

getPageContent

public String getPageContent()

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 Action

Overrides:

execute in class ActionSupport

Throws:

Exception

getPageXHtmlContent

public String getPageXHtmlContent()

getXHtmlComments

public Map 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

public List getPossibleAlternativesInSpace()

If the page doesn't exist, we look for pages that it may have been renamed to.

getPossibleAlternativesElsewhere

public List getPossibleAlternativesElsewhere()

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

getTrackbackUtils

public ConfluenceTrackbackUtils getTrackbackUtils()

getDateString

public String getDateString(Date date)

isAttachmentsInWebDavFolder

public boolean isAttachmentsInWebDavFolder()

getAttachmentsWebDavUrl

public String getAttachmentsWebDavUrl()

getAttachmentsWebDavUrlForPage

public String getAttachmentsWebDavUrlForPage()

renderLink

public String renderLink(String link)

renderExternalLink

public String renderExternalLink(Link link)

getReplyToComment

public long getReplyToComment()

setReplyToComment

public void setReplyToComment(long replyToComment)

getRootComment

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

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

public void setFocusedCommentId(long focusedCommentId)

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

getFocusedCommentId

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

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

public boolean isFavouritePage()

Deprecated. since 2.8 use ContentEntityObject.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