com.atlassian.confluence.user
Class DefaultUserAccessor

java.lang.Object
  bucket.user.DefaultUserAccessor
      com.atlassian.confluence.user.DefaultUserAccessor

All Implemented Interfaces:

bucket.user.UserAccessor, com.atlassian.user.search.query.EntityQueryParser

public class DefaultUserAccessor
extends bucket.user.DefaultUserAccessor
implements UserAccessor

Field Summary

Fields inherited from class bucket.user.DefaultUserAccessor

DEFAULT_GROUP_NAME, defaultGroup

Fields inherited from interface com.atlassian.confluence.user.UserAccessor

ANONYMOUS, DEFAULT_GROUP_NAMES, GROUP_CONFLUENCE_ADMINS, GROUP_CONFLUENCE_USERS, PROFILE_PICTURE_BUILTIN_PATH, USER_GROUP_SUFFIX

Constructor Summary

DefaultUserAccessor()

Method Summary

com.atlassian.user.Group	addGroup(java.lang.String groupname) Adds a group with the specified name.
void	addMembership(com.atlassian.user.Group group, com.atlassian.user.User user) Adds the specified user to this group.
com.atlassian.user.User	addUser(java.lang.String username, java.lang.String password, java.lang.String email, java.lang.String fullname, java.lang.String[] groups) Adds a new user.
com.atlassian.user.Group	createGroup(java.lang.String groupname) Method was added for consistency.
void	deactivateUser(com.atlassian.user.User user)
java.util.List	filterUnaccessibleGroups(java.util.List groupList, com.atlassian.user.User user)
com.atlassian.user.search.page.Pager	filterUnaccessibleGroups(com.atlassian.user.search.page.Pager groupPager, com.atlassian.user.User user)
java.util.List	filterUnaccessibleUsers(java.util.List userNameList, com.atlassian.user.User user) Filters out unaccessible users from the passed in list.
com.atlassian.user.search.page.Pager	filterUnaccessibleUsers(com.atlassian.user.search.page.Pager userPager, com.atlassian.user.User user) Deprecated. since 2.8, use filterUnaccessibleUsers(java.util.List, com.atlassian.user.User) instead
java.util.List	findUsersAsList(com.atlassian.user.search.query.Query search)
ConfluenceUserPreferences	getConfluenceUserPreferences(com.atlassian.user.User user)
java.util.List	getDelegatingRepositories()
java.util.List	getGroupsAsList()
java.util.List<com.atlassian.user.Group>	getGroupsAsList(com.atlassian.user.User user)
java.util.List	getMemberNamesAsList(com.atlassian.user.Group group)
com.atlassian.user.User	getUserIfAvailable(java.lang.String username)
ProfilePictureInfo	getUserProfilePicture(java.lang.String username)
ProfilePictureInfo	getUserProfilePicture(com.atlassian.user.User user)
com.atlassian.user.search.page.Pager	getUsersWithConfluenceAccess() a user is active is they have 'USE' permission or have been assigned to a group that has this permission (example, confluence-user)
java.util.List<com.atlassian.user.User>	getUsersWithConfluenceAccessAsList()
java.util.List<com.atlassian.user.Group>	getWriteableGroups()
boolean	isLicensedToAddMoreUsers()
boolean	isReadOnly(com.atlassian.user.Group group)
boolean	isReadOnly(com.atlassian.user.User user)
boolean	isSuperUser(com.atlassian.user.User user)
void	reactivateUser(com.atlassian.user.User user)
void	removeGroup(com.atlassian.user.Group group)
boolean	removeMembership(com.atlassian.user.Group group, com.atlassian.user.User user) Removes the specified user from this group.
void	removeUser(com.atlassian.user.User user) Removes the specified user.
void	savePersonalInformation(PersonalInformation newInfo, PersonalInformation oldInfo)
void	setAttachmentManager(AttachmentManager attachmentManager)
void	setContentEntityManager(ContentEntityManager contentEntityManager)
void	setContentPermissionManager(ContentPermissionManager contentPermissionManager)
void	setEventManager(com.atlassian.event.EventManager eventManager)
void	setNotificationManager(NotificationManager notificationManager)
void	setPermissionManager(PermissionManager permissionManager)
void	setPersonalInformationManager(PersonalInformationManager personalInformationManager)
void	setSettingsManager(SettingsManager settingsManager)
void	setSpacePermissionManager(SpacePermissionManager spacePermissionManager)
void	setUserChecker(UserChecker userChecker)
void	setUserProfilePicture(com.atlassian.user.User user, Attachment attachment)
void	setUserProfilePicture(com.atlassian.user.User user, java.lang.String imagePath)

Methods inherited from class bucket.user.DefaultUserAccessor

addMembership, addUser, alterPassword, authenticate, checkConfiguration, createUser, findGroups, findGroups, findUsers, findUsers, getAuthenticator, getDefaultGroup, getEntityQueryParser, getExternallMembers, getGroup, getGroupCreateIfNecessary, getGroupManager, getGroups, getGroups, getLocalMembers, getMemberNames, getPropertySet, getPropertySetFactory, getRepository, getUser, getUserManager, getUserNames, getUserPreferences, getUsers, getUsersByEmail, hasMembership, hasMembership, init, isDeactivated, isDeactivated, isUserRemovable, removeMembership, removeUserFromAllGroups, saveUser, setAtlassianUserConfiguration

Methods inherited from class java.lang.Object

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

Methods inherited from interface bucket.user.UserAccessor

addMembership, addUser, alterPassword, authenticate, createUser, findUsers, getDefaultGroup, getExternallMembers, getGroup, getGroupCreateIfNecessary, getGroups, getGroups, getLocalMembers, getMemberNames, getPropertySet, getRepository, getUser, getUserNames, getUserPreferences, getUsers, getUsersByEmail, hasMembership, hasMembership, isDeactivated, isDeactivated, isUserRemovable, removeMembership, saveUser, setAtlassianUserConfiguration

Methods inherited from interface com.atlassian.user.search.query.EntityQueryParser

findGroups, findGroups, findUsers

Constructor Detail

DefaultUserAccessor

public DefaultUserAccessor()

Method Detail

isLicensedToAddMoreUsers

public boolean isLicensedToAddMoreUsers()

Specified by:

isLicensedToAddMoreUsers in interface bucket.user.UserAccessor

Overrides:

isLicensedToAddMoreUsers in class bucket.user.DefaultUserAccessor

addMembership

public void addMembership(com.atlassian.user.Group group,
                          com.atlassian.user.User user)

Adds the specified user to this group.

Specified by:

addMembership in interface bucket.user.UserAccessor

Overrides:

addMembership in class bucket.user.DefaultUserAccessor

Throws:

InsufficientPrivilegeException - if the currently logged in user does not have the permissions to add this user to this group. Check permissions using Permission.EDIT on PermissionManager on the group first.

removeMembership

public boolean removeMembership(com.atlassian.user.Group group,
                                com.atlassian.user.User user)

Removes the specified user from this group.

Specified by:

removeMembership in interface bucket.user.UserAccessor

Overrides:

removeMembership in class bucket.user.DefaultUserAccessor

Throws:

InsufficientPrivilegeException - if the currently logged in user does not have the permissions to remove this user from this group. Check permissions using Permission.REMOVE and PermissionManager on the group first.

addUser

public com.atlassian.user.User addUser(java.lang.String username,
                                       java.lang.String password,
                                       java.lang.String email,
                                       java.lang.String fullname,
                                       java.lang.String[] groups)

Adds a new user.

Specified by:

addUser in interface bucket.user.UserAccessor

Overrides:

addUser in class bucket.user.DefaultUserAccessor

Parameters:

groups - a string array of group names to add the new user to. if the groups don't exist they will be created.

Returns:

the newly created user

Throws:

InsufficientPrivilegeException - if the current user does not have permission to add a user to any of the specified groups

bucket.user.LicensingException - if you are not licensed to add any more users

addGroup

public com.atlassian.user.Group addGroup(java.lang.String groupname)

Adds a group with the specified name.

Specified by:

addGroup in interface bucket.user.UserAccessor

Overrides:

addGroup in class bucket.user.DefaultUserAccessor

Returns:

the group created

Throws:

InsufficientPrivilegeException - if the current user does not have permission to add this group

createGroup

public com.atlassian.user.Group createGroup(java.lang.String groupname)

Method was added for consistency. We will need to decide whether we want to lowercase all group names upon creation. Currently createGroup() preserves the casing of the name and addGroup() will lowercase the name. Both methods were in use by Confluence, but only one overwritten to publish an event.

Specified by:

createGroup in interface bucket.user.UserAccessor

Overrides:

createGroup in class bucket.user.DefaultUserAccessor

removeGroup

public void removeGroup(com.atlassian.user.Group group)

Specified by:

removeGroup in interface bucket.user.UserAccessor

Overrides:

removeGroup in class bucket.user.DefaultUserAccessor

Throws:

InsufficientPrivilegeException - if you do not have sufficient permissions to remove this group. Check permissions using Permission.REMOVE and PermissionManager on the group first.

removeUser

public void removeUser(com.atlassian.user.User user)

Removes the specified user.

Specified by:

removeUser in interface bucket.user.UserAccessor

Overrides:

removeUser in class bucket.user.DefaultUserAccessor

Throws:

java.lang.IllegalArgumentException - if the specified user is null

InsufficientPrivilegeException - if the currently logged in user does not permissions to remove this user. Check permissions using Permission.REMOVE and PermissionManager on the user first.

getUsersWithConfluenceAccess

public com.atlassian.user.search.page.Pager getUsersWithConfluenceAccess()

a user is active is they have 'USE' permission or have been assigned to a group that has this permission (example, confluence-user)

Specified by:

getUsersWithConfluenceAccess in interface bucket.user.UserAccessor

Overrides:

getUsersWithConfluenceAccess in class bucket.user.DefaultUserAccessor

Returns:

a list of active users.

savePersonalInformation

public void savePersonalInformation(PersonalInformation newInfo,
                                    PersonalInformation oldInfo)

deactivateUser

public void deactivateUser(com.atlassian.user.User user)

Specified by:

deactivateUser in interface bucket.user.UserAccessor

Overrides:

deactivateUser in class bucket.user.DefaultUserAccessor

reactivateUser

public void reactivateUser(com.atlassian.user.User user)

Specified by:

reactivateUser in interface bucket.user.UserAccessor

Overrides:

reactivateUser in class bucket.user.DefaultUserAccessor

setNotificationManager

public void setNotificationManager(NotificationManager notificationManager)

setSpacePermissionManager

public void setSpacePermissionManager(SpacePermissionManager spacePermissionManager)

setContentEntityManager

public void setContentEntityManager(ContentEntityManager contentEntityManager)

setEventManager

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

setPersonalInformationManager

public void setPersonalInformationManager(PersonalInformationManager personalInformationManager)

isReadOnly

public boolean isReadOnly(com.atlassian.user.User user)

isReadOnly

public boolean isReadOnly(com.atlassian.user.Group group)

filterUnaccessibleUsers

public com.atlassian.user.search.page.Pager filterUnaccessibleUsers(com.atlassian.user.search.page.Pager userPager,
                                                                    com.atlassian.user.User user)

Deprecated. since 2.8, use filterUnaccessibleUsers(java.util.List, com.atlassian.user.User) instead

filterUnaccessibleGroups

public com.atlassian.user.search.page.Pager filterUnaccessibleGroups(com.atlassian.user.search.page.Pager groupPager,
                                                                     com.atlassian.user.User user)

getDelegatingRepositories

public java.util.List getDelegatingRepositories()

Specified by:

getDelegatingRepositories in interface bucket.user.UserAccessor

Overrides:

getDelegatingRepositories in class bucket.user.DefaultUserAccessor

Returns:

an instance of DelegatingRepository representing all Repositories being delegated or null (if there is no delegation).

setUserChecker

public void setUserChecker(UserChecker userChecker)

setAttachmentManager

public void setAttachmentManager(AttachmentManager attachmentManager)

getUserProfilePicture

public ProfilePictureInfo getUserProfilePicture(java.lang.String username)

getUserProfilePicture

public ProfilePictureInfo getUserProfilePicture(com.atlassian.user.User user)

setUserProfilePicture

public void setUserProfilePicture(com.atlassian.user.User user,
                                  Attachment attachment)

setUserProfilePicture

public void setUserProfilePicture(com.atlassian.user.User user,
                                  java.lang.String imagePath)

isSuperUser

public boolean isSuperUser(com.atlassian.user.User user)

getConfluenceUserPreferences

public ConfluenceUserPreferences getConfluenceUserPreferences(com.atlassian.user.User user)

setSettingsManager

public void setSettingsManager(SettingsManager settingsManager)

setContentPermissionManager

public void setContentPermissionManager(ContentPermissionManager contentPermissionManager)

setPermissionManager

public void setPermissionManager(PermissionManager permissionManager)

filterUnaccessibleUsers

public java.util.List filterUnaccessibleUsers(java.util.List userNameList,
                                              com.atlassian.user.User user)

Filters out unaccessible users from the passed in list. Users are inaccessible if they shared mode is turned on and they do not share a group with the user.

Parameters:

userNameList - list of user names as Strings to be filtered.

user - the user whose permission to view the list of users is being checked.

Returns:

userNameList with some stuff removed.

filterUnaccessibleGroups

public java.util.List filterUnaccessibleGroups(java.util.List groupList,
                                               com.atlassian.user.User user)

getGroupsAsList

public java.util.List getGroupsAsList()

getMemberNamesAsList

public java.util.List getMemberNamesAsList(com.atlassian.user.Group group)

getWriteableGroups

public java.util.List<com.atlassian.user.Group> getWriteableGroups()

getUsersWithConfluenceAccessAsList

public java.util.List<com.atlassian.user.User> getUsersWithConfluenceAccessAsList()

getUserIfAvailable

public com.atlassian.user.User getUserIfAvailable(java.lang.String username)

getGroupsAsList

public java.util.List<com.atlassian.user.Group> getGroupsAsList(com.atlassian.user.User user)

findUsersAsList

public java.util.List findUsersAsList(com.atlassian.user.search.query.Query search)
                               throws com.atlassian.user.EntityException

Throws:

com.atlassian.user.EntityException