com.atlassian.confluence.security

Interface SpacePermissionManager

All Superinterfaces:

SpacePermissionSaver

All Known Subinterfaces:

SpacePermissionManagerInternal

All Known Implementing Classes:

AbstractSpacePermissionManager, CachingSpacePermissionManager, CoarseGrainedCachingSpacePermissionManager, DefaultSpacePermissionManager, ReadOnlySpacePermissionManager, SpacePermissionCoordinator

@ParametersAreNonnullByDefault
public interface SpacePermissionManager
extends SpacePermissionSaver

Responsible for the addition, modification and removal of space permissions. This interface is not for checking whether a user has permission to do something; for that see PermissionManager.

See Also:

PermissionManager

Method Summary

Modifier and Type	Method and Description
void	createDefaultSpacePermissions(Space space)
void	createInitialSpacePermissions(Space space) Deprecated. Use createDefaultSpacePermissions(com.atlassian.confluence.spaces.Space) or createPrivateSpacePermissions(com.atlassian.confluence.spaces.Space) instead. Since v4.2.6.
void	createPrivateSpacePermissions(Space space)
void	flushCaches()
List<SpacePermission>	getAllPermissionsForGroup(String group)
Set<SpacePermission>	getDefaultGlobalPermissions() Returns the default global permissions that are created when Confluence is set up.
List<SpacePermission>	getGlobalPermissions()
List<SpacePermission>	getGlobalPermissions(String permissionType)
Map<String,Long>	getGroupsForPermissionType(String permissionType, Space space)
Collection<com.atlassian.user.Group>	getGroupsWithPermissions(Space space) Returns all groups which have permissions in a space or on a global level.
Map<String,Long>	getUsersForPermissionType(String permissionType, Space space)
Collection<com.atlassian.user.User>	getUsersWithPermissions(Space space) Returns a collection of user objects with VIEWSPACE_PERMISSION in the space.
boolean	groupHasPermission(String permissionType, Space space, String group) Checks whether the given group has the given permission
boolean	hasAllPermissions(List<String> permissionTypes, Space space, com.atlassian.user.User user) Determines if remoteUser has all of the given permissions in space
boolean	hasPermission(List permissionTypes, Space space, com.atlassian.user.User remoteUser) Deprecated. Since 5.0. Use hasAllPermissions(java.util.List, com.atlassian.confluence.spaces.Space, com.atlassian.user.User)
boolean	hasPermission(String permissionType, Space space, com.atlassian.user.User remoteUser) Determines if remoteUser has the given permission in space
boolean	hasPermissionForSpace(com.atlassian.user.User user, List permissionTypes, Space space)
boolean	hasPermissionNoExemptions(String permissionType, Space space, com.atlassian.user.User remoteUser) Returns true if the user has the specified permission on the target space.
boolean	permissionExists(SpacePermission permission) Check whether the given SpacePermission exists.
void	removeAllPermissions(Space space) Deprecated. since 5.9. Use SpacePermissionManagerInternal.removeAllPermissions(com.atlassian.confluence.spaces.Space, com.atlassian.confluence.internal.security.SpacePermissionContext) instead.
void	removeAllPermissionsForGroup(String group) Deprecated. since 5.8. Use SpacePermissionManagerInternal.removeAllPermissionsForGroup(String, com.atlassian.confluence.internal.security.SpacePermissionContext) instead.
void	removeAllUserPermissions(ConfluenceUser user) Deprecated. since 5.9. Use SpacePermissionManagerInternal.removeAllUserPermissions(com.atlassian.confluence.user.ConfluenceUser, com.atlassian.confluence.internal.security.SpacePermissionContext) instead.
void	removeAllUserPermissions(String username) Deprecated. since 5.3. Use SpacePermissionManagerInternal.removeAllUserPermissions(com.atlassian.confluence.user.ConfluenceUser, com.atlassian.confluence.internal.security.SpacePermissionContext) instead.
void	removeGlobalPermissionForUser(ConfluenceUser user, String permissionType) Deprecated. since 5.9. Use SpacePermissionManagerInternal.removeGlobalPermissionForUser(com.atlassian.confluence.user.ConfluenceUser, String, com.atlassian.confluence.internal.security.SpacePermissionContext) instead.
void	removePermission(SpacePermission permission) Deprecated. since 5.9. Use SpacePermissionManagerInternal.removePermission(SpacePermission, com.atlassian.confluence.internal.security.SpacePermissionContext) instead.

Methods inherited from interface com.atlassian.confluence.security.SpacePermissionSaver

savePermission

Method Detail

removeAllPermissions

@Deprecated
void removeAllPermissions(Space space)

Deprecated. since 5.9. Use SpacePermissionManagerInternal.removeAllPermissions(com.atlassian.confluence.spaces.Space, com.atlassian.confluence.internal.security.SpacePermissionContext) instead.

Removes all permissions belonging to space

Parameters:

space - The space to remove the permissions for

removePermission

@Deprecated
void removePermission(SpacePermission permission)

Deprecated. since 5.9. Use SpacePermissionManagerInternal.removePermission(SpacePermission, com.atlassian.confluence.internal.security.SpacePermissionContext) instead.

Removes the given permission, and generates a SpacePermissionRemoveEvent in the process.

Parameters:

permission - the permission to remove

hasPermission

boolean hasPermission(String permissionType,
                      @Nullable
                      Space space,
                      @Nullable
                      com.atlassian.user.User remoteUser)

Determines if remoteUser has the given permission in space

Unless you're writing code that is part of the permission checking implementation, or you're changing space permissions, you should be using PermissionManager instead.

Parameters:

permissionType - The permission type to look up

space - The space the permission applies to (can be null for global permissions)

remoteUser - The user to look up (can be null for the anonymous user)

Returns:

true if remoteUser has the permission, false otherwise

hasPermissionNoExemptions

boolean hasPermissionNoExemptions(String permissionType,
                                  @Nullable
                                  Space space,
                                  @Nullable
                                  com.atlassian.user.User remoteUser)

Returns true if the user has the specified permission on the target space. This method does not allow exemptions for super-users like hasPermission(String, Space, User) does.

For parameter and return value information, see hasPermission(String, Space, User).

hasPermission

@Deprecated
boolean hasPermission(List permissionTypes,
                                  @Nullable
                                  Space space,
                                  @Nullable
                                  com.atlassian.user.User remoteUser)

Deprecated. Since 5.0. Use hasAllPermissions(java.util.List, com.atlassian.confluence.spaces.Space, com.atlassian.user.User)

Determines if remoteUser has the given permissions in space

If remoteUser lacks any of the given permissions, false is returned.

Unless you're writing code that is part of the permission checking implementation, or you're changing space permissions, you should be using PermissionManager instead.

Parameters:

permissionTypes - A List of permission types (see SpacePermission) to check

space - The space the permissions apply to

remoteUser - The user to look up

Returns:

true if remoteUser has the permission, false otherwise

hasAllPermissions

boolean hasAllPermissions(List<String> permissionTypes,
                          @Nullable
                          Space space,
                          @Nullable
                          com.atlassian.user.User user)

Determines if remoteUser has all of the given permissions in space

If remoteUser lacks any of the given permissions, false is returned.

Unless you're writing code that is part of the permission checking implementation, or you're changing space permissions, you should be using PermissionManager instead.

Parameters:

permissionTypes - A List of permission types (see SpacePermission) to check

space - The space the permissions apply to

user - The user to look up

Returns:

true if remoteUser has the permission, false otherwise

removeAllUserPermissions

@Deprecated
void removeAllUserPermissions(ConfluenceUser user)

Deprecated. since 5.9. Use SpacePermissionManagerInternal.removeAllUserPermissions(com.atlassian.confluence.user.ConfluenceUser, com.atlassian.confluence.internal.security.SpacePermissionContext) instead.

Removes all permissions for the given user, and generates a SpacePermissionsRemoveForUserEvent in the process.

Since:

5.3

removeAllUserPermissions

@Deprecated
void removeAllUserPermissions(String username)

Deprecated. since 5.3. Use SpacePermissionManagerInternal.removeAllUserPermissions(com.atlassian.confluence.user.ConfluenceUser, com.atlassian.confluence.internal.security.SpacePermissionContext) instead.

removeGlobalPermissionForUser

@Deprecated
void removeGlobalPermissionForUser(ConfluenceUser user,
                                               String permissionType)

Deprecated. since 5.9. Use SpacePermissionManagerInternal.removeGlobalPermissionForUser(com.atlassian.confluence.user.ConfluenceUser, String, com.atlassian.confluence.internal.security.SpacePermissionContext) instead.

Removes global permission of specified type that is directly associated with a user, and generates a SpacePermissionsRemoveForUserEvent in the process.

Parameters:

user - the user to look up

permissionType - the permission type to remove

Since:

5.4

removeAllPermissionsForGroup

@Deprecated
void removeAllPermissionsForGroup(String group)

Deprecated. since 5.8. Use SpacePermissionManagerInternal.removeAllPermissionsForGroup(String, com.atlassian.confluence.internal.security.SpacePermissionContext) instead.

Removes all permissions for the given group, and generates a SpacePermissionsRemoveForGroupEvent in the process.

Parameters:

group - the group to remove

getAllPermissionsForGroup

List<SpacePermission> getAllPermissionsForGroup(String group)

getGlobalPermissions

List<SpacePermission> getGlobalPermissions()

getGlobalPermissions

List<SpacePermission> getGlobalPermissions(String permissionType)

flushCaches

void flushCaches()

groupHasPermission

boolean groupHasPermission(String permissionType,
                           @Nullable
                           Space space,
                           String group)

Checks whether the given group has the given permission

If a null space is specified, this method looks up matching global permissions, otherwise space's permissions list is queried to see if the permission matches.

Similarly, if permissionType is not a space permission, a matching global permission is looked up.

Parameters:

group - The group to look up the permission for

space - The space the permission applies to (can be null for global permissions)

permissionType - The permission type to look up

Returns:

true if the group has the required permission, false otherwise

createInitialSpacePermissions

@Deprecated
void createInitialSpacePermissions(Space space)

Deprecated. Use createDefaultSpacePermissions(com.atlassian.confluence.spaces.Space) or createPrivateSpacePermissions(com.atlassian.confluence.spaces.Space) instead. Since v4.2.6.

Creates all the initial permissions (in this list SpacePermission.GENERIC_SPACE_PERMISSIONS) in the specified space.

createDefaultSpacePermissions

void createDefaultSpacePermissions(Space space)

createPrivateSpacePermissions

void createPrivateSpacePermissions(Space space)

hasPermissionForSpace

boolean hasPermissionForSpace(@Nullable
                              com.atlassian.user.User user,
                              List permissionTypes,
                              @Nullable
                              Space space)

getGroupsWithPermissions

Collection<com.atlassian.user.Group> getGroupsWithPermissions(@Nullable
                                                              Space space)

Returns all groups which have permissions in a space or on a global level. If space is null, permissions on the global level will be checked.

Parameters:

space - - space to query, if null global permissions returned

Returns:

Collection of groups with permissions

getGroupsForPermissionType

Map<String,Long> getGroupsForPermissionType(String permissionType,
                                            Space space)

getUsersWithPermissions

Collection<com.atlassian.user.User> getUsersWithPermissions(@Nullable
                                                            Space space)

Returns a collection of user objects with VIEWSPACE_PERMISSION in the space. If no space is provided A list of users with USE_CONFLUENCE_PERMISSION will be returned

Parameters:

space - - space to query, if null global permissions returned

Returns:

Collection of User objects

getUsersForPermissionType

Map<String,Long> getUsersForPermissionType(String permissionType,
                                           Space space)

permissionExists

boolean permissionExists(SpacePermission permission)

Check whether the given SpacePermission exists. Checks by attribute equality rather than by id.

Parameters:

permission - the permission to look for.

Returns:

true if the permission is recognised by the manager as existing.

getDefaultGlobalPermissions

Set<SpacePermission> getDefaultGlobalPermissions()

Returns the default global permissions that are created when Confluence is set up. These will exist in a newly set up system but may be removed afterwards. Note that the returned objects are freshly created and therefore do not have IDs or other persistence data.

By default, confluence-administrators group has admin access, the default confluence users group can view the system and anonymous access is disabled.

Returns:

a collection of SpacePermissions.