com.atlassian.confluence.core

Class DefaultContentPermissionManager

java.lang.Object

com.atlassian.confluence.core.DefaultContentPermissionManager

All Implemented Interfaces:

ContentPermissionManager, ContentPermissionManagerInternal, org.springframework.beans.factory.DisposableBean

public class DefaultContentPermissionManager
extends Object
implements ContentPermissionManagerInternal, org.springframework.beans.factory.DisposableBean

Field Summary

Fields

Modifier and Type	Field and Description
protected ContentPermissionDao	contentPermissionDao

Constructor Summary

Constructors

Constructor and Description
DefaultContentPermissionManager()

Method Summary

Modifier and Type	Method and Description
void	addContentPermission(ContentPermission permission, ContentEntityObject content) Adds a new current content permission to the CEO if it doesn't have it already.
void	copyContentPermissions(AbstractPage from, AbstractPage to) Copies all content permissions from one page to another.
void	copyContentPermissions(ContentEntityObject from, ContentEntityObject to) Copies all content permissions from one content entity to another.
void	destroy()
AttachmentManager	getAttachmentManager()
List<ContentPermissionSet>	getContentPermissionSets(ContentEntityObject ceo, String type) Get the ContentPermissionSets that affect this ceo, both inherited and directly.
List<ContentPermissionSet>	getInheritedContentPermissionSets(ContentEntityObject contentEntityObject)
List<ContentPermissionSet>	getInheritedContentPermissionSets(ContentEntityObject contentEntityObject, boolean includeEditPermissions) Get the inherited ContentPermissionSets that affect this ceo.
List<ContentPermission>	getInheritedContentUserPermissions(ContentEntityObject contentEntityObject) Filters the inherited content permission sets of a page for a list of inherited user permissions (of type ContentPermission.VIEW_PERMISSION)
Map<Long,Boolean>	getPermissionSets(com.atlassian.user.User user, Space space) Retrieves the configured permissions regarding whether the specified user can view the pages inside a space.
List<Page>	getPermittedChildren(Page page, com.atlassian.user.User user) Returns a list of Page objects that are direct children of the passed in page.
List<Page>	getPermittedChildrenIgnoreInheritedPermissions(Page page, com.atlassian.user.User user) Gets the list of child pages under the given page that are visible to the given user.
List<Page>	getPermittedPagesIgnoreInheritedPermissions(List<Page> contentList, ConfluenceUser user, String permission) Check permissions for a collection of objects without checking permissions of ancestors and spaces.
Set<ContentPermission>	getViewContentPermissions(Page page) Deprecated. since 5.8. use getContentPermissionSets(ContentEntityObject, String) passing permission type ContentPermission.VIEW_PERMISSION
Map<Long,ValidationResult>	hasContentLevelPermission(ConfluenceUser user, String permissionType, Collection<Long> contentIds) Check permission for a collection of content at once.
boolean	hasContentLevelPermission(com.atlassian.user.User user, String permissionType, ContentEntityObject contentEntityObject) fetches the inherited and explicit content level permissions for this content object and determines whether the user has access.
boolean	hasPermittedChildrenIgnoreInheritedPermissions(Page page, com.atlassian.user.User user) Does the given page have children visible to the given user.
boolean	hasVisibleChildren(Page page, ConfluenceUser user) Returns true if at least one child is visible This method does not check all children, it stops working when the first visible children is found
boolean	isPermissionInherited(Page childPage) Does the child page get its permissions from any ancestor?
void	onContentPermissionEvent(ContentPermissionEvent contentPermissionEvent)
void	removeAllGroupPermissions(String groupName) Remove all content permission associated with a given group.
void	removeAllUserPermissions(ConfluenceUser user) Remove all content permission associated with a given user.
void	removeContentPermission(ContentPermission contentPermission)
void	setChangeIndexer(ChangeIndexer changeIndexer)
void	setContentPermissionDao(ContentPermissionDao contentPermissionDao)
void	setContentPermissions(Collection<ContentPermission> requiredPermissions, ContentEntityObject content, String type) Set the Content Permissions on the CEO to be the list of ContentPermissions passed.
void	setContentPermissions(@NonNull Map<String,Collection<ContentPermission>> requiredPermissionsMap, ContentEntityObject content) Set the Content Permissions on the CEO to be the list of ContentPermissions passed.
void	setContentPermissionSetDao(ContentPermissionSetDao contentPermissionSetDao)
void	setEventListenerRegistrar(com.atlassian.event.api.EventListenerRegistrar eventListenerRegistrar)
void	setEventManager(com.atlassian.event.EventManager eventManager)
void	setIndexer(ConfluenceIndexer indexer)
void	setInheritedContentPermissionManager(InheritedContentPermissionManager inheritedContentPermissionManager)
void	setPageDao(PageDao pageDao)

Methods inherited from class java.lang.Object

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

Field Detail

contentPermissionDao

protected ContentPermissionDao contentPermissionDao

Constructor Detail

DefaultContentPermissionManager

public DefaultContentPermissionManager()

Method Detail

onContentPermissionEvent

@EventListener
public void onContentPermissionEvent(ContentPermissionEvent contentPermissionEvent)

getInheritedContentUserPermissions

public List<ContentPermission> getInheritedContentUserPermissions(ContentEntityObject contentEntityObject)

Filters the inherited content permission sets of a page for a list of inherited user permissions (of type ContentPermission.VIEW_PERMISSION)

Specified by:

getInheritedContentUserPermissions in interface ContentPermissionManager

getInheritedContentPermissionSets

public List<ContentPermissionSet> getInheritedContentPermissionSets(ContentEntityObject contentEntityObject)

Specified by:

getInheritedContentPermissionSets in interface ContentPermissionManager

Returns:

a list of ContentPermissionSets of type ContentPermission.VIEW_PERMISSION of all ancestors of contentEntityObject

getInheritedContentPermissionSets

public List<ContentPermissionSet> getInheritedContentPermissionSets(ContentEntityObject contentEntityObject,
                                                                    boolean includeEditPermissions)

Description copied from interface: ContentPermissionManager

Get the inherited ContentPermissionSets that affect this ceo. Note that EDIT Permissions are not currently inherited, however edit permissions are treated as view permissions when considering inheritance, unless the boolean 'includeEditPermissions' is set to false.

Specified by:

getInheritedContentPermissionSets in interface ContentPermissionManager

Parameters:

contentEntityObject - whose permissions will be returned. Not null.

includeEditPermissions - which specifies whether or not edit permissions should be additionally treated as view permissions.

Returns:

a list of ContentPermissionSets. Not null, but can be empty.

getContentPermissionSets

public List<ContentPermissionSet> getContentPermissionSets(ContentEntityObject ceo,
                                                           String type)

Description copied from interface: ContentPermissionManager

Get the ContentPermissionSets that affect this ceo, both inherited and directly. Note that EDIT Permissions are not currently inherited, so calling this method with EDIT will return only the direct ContentPermissionSet.

Specified by:

getContentPermissionSets in interface ContentPermissionManager

Parameters:

ceo - whose permissions will be returned. Not null.

type - one of ContentPermission.VIEW_PERMISSION or ContentPermission.EDIT_PERMISSION

Returns:

a list of ContentPermissionSets. Not null, but can be empty.

hasContentLevelPermission

public boolean hasContentLevelPermission(com.atlassian.user.User user,
                                         String permissionType,
                                         ContentEntityObject contentEntityObject)

Description copied from interface: ContentPermissionManager

fetches the inherited and explicit content level permissions for this content object and determines whether the user has access.

Specified by:

hasContentLevelPermission in interface ContentPermissionManager

permissionType - ContentPermission.VIEW_PERMISSION or ContentPermission.EDIT_PERMISSION

Returns:

true if the user has the specified type of permission on the given content

removeContentPermission

public void removeContentPermission(ContentPermission contentPermission)

Specified by:

removeContentPermission in interface ContentPermissionManager

removeAllGroupPermissions

public void removeAllGroupPermissions(String groupName)

Description copied from interface: ContentPermissionManager

Remove all content permission associated with a given group.

Specified by:

removeAllGroupPermissions in interface ContentPermissionManager

removeAllUserPermissions

public void removeAllUserPermissions(ConfluenceUser user)

Description copied from interface: ContentPermissionManager

Remove all content permission associated with a given user.

Specified by:

removeAllUserPermissions in interface ContentPermissionManager

addContentPermission

public void addContentPermission(ContentPermission permission,
                                 ContentEntityObject content)

Adds a new current content permission to the CEO if it doesn't have it already.

Specified by:

addContentPermission in interface ContentPermissionManager

Throws:

IllegalArgumentException - if content object does not correspond to the latest version of the content. Permissions can only be added to the latest version of a ContentEntityObject.

setContentPermissions

public void setContentPermissions(@NonNull Map<String,Collection<ContentPermission>> requiredPermissionsMap,
                                  ContentEntityObject content)

Description copied from interface: ContentPermissionManager

Set the Content Permissions on the CEO to be the list of ContentPermissions passed. Passing an empty list removes all permissions. Passing a list containing just the existing permissions does nothing. It is recommended to use this method for setting different types of content permissions in a batch, because it performs more smart and performant caching updates than ContentPermissionManager.setContentPermissions(java.util.Collection, ContentEntityObject, String) does

Specified by:

setContentPermissions in interface ContentPermissionManager

Parameters:

requiredPermissionsMap - - map of ContentPermissions for each type

setContentPermissions

public void setContentPermissions(Collection<ContentPermission> requiredPermissions,
                                  ContentEntityObject content,
                                  String type)

Description copied from interface: ContentPermissionManager

Set the Content Permissions on the CEO to be the list of ContentPermissions passed. Passing an empty list removes all permissions. Passing a list containing just the existing permissions does nothing.

Specified by:

setContentPermissions in interface ContentPermissionManager

Parameters:

requiredPermissions - set of ContentPermissions

getPermittedChildren

public List<Page> getPermittedChildren(Page page,
                                       com.atlassian.user.User user)

Returns a list of Page objects that are direct children of the passed in page. This method will only return the children the passed in user has permission to view.

Specified by:

getPermittedChildren in interface ContentPermissionManager

getPermittedChildrenIgnoreInheritedPermissions

public List<Page> getPermittedChildrenIgnoreInheritedPermissions(Page page,
                                                                 com.atlassian.user.User user)

Description copied from interface: ContentPermissionManager

Gets the list of child pages under the given page that are visible to the given user. This method assumes that the given page is already visible to the given user and does not check the inherited permissions.

Specified by:

getPermittedChildrenIgnoreInheritedPermissions in interface ContentPermissionManager

hasPermittedChildrenIgnoreInheritedPermissions

public boolean hasPermittedChildrenIgnoreInheritedPermissions(Page page,
                                                              com.atlassian.user.User user)

Description copied from interface: ContentPermissionManager

Does the given page have children visible to the given user. This method assumes that the given page is already visible to the given user and does not check the inherited permissions.

Specified by:

hasPermittedChildrenIgnoreInheritedPermissions in interface ContentPermissionManager

getViewContentPermissions

@Deprecated
public Set<ContentPermission> getViewContentPermissions(Page page)

Deprecated. since 5.8. use getContentPermissionSets(ContentEntityObject, String) passing permission type ContentPermission.VIEW_PERMISSION

Get view permissions on this page and its ancestors.

Specified by:

getViewContentPermissions in interface ContentPermissionManager

Returns:

a list of ContentPermission instances

setContentPermissionDao

public void setContentPermissionDao(ContentPermissionDao contentPermissionDao)

setPageDao

public void setPageDao(PageDao pageDao)

setContentPermissionSetDao

public void setContentPermissionSetDao(ContentPermissionSetDao contentPermissionSetDao)

setIndexer

public void setIndexer(ConfluenceIndexer indexer)

setEventManager

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

setInheritedContentPermissionManager

public void setInheritedContentPermissionManager(InheritedContentPermissionManager inheritedContentPermissionManager)

setChangeIndexer

public void setChangeIndexer(ChangeIndexer changeIndexer)

setEventListenerRegistrar

public void setEventListenerRegistrar(com.atlassian.event.api.EventListenerRegistrar eventListenerRegistrar)

destroy

public void destroy()
             throws Exception

Specified by:

destroy in interface org.springframework.beans.factory.DisposableBean

Throws:

Exception

getAttachmentManager

public AttachmentManager getAttachmentManager()

isPermissionInherited

public boolean isPermissionInherited(Page childPage)

Description copied from interface: ContentPermissionManager

Does the child page get its permissions from any ancestor?

Specified by:

isPermissionInherited in interface ContentPermissionManager

Returns:

boolean True if the child page does not have a view permission set, and an ancestor does.

copyContentPermissions

public void copyContentPermissions(AbstractPage from,
                                   AbstractPage to)

Description copied from interface: ContentPermissionManager

Copies all content permissions from one page to another.

Specified by:

copyContentPermissions in interface ContentPermissionManager

copyContentPermissions

public void copyContentPermissions(ContentEntityObject from,
                                   ContentEntityObject to)

Description copied from interface: ContentPermissionManager

Copies all content permissions from one content entity to another.

Specified by:

copyContentPermissions in interface ContentPermissionManager

getPermissionSets

public Map<Long,Boolean> getPermissionSets(com.atlassian.user.User user,
                                           Space space)

Description copied from interface: ContentPermissionManager

Retrieves the configured permissions regarding whether the specified user can view the pages inside a space. If a page is not configured in the tables - CONTENT_PERM_SET and CONTENT_PERM, then the permission of that page will not be included here. Note: the permission returned here does not consider the inherited permission from parent page.

Specified by:

getPermissionSets in interface ContentPermissionManager

Parameters:

user - - confluence user to be checked

space - - confluence space

Returns:

a Map where the key is the page id and the value indicates the view permission.

hasContentLevelPermission

public Map<Long,ValidationResult> hasContentLevelPermission(ConfluenceUser user,
                                                            String permissionType,
                                                            Collection<Long> contentIds)

Description copied from interface: ContentPermissionManagerInternal

Check permission for a collection of content at once.

• if contentIds belong to same page hierarchy then it will base on the permission set of that hierarchy to check permisssion for all hierarchy => Best performance
• if contentIds does not belong to same page hierarchy then it will load page list (at once) and call permission check for each page => better performance

Specified by:

hasContentLevelPermission in interface ContentPermissionManagerInternal

permissionType - string needs to be one of the permission constants in ContentPermission

Returns:

a map of validation result

getPermittedPagesIgnoreInheritedPermissions

public List<Page> getPermittedPagesIgnoreInheritedPermissions(List<Page> contentList,
                                                              ConfluenceUser user,
                                                              String permission)

Check permissions for a collection of objects without checking permissions of ancestors and spaces.

Specified by:

getPermittedPagesIgnoreInheritedPermissions in interface ContentPermissionManagerInternal

Returns:

a list of permitted objects

hasVisibleChildren

public boolean hasVisibleChildren(Page page,
                                  ConfluenceUser user)

Returns true if at least one child is visible This method does not check all children, it stops working when the first visible children is found

Specified by:

hasVisibleChildren in interface ContentPermissionManagerInternal

Returns:

false if 0 children visible, true of at least one child is visible