com.atlassian.confluence.security.administrators
Interface EditPermissionsAdministrator

All Superinterfaces:
PermissionsAdministrator
All Known Implementing Classes:
AbstractEditPermissionsAdministrator, EditGlobalPermissionsAdministrator, EditSpacePermissionsAdministrator

public interface EditPermissionsAdministrator
extends PermissionsAdministrator

Provides the logic required by the actions to edit the permissions for both global and spaces


Field Summary
static java.lang.Integer MAX_ENTRIES
          the max number of entries for adding groups or users to permission scheme.
 
Method Summary
 void addAllPermissions(java.util.Set<SpacePermission> permissionsToAdd)
          Adds the given set of permissions if the current user has permission to do so, otherwise does nothing silently.
 java.util.List<java.lang.String> addGuardPermissionToGroups(java.util.List<java.lang.String> groupNames, UserAccessor userAccessor, java.lang.String guardPermission)
          Add the guard permissions for each group if they exist
 java.util.List<java.lang.String> addGuardPermissionToUsers(java.util.List<java.lang.String> userNames, UserAccessor userAccessor, java.lang.String guardPermission)
          Add the guard permissions for each user if they exist
 void addPermission(SpacePermission permissionToAdd)
          Adds the given permission if the current user has permission to do so, otherwise does nothing silently.
 void applyPermissionChanges(java.util.Collection<SpacePermission> oldPermissions, java.util.Collection<SpacePermission> newPermissions)
          Given the old permissions and new permissions, apply necessary permission changes to make old permissions the same as new permissions
 java.util.Collection<SpacePermission> buildPermissionsFromWebForm(java.util.Map formParameters, java.lang.String parameterQualifier)
          Given a map containing the web form parameters from a permissions edit, return the list of global permissions that are represented by the form
 SpacePermission createGroupGuardPermission(java.lang.String guardPermission, java.lang.String groupName)
          Creates the relevant guard permission for the group
 SpacePermission createUserGuardPermission(java.lang.String guardPermission, ConfluenceUser user)
          Creates the relevant guard permission for the user
 SpacePermission createUserGuardPermission(java.lang.String guardPermission, java.lang.String userName)
          Deprecated. since 5.2. See createUserGuardPermission(String, ConfluenceUser)
 void denyAnonymousPermissions(java.util.Collection<SpacePermission> currentPermissions, java.util.Set<SpacePermission> permissionsToAdd, java.util.Set<SpacePermission> permissionsToRemove)
          Removes all anonymous permissions
 java.lang.String getAdministrativePermissionType()
          Returns the top level permission type applicable to the current scope.
 java.util.Collection<SpacePermission> getInitialPermissionsFromForm(java.util.Map requestParams)
          Retrieve the permissions initial state
 int getNumOfGroupEntries()
          Returns the number of group entries that are to be added.
 int getNumOfUserEntries()
          Returns the number of user entries that are to be added.
 java.util.Collection<SpacePermission> getRequestedPermissionsFromForm(java.util.Map requestParams)
          Retrieve the state of the permissions requested by the user
 boolean isGroupsToAddEmpty(java.util.Map requestParams)
          Validate if the number of groups to add is empty Validation only occurs if the group add button is pressed
 boolean isGroupsToAddTooLarge(java.util.Map requestParams)
          Validate if the number of groups to add is greater than maximum allowed.
 boolean isRemoveAllAdminPermissions(java.util.Set<SpacePermission> permissionsToRemove)
          Returns if all admin permissions would be removed by the request.
 boolean isUsersToAddEmpty(java.util.Map requestParams)
          Validate if the number of users to add is empty Validation only occurs if the user add button is pressed
 boolean isUsersToAddTooLarge(java.util.Map requestParams)
          Validate if the number of users to add is greater than maximum allowed.
 void removeAllPermissions(java.util.Set<SpacePermission> permissionsToRemove)
          Removes the given set of permissions if the current user has permission to do so, otherwise does nothing silently.
 void removePermission(SpacePermission permissionToRemove)
          Removes the given permission if the current user has permission to do so, otherwise does nothing silently.
 void splitPermissions(java.util.Collection<SpacePermission> existingPermissions, java.util.Collection<SpacePermission> initialPermissions, java.util.Collection<SpacePermission> requestedPermissions, java.util.Set<SpacePermission> permissionsToAdd, java.util.Set<SpacePermission> permissionsToRemove)
          Determine which permissions need to be added or removed.
 
Methods inherited from interface com.atlassian.confluence.security.administrators.PermissionsAdministrator
buildAnonymousPermissionRow, buildGroupPermissionTable, buildUserPermissionTable, getPermissions
 

Field Detail

MAX_ENTRIES

static final java.lang.Integer MAX_ENTRIES
the max number of entries for adding groups or users to permission scheme.

Method Detail

isGroupsToAddTooLarge

boolean isGroupsToAddTooLarge(java.util.Map requestParams)
Validate if the number of groups to add is greater than maximum allowed. Validation only occurs if the group add button is pressed

Parameters:
requestParams - params from the request
Returns:
true if limit is exceeded.

isGroupsToAddEmpty

boolean isGroupsToAddEmpty(java.util.Map requestParams)
Validate if the number of groups to add is empty Validation only occurs if the group add button is pressed

Parameters:
requestParams - params from the request
Returns:
true if groups are empty

getNumOfGroupEntries

int getNumOfGroupEntries()
Returns the number of group entries that are to be added.

Returns:
the number of group entries that are to be added

isUsersToAddTooLarge

boolean isUsersToAddTooLarge(java.util.Map requestParams)
Validate if the number of users to add is greater than maximum allowed. Validation only occurs if the user add button is pressed

Parameters:
requestParams - params from the request
Returns:
true if limit is exceeded.

isUsersToAddEmpty

boolean isUsersToAddEmpty(java.util.Map requestParams)
Validate if the number of users to add is empty Validation only occurs if the user add button is pressed

Parameters:
requestParams - params from the request
Returns:
true if users are empty

getNumOfUserEntries

int getNumOfUserEntries()
Returns the number of user entries that are to be added.

Returns:
the number of user entries that are to be added

buildPermissionsFromWebForm

java.util.Collection<SpacePermission> buildPermissionsFromWebForm(java.util.Map formParameters,
                                                                  java.lang.String parameterQualifier)
Given a map containing the web form parameters from a permissions edit, return the list of global permissions that are represented by the form

Parameters:
formParameters - the map of form parameters
parameterQualifier - distinguishes the set of parameters from other sets of parameters used to represent permissions in the same form.
Returns:
a list of the permissions in the form

splitPermissions

void splitPermissions(java.util.Collection<SpacePermission> existingPermissions,
                      java.util.Collection<SpacePermission> initialPermissions,
                      java.util.Collection<SpacePermission> requestedPermissions,
                      java.util.Set<SpacePermission> permissionsToAdd,
                      java.util.Set<SpacePermission> permissionsToRemove)
Determine which permissions need to be added or removed. Given a collection of how permissions are now (existingPermissions) and how you wish the permissions to be (newPermissions), this will populate the collections permissionsToAdd and permissionsToRemove with those permissions that you will need to add or remove to reach the desired state.

Parameters:
existingPermissions - the currently existing permissions
initialPermissions - the permissions the user was initially shown
requestedPermissions - the new state we want these permissions to be in
permissionsToAdd - collection into which permissions that need adding will be placed
permissionsToRemove - collection into which permissions that need removing will be placed

isRemoveAllAdminPermissions

boolean isRemoveAllAdminPermissions(java.util.Set<SpacePermission> permissionsToRemove)
Returns if all admin permissions would be removed by the request.

Parameters:
permissionsToRemove - - permissions to be removed
Returns:
true if all admin permissions would be removed by the request

getInitialPermissionsFromForm

java.util.Collection<SpacePermission> getInitialPermissionsFromForm(java.util.Map requestParams)
Retrieve the permissions initial state

Returns:
initial state

getRequestedPermissionsFromForm

java.util.Collection<SpacePermission> getRequestedPermissionsFromForm(java.util.Map requestParams)
Retrieve the state of the permissions requested by the user

Returns:
requested state

denyAnonymousPermissions

void denyAnonymousPermissions(java.util.Collection<SpacePermission> currentPermissions,
                              java.util.Set<SpacePermission> permissionsToAdd,
                              java.util.Set<SpacePermission> permissionsToRemove)
Removes all anonymous permissions

Parameters:
currentPermissions - - current state of the permissions
permissionsToAdd - - permissions to be added
permissionsToRemove - - permissions to be removed

addAllPermissions

void addAllPermissions(java.util.Set<SpacePermission> permissionsToAdd)
Adds the given set of permissions if the current user has permission to do so, otherwise does nothing silently.

Parameters:
permissionsToAdd - the set of permissions you want rid of.

addPermission

void addPermission(SpacePermission permissionToAdd)
Adds the given permission if the current user has permission to do so, otherwise does nothing silently.

Parameters:
permissionToAdd - the permission you want rid of.

removeAllPermissions

void removeAllPermissions(java.util.Set<SpacePermission> permissionsToRemove)
Removes the given set of permissions if the current user has permission to do so, otherwise does nothing silently.

Parameters:
permissionsToRemove - the permission you want rid of.

removePermission

void removePermission(SpacePermission permissionToRemove)
Removes the given permission if the current user has permission to do so, otherwise does nothing silently.

Parameters:
permissionToRemove - the permission you want rid of.

addGuardPermissionToGroups

java.util.List<java.lang.String> addGuardPermissionToGroups(java.util.List<java.lang.String> groupNames,
                                                            UserAccessor userAccessor,
                                                            java.lang.String guardPermission)
Add the guard permissions for each group if they exist

Parameters:
groupNames - - names of the groups to be added
userAccessor - - user accessor
guardPermission - - the name of the guard permission to add
Returns:
false if an error occurred.

addGuardPermissionToUsers

java.util.List<java.lang.String> addGuardPermissionToUsers(java.util.List<java.lang.String> userNames,
                                                           UserAccessor userAccessor,
                                                           java.lang.String guardPermission)
Add the guard permissions for each user if they exist

Parameters:
userNames - - names of the users to be added
userAccessor - - user accessor
guardPermission - - the name of the guard permission to add
Returns:
false if an error occurred.

createUserGuardPermission

@Deprecated
SpacePermission createUserGuardPermission(java.lang.String guardPermission,
                                                     java.lang.String userName)
Deprecated. since 5.2. See createUserGuardPermission(String, ConfluenceUser)

Creates the relevant guard permission for the user

Parameters:
guardPermission - - the name of the guard permission to create
userName - - name of the user to add the permission to
Returns:
spacepermission object for the user

createUserGuardPermission

SpacePermission createUserGuardPermission(java.lang.String guardPermission,
                                          ConfluenceUser user)
Creates the relevant guard permission for the user

Parameters:
guardPermission - - the name of the guard permission to create
user - - name of the user to add the permission to
Returns:
spacepermission object for the user
Since:
5.2

createGroupGuardPermission

SpacePermission createGroupGuardPermission(java.lang.String guardPermission,
                                           java.lang.String groupName)
Creates the relevant guard permission for the group

Parameters:
guardPermission - - the name of the guard permission to create
groupName - - name of group to add the permission to
Returns:
spacepermission object for the user

getAdministrativePermissionType

java.lang.String getAdministrativePermissionType()
Returns the top level permission type applicable to the current scope. That is, the permission that must exist at least once per space, or globally.

Returns:
top level permission type

applyPermissionChanges

void applyPermissionChanges(java.util.Collection<SpacePermission> oldPermissions,
                            java.util.Collection<SpacePermission> newPermissions)
Given the old permissions and new permissions, apply necessary permission changes to make old permissions the same as new permissions

Parameters:
oldPermissions - - initial permissions
newPermissions - - expected permissions


Copyright © 2003-2014 Atlassian. All Rights Reserved.