com.atlassian.confluence.user

Class DefaultUserAccessor

java.lang.Object

bucket.user.DefaultUserAccessor

com.atlassian.confluence.user.DefaultUserAccessor

All Implemented Interfaces:

UserAccessor, UserAccessorInternal, ConfluenceUserResolver, GroupMembershipAccessor, GroupResolver, UserPreferencesAccessor, UserProfilePictureAccessor, com.atlassian.user.search.query.EntityQueryParser

@Transactional
public class DefaultUserAccessor
extends DefaultUserAccessor
implements UserAccessorInternal

This implementation of UserAccessor takes care of all the Confluence-related actions around user management: checking permissions, publishing events, and ensuring the integrity of data in Confluence related to users.

Field Summary

Fields

Modifier and Type	Field and Description
static int	BULK_FETCH_GROUP_BATCH_SIZE
static int	BULK_FETCH_USERS_BATCH_SIZE

Fields inherited from class bucket.user.DefaultUserAccessor

defaultGroup

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

DEFAULT_GROUP_NAMES, GROUP_CONFLUENCE_ADMINS, GROUP_CONFLUENCE_USERS, PROFILE_PICTURE_BUILTIN_PATH

Constructor Summary

Constructors

Constructor and Description
DefaultUserAccessor(com.atlassian.user.configuration.RepositoryAccessor repositoryAccessor, SpacePermissionManagerInternal spacePermissionManager, ContentEntityManager contentEntityManager, NotificationManager notificationManager, PersonalInformationManager personalInformationManager, UserChecker userChecker, AttachmentManager attachmentManager, com.atlassian.event.api.EventPublisher eventPublisher, ContentPermissionManager contentPermissionManager, PermissionManager permissionManager, FollowManager followManager, com.atlassian.crowd.embedded.api.CrowdService crowdService, DisabledUserManager disabledUserManager, HibernateSessionManager sessionManager, ConfluenceUserDao confluenceUserDao, com.atlassian.user.UserManager backingUserManager, SettingsManager settingsManager, AvatarProviderAccessor avatarProviderAccessor, ResourceAccessor resourceAccessor, org.springframework.transaction.PlatformTransactionManager transactionManager, UserMentionsContentReindexer userMentionsContentReindexer, CrowdUserDirectoryHelper crowdUserDirectoryHelper, SynchronizationManager synchronizationManager) Deprecated. since 7.17.5
DefaultUserAccessor(com.atlassian.user.configuration.RepositoryAccessor repositoryAccessor, SpacePermissionManagerInternal spacePermissionManager, ContentEntityManager contentEntityManager, NotificationManager notificationManager, PersonalInformationManager personalInformationManager, UserChecker userChecker, AttachmentManager attachmentManager, com.atlassian.event.api.EventPublisher eventPublisher, ContentPermissionManager contentPermissionManager, PermissionManager permissionManager, FollowManager followManager, com.atlassian.crowd.embedded.api.CrowdService crowdService, DisabledUserManager disabledUserManager, HibernateSessionManager sessionManager, ConfluenceUserDao confluenceUserDao, com.atlassian.user.UserManager backingUserManager, SettingsManager settingsManager, AvatarProviderAccessor avatarProviderAccessor, ResourceAccessor resourceAccessor, org.springframework.transaction.PlatformTransactionManager transactionManager, UserMentionsContentReindexer userMentionsContentReindexer, CrowdUserDirectoryHelper crowdUserDirectoryHelper, SynchronizationManager synchronizationManager, UserVerificationTokenManager userVerificationTokenManager)

Method Summary

Modifier and Type	Method and Description
com.atlassian.user.Group	addGroup(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.
void	alterPassword(com.atlassian.user.User user, String plainTextPassword)
void	alterPassword(com.atlassian.user.User user, String plainTextPassword, String token)
int	countLicenseConsumingUsers() Returns the number of users which have access to use Confluence AND consume a Confluence license.
int	countUnsyncedUsers() Get a count of all unsynced users in Confluence.
com.atlassian.user.Group	createGroup(String groupname) Method was added for consistency.
ConfluenceUser	createUser(com.atlassian.user.User userTemplate, com.atlassian.user.security.password.Credential credential)
void	deactivateUser(com.atlassian.user.User user) Deactivate the specified user, which prevents them logging in.
boolean	exists(String name) Returns true if a user exists with the given username.
com.atlassian.user.search.SearchResult<com.atlassian.user.User>	findUsers(com.atlassian.user.search.query.Query<com.atlassian.user.User> query)
List<com.atlassian.user.User>	findUsersAsList(com.atlassian.user.search.query.Query<com.atlassian.user.User> search)
List<String>	getAllDefaultGroupNames() Deprecated. Since 5.2. This method is vague and returns a collection containing the result of Settings.getDefaultUsersGroup() and UserAccessor.GROUP_CONFLUENCE_ADMINS. Clients should explicitly decide what they need and use that.
ConfluenceUserPreferences	getConfluenceUserPreferences(@Nullable com.atlassian.user.User user)
Optional<ConfluenceUser>	getExistingByApiUser(User user) Retrieve the corresponding ConfluenceUser (if any) for a user, by user key or username
@Nullable ConfluenceUser	getExistingUserByKey(com.atlassian.sal.api.user.UserKey key) Returns the user with the specified user key, or null if the user doesn't exist or the key is null.
@Nullable ConfluenceUser	getExistingUserByPerson(@NonNull Person person) Retrieve the corresponding ConfluenceUser (if any) for a Person, by username, or user key
com.atlassian.user.Group	getGroup(String name) Returns the group with the specified name, or null if the user doesn't exist or the name is null.
List<String>	getGroupNames(com.atlassian.user.User user) Gets the list of group names representing the groups the passed in user is a member of.
List<String>	getGroupNamesForUserName(String userName) Gets the list of group names representing the groups the passed in user is a member of.
List<com.atlassian.user.Group>	getGroupsAsList()
List<com.atlassian.user.Group>	getGroupsByGroupNames(List<String> groupNames) Returns a list of Group objects where the names match that of the provided list of group names.
ProfilePictureInfo	getLogoForUser(@Nullable com.atlassian.user.User user)
com.atlassian.user.search.page.Pager<String>	getMemberNames(com.atlassian.user.Group group) Returns a pager containing the usernames of users who are members of the specified group (either directly or as a member of a nested group).
List<String>	getMemberNamesAsList(com.atlassian.user.Group group) Same as UserAccessor.getMemberNames(com.atlassian.user.Group) but returns a List of user names as Strings rather than a Pager.
Iterable<ConfluenceUser>	getMembers(com.atlassian.user.Group group) Returns users who are members of the specified group (either directly or as a member of a nested group).
String	getNewUserDefaultGroupName() Deprecated. since 5.2. Use Settings.getDefaultUsersGroup() via SettingsManager.getGlobalSettings().
com.opensymphony.module.propertyset.PropertySet	getPropertySet(ConfluenceUser user)
com.opensymphony.module.propertyset.PropertySet	getPropertySet(com.atlassian.user.User user)
@Nullable ConfluenceUser	getUserByKey(com.atlassian.sal.api.user.UserKey key) Returns the user with the specified user key, or null if the user has never existed or the key is null.
@Nullable ConfluenceUser	getUserByName(String name) Returns the ConfluenceUser with the supplied user name or null if the user doesn't exist or the supplied name is null.
List<String>	getUserNamesWithConfluenceAccess() Returns the names of all users with access to use Confluence.
com.atlassian.core.user.preferences.UserPreferences	getUserPreferences(com.atlassian.user.User user)
ProfilePictureInfo	getUserProfilePicture(@Nullable com.atlassian.user.User user) Retrieve the path to a user's personal picture
com.atlassian.user.search.SearchResult	getUsersByEmail(String email)
List<ConfluenceUser>	getUsersByUserKeys(List<com.atlassian.sal.api.user.UserKey> userKeys) Returns a list of ConfluenceUser with the supplied UserKeys or an empty list if the users do not exist.
com.atlassian.user.search.page.Pager<com.atlassian.user.User>	getUsersWithConfluenceAccess() Deprecated. since 3.5.1. This method is very slow, use countUsersWithConfluenceAccess() if you need to know the number of users.
List<com.atlassian.user.Group>	getWriteableGroups() Gets all editable groups.
boolean	isCrowdManaged(ConfluenceUser user) Checks whether or not embedded Crowd manages/has knowledge of a given user
boolean	isDeactivated(String username) Returns true if the user with the specified username exists and is unable to log in, otherwise false.
boolean	isDeactivated(com.atlassian.user.User user) Returns true if the user exists and is unable to log in, otherwise false.
boolean	isDeletedUser(ConfluenceUser user) Check implementation is currently based on assumption that a deleted user is defined as a user with the same user key and user name.
boolean	isLicensedToAddMoreUsers()
boolean	isReadOnly(com.atlassian.user.Group group) Returns true if the group cannot be modified or removed.
boolean	isReadOnly(com.atlassian.user.User user) Returns true if the user cannot be modified or removed.
boolean	isSuperUser(com.atlassian.user.User user) Return true if the user is an all-powerful super-user (member of the confluence-administrators group).
boolean	isUnsyncedUser(ConfluenceUser user) Checks whether or not a user is unsynced
boolean	isUserRemovable(com.atlassian.user.User user)
void	reactivateUser(com.atlassian.user.User user) Marks the specified user as active, which allows them to log in.
void	removeGroup(com.atlassian.user.Group group) Removes the specified 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.
ConfluenceUser	renameUser(ConfluenceUser user, String newUsername) Updates the username of the given user.
void	savePersonalInformation(PersonalInformation newInfo, PersonalInformation oldInfo)
com.atlassian.user.search.page.Pager<ConfluenceUser>	searchUnsyncedUsers(String searchParam) Returns a list of all users for the given username search parameter that are unsynced: a user whose account has been disconnected from an external directory, i.e.
void	setUserProfilePicture(com.atlassian.user.User user, Attachment attachment) Set the user profile picture to the given attachment.
void	setUserProfilePicture(com.atlassian.user.User user, String imagePath) Set the user profile picture to a built-in image.

Methods inherited from class bucket.user.DefaultUserAccessor

addMembership, addUser, addUser, authenticate, findGroups, findGroups, findUsers, getAuthenticator, getEntityQueryParser, getGroupCreateIfNecessary, getGroupManager, getGroups, getGroups, getPropertySetFactory, getUser, getUserManager, getUserNames, getUsers, hasMembership, hasMembership, removeMembership, saveUser

Methods inherited from class java.lang.Object

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

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

getUser

Methods inherited from interface bucket.user.UserAccessor

addMembership, addUser, addUser, authenticate, getGroupCreateIfNecessary, getGroups, getGroups, getUserNames, getUsers, hasMembership, hasMembership, removeMembership, saveUser

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

findGroups, findGroups, findUsers

Methods inherited from interface com.atlassian.confluence.user.UserPreferencesAccessor

forUserAccessor

Field Detail

BULK_FETCH_USERS_BATCH_SIZE

public static final int BULK_FETCH_USERS_BATCH_SIZE

BULK_FETCH_GROUP_BATCH_SIZE

public static final int BULK_FETCH_GROUP_BATCH_SIZE

Constructor Detail

DefaultUserAccessor

public DefaultUserAccessor(com.atlassian.user.configuration.RepositoryAccessor repositoryAccessor,
                           SpacePermissionManagerInternal spacePermissionManager,
                           ContentEntityManager contentEntityManager,
                           NotificationManager notificationManager,
                           PersonalInformationManager personalInformationManager,
                           UserChecker userChecker,
                           AttachmentManager attachmentManager,
                           com.atlassian.event.api.EventPublisher eventPublisher,
                           ContentPermissionManager contentPermissionManager,
                           PermissionManager permissionManager,
                           FollowManager followManager,
                           com.atlassian.crowd.embedded.api.CrowdService crowdService,
                           DisabledUserManager disabledUserManager,
                           HibernateSessionManager sessionManager,
                           ConfluenceUserDao confluenceUserDao,
                           com.atlassian.user.UserManager backingUserManager,
                           SettingsManager settingsManager,
                           AvatarProviderAccessor avatarProviderAccessor,
                           ResourceAccessor resourceAccessor,
                           org.springframework.transaction.PlatformTransactionManager transactionManager,
                           UserMentionsContentReindexer userMentionsContentReindexer,
                           CrowdUserDirectoryHelper crowdUserDirectoryHelper,
                           SynchronizationManager synchronizationManager,
                           UserVerificationTokenManager userVerificationTokenManager)

Since:

7.17.5

DefaultUserAccessor

@Deprecated
public DefaultUserAccessor(com.atlassian.user.configuration.RepositoryAccessor repositoryAccessor,
                                       SpacePermissionManagerInternal spacePermissionManager,
                                       ContentEntityManager contentEntityManager,
                                       NotificationManager notificationManager,
                                       PersonalInformationManager personalInformationManager,
                                       UserChecker userChecker,
                                       AttachmentManager attachmentManager,
                                       com.atlassian.event.api.EventPublisher eventPublisher,
                                       ContentPermissionManager contentPermissionManager,
                                       PermissionManager permissionManager,
                                       FollowManager followManager,
                                       com.atlassian.crowd.embedded.api.CrowdService crowdService,
                                       DisabledUserManager disabledUserManager,
                                       HibernateSessionManager sessionManager,
                                       ConfluenceUserDao confluenceUserDao,
                                       com.atlassian.user.UserManager backingUserManager,
                                       SettingsManager settingsManager,
                                       AvatarProviderAccessor avatarProviderAccessor,
                                       ResourceAccessor resourceAccessor,
                                       org.springframework.transaction.PlatformTransactionManager transactionManager,
                                       UserMentionsContentReindexer userMentionsContentReindexer,
                                       CrowdUserDirectoryHelper crowdUserDirectoryHelper,
                                       SynchronizationManager synchronizationManager)

Deprecated. since 7.17.5

Method Detail

isLicensedToAddMoreUsers

public boolean isLicensedToAddMoreUsers()

Specified by:

isLicensedToAddMoreUsers in interface UserAccessor

Overrides:

isLicensedToAddMoreUsers in class DefaultUserAccessor

isUserRemovable

public boolean isUserRemovable(com.atlassian.user.User user)
                        throws com.atlassian.user.EntityException

Specified by:

isUserRemovable in interface UserAccessor

Overrides:

isUserRemovable in class DefaultUserAccessor

Throws:

com.atlassian.user.EntityException

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 UserAccessor

Overrides:

addMembership in class 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 UserAccessor

Overrides:

removeMembership in class 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.

getUserByName

public @Nullable ConfluenceUser getUserByName(String name)

Description copied from interface: UserAccessor

Returns the ConfluenceUser with the supplied user name or null if the user doesn't exist or the supplied name is null.

Note that user name lookups are case-insensitive, so the user you get back may not have exactly the same name as the name passed to this method.

Specified by:

getUserByName in interface ConfluenceUserResolver

Parameters:

name - the user name of the user

Returns:

the ConfluenceUser with the supplied user name or null.

getUserByKey

public @Nullable ConfluenceUser getUserByKey(com.atlassian.sal.api.user.UserKey key)

Description copied from interface: UserAccessor

Returns the user with the specified user key, or null if the user has never existed or the key is null.

WARNING: This method can return deleted users. Use UserAccessor.getExistingUserByKey(com.atlassian.sal.api.user.UserKey) to get only users that exist.

Specified by:

getUserByKey in interface ConfluenceUserResolver

isDeletedUser

public boolean isDeletedUser(ConfluenceUser user)

Check implementation is currently based on assumption that a deleted user is defined as a user with the same user key and user name. See ConfluenceUserDao.isDeletedUser(ConfluenceUser)

Specified by:

isDeletedUser in interface UserAccessorInternal

Parameters:

user - the user to check

Returns:

whether or not the user has been deleted

isUnsyncedUser

public boolean isUnsyncedUser(ConfluenceUser user)

Description copied from interface: UserAccessorInternal

Checks whether or not a user is unsynced

Specified by:

isUnsyncedUser in interface UserAccessorInternal

Parameters:

user - the user to check

Returns:

true if the user is unsynced, false otherwise (even if the user doesn't exist)

isCrowdManaged

public boolean isCrowdManaged(ConfluenceUser user)

Description copied from interface: UserAccessorInternal

Checks whether or not embedded Crowd manages/has knowledge of a given user

Specified by:

isCrowdManaged in interface UserAccessorInternal

Returns:

true if the user is managed by embedded Crowd, false otherwise (even if the user doesn't exist)

getExistingUserByKey

public @Nullable ConfluenceUser getExistingUserByKey(com.atlassian.sal.api.user.UserKey key)

Description copied from interface: UserAccessor

Returns the user with the specified user key, or null if the user doesn't exist or the key is null.

Specified by:

getExistingUserByKey in interface ConfluenceUserResolver

exists

public boolean exists(String name)

Description copied from interface: UserAccessor

Returns true if a user exists with the given username. This method is significantly faster than getUser(name) != null.

Parameters:

name - username of the user

Returns:

true if a user exists with the given username

createUser

public ConfluenceUser createUser(com.atlassian.user.User userTemplate,
                                 com.atlassian.user.security.password.Credential credential)

Description copied from interface: UserAccessor

Specified by:

createUser in interface UserAccessor

Overrides:

createUser in class DefaultUserAccessor

addGroup

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

Adds a group with the specified name.

Specified by:

addGroup in interface UserAccessor

Overrides:

addGroup in class 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(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 UserAccessor

Overrides:

createGroup in class DefaultUserAccessor

removeGroup

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

Description copied from interface: UserAccessor

Removes the specified group. Does nothing if the group does not exist.

Specified by:

removeGroup in interface UserAccessor

Overrides:

removeGroup in class 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.

Explicitly leaves user content permissions in place, so that removing a user does not automatically make restricted content public

Specified by:

removeUser in interface UserAccessor

Overrides:

removeUser in class DefaultUserAccessor

Throws:

IllegalArgumentException - if the specified user is null

InsufficientPrivilegeException - if the currently logged in user doesn't have permissions to remove this user. Check permissions using Permission.REMOVE and PermissionManager on the user first.

getUserNamesWithConfluenceAccess

@Transactional(readOnly=true,
               propagation=REQUIRES_NEW)
public List<String> getUserNamesWithConfluenceAccess()

Description copied from interface: UserAccessor

Returns the names of all users with access to use Confluence. If you only need to know the number of users, you should call UserChecker.getNumberOfRegisteredUsers(), as that caches its results.

See Also:

UserChecker

searchUnsyncedUsers

public com.atlassian.user.search.page.Pager<ConfluenceUser> searchUnsyncedUsers(String searchParam)

Description copied from interface: UserAccessorInternal

Returns a list of all users for the given username search parameter that are unsynced: a user whose account has been disconnected from an external directory, i.e. a user who has a known mapping but no backing user, but who has not yet been deleted from the application.

Specified by:

searchUnsyncedUsers in interface UserAccessorInternal

Parameters:

searchParam - the username parameter to search by

Returns:

a pager of all unknown / unsynced users

countLicenseConsumingUsers

@Transactional(readOnly=true,
               propagation=REQUIRES_NEW)
public int countLicenseConsumingUsers()

Description copied from interface: UserAccessor

Returns the number of users which have access to use Confluence AND consume a Confluence license. Callers are strongly recommended to use the UserChecker.getNumberOfRegisteredUsers() to retrieve this info, as that caches its results.

See Also:

UserChecker

getUsersWithConfluenceAccess

@Deprecated
 @Transactional(readOnly=true,
               propagation=REQUIRES_NEW)
public com.atlassian.user.search.page.Pager<com.atlassian.user.User> getUsersWithConfluenceAccess()

Deprecated. since 3.5.1. This method is very slow, use countUsersWithConfluenceAccess() if you need to know the number of users.

Returns all the users with access to use Confluence.

Specified by:

getUsersWithConfluenceAccess in interface UserAccessor

isDeactivated

public boolean isDeactivated(String username)

Description copied from interface: UserAccessor

Returns true if the user with the specified username exists and is unable to log in, otherwise false. Returns false if the username is null.

Specified by:

isDeactivated in interface UserAccessor

Returns:

true if the user with the specified username exists and is unable to log in, otherwise false.

isDeactivated

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

Description copied from interface: UserAccessor

Returns true if the user exists and is unable to log in, otherwise false. Returns false if the user is null.

Specified by:

isDeactivated in interface UserAccessor

Returns:

true if the user exists and is unable to log in, otherwise false.

savePersonalInformation

public void savePersonalInformation(PersonalInformation newInfo,
                                    PersonalInformation oldInfo)

deactivateUser

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

Description copied from interface: UserAccessor

Deactivate the specified user, which prevents them logging in. Does nothing if the user is already deactivated.

Specified by:

deactivateUser in interface UserAccessor

reactivateUser

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

Description copied from interface: UserAccessor

Marks the specified user as active, which allows them to log in. Does nothing if the user is already active.

Specified by:

reactivateUser in interface UserAccessor

isReadOnly

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

Description copied from interface: UserAccessor

Returns true if the user cannot be modified or removed. However, returning false does necessarily confirm that the user can be modified or removed. Depending on the user management configuration, it is not always possible for Confluence to determine whether a user is read-only.

In an internal-only user management configuration, this method always returns false.

isReadOnly

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

Description copied from interface: UserAccessor

Returns true if the group cannot be modified or removed. However, returning false does necessarily confirm that the group can be modified or removed. Depending on the user management configuration, it is not always possible for Confluence to determine whether a group is read-only. Indeed, groups can span across multiple directories with different access control mechanisms, so it may be possible to modify certain memberships of a group but not others.

In an internal-only user management configuration, this method always returns false.

getLogoForUser

public ProfilePictureInfo getLogoForUser(@Nullable com.atlassian.user.User user)

getUserProfilePicture

@Transactional(propagation=SUPPORTS)
public ProfilePictureInfo getUserProfilePicture(@Nullable com.atlassian.user.User user)

Description copied from interface: UserAccessor

Retrieve the path to a user's personal picture

Specified by:

getUserProfilePicture in interface UserProfilePictureAccessor

Parameters:

user - the user whose picture to look up.

Returns:

The path to a user's personal picture, or null if they don't have one set.

setUserProfilePicture

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

Description copied from interface: UserAccessor

Set the user profile picture to the given attachment. The attachment should be an image attached to that user's personal information, of size 48x48. No check is performed in this method that the image is valid or the right size.

Parameters:

user - the user to set a profile picture for

attachment - the attachment containing the user's profile picture

setUserProfilePicture

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

Description copied from interface: UserAccessor

Set the user profile picture to a built-in image. The path should be the web-application-root-relative path to the image to be used as the user's profile picture and should be size 48x48. Neither are checked by the implementation

Parameters:

user - the user to set a profile picture for

imagePath - the image path to that picture.

getAllDefaultGroupNames

@Deprecated
public List<String> getAllDefaultGroupNames()

Deprecated. Since 5.2. This method is vague and returns a collection containing the result of Settings.getDefaultUsersGroup() and UserAccessor.GROUP_CONFLUENCE_ADMINS. Clients should explicitly decide what they need and use that.

Description copied from interface: UserAccessor

Get the list of default group names.

Returns:

a list with the default group names.

getNewUserDefaultGroupName

@Deprecated
public String getNewUserDefaultGroupName()

Deprecated. since 5.2. Use Settings.getDefaultUsersGroup() via SettingsManager.getGlobalSettings().

Get the name of the default group for a new user.

Returns:

the default group for a new user.

isSuperUser

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

Description copied from interface: UserAccessor

Return true if the user is an all-powerful super-user (member of the confluence-administrators group).

Parameters:

user - the user to check for (the null user will always return false

Returns:

true if the user is a super-user, false otherwise.

getConfluenceUserPreferences

@Transactional(readOnly=true)
public ConfluenceUserPreferences getConfluenceUserPreferences(@Nullable com.atlassian.user.User user)

Specified by:

getConfluenceUserPreferences in interface UserPreferencesAccessor

getUserPreferences

public com.atlassian.core.user.preferences.UserPreferences getUserPreferences(com.atlassian.user.User user)

Specified by:

getUserPreferences in interface UserAccessor

Overrides:

getUserPreferences in class DefaultUserAccessor

getPropertySet

public com.opensymphony.module.propertyset.PropertySet getPropertySet(com.atlassian.user.User user)

Specified by:

getPropertySet in interface UserAccessor

Overrides:

getPropertySet in class DefaultUserAccessor

getGroupNames

public List<String> getGroupNames(com.atlassian.user.User user)

Description copied from interface: UserAccessor

Gets the list of group names representing the groups the passed in user is a member of.

Parameters:

user - the user to perform the membership check for

Returns:

a list of group names

getGroupNamesForUserName

public List<String> getGroupNamesForUserName(String userName)

Description copied from interface: UserAccessor

Gets the list of group names representing the groups the passed in user is a member of.

Parameters:

userName - the name of the user to perform the membership check for

Returns:

a list of group names

getGroupsAsList

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

getGroup

public com.atlassian.user.Group getGroup(String name)

Description copied from interface: UserAccessor

Returns the group with the specified name, or null if the user doesn't exist or the name is null.

Specified by:

getGroup in interface UserAccessor

Specified by:

getGroup in interface GroupResolver

Overrides:

getGroup in class DefaultUserAccessor

getMemberNames

public com.atlassian.user.search.page.Pager<String> getMemberNames(com.atlassian.user.Group group)

Description copied from interface: UserAccessor

Returns a pager containing the usernames of users who are members of the specified group (either directly or as a member of a nested group). Returns an empty pager if the group has no members or doesn't exist.

Specified by:

getMemberNames in interface UserAccessor

Specified by:

getMemberNames in interface GroupMembershipAccessor

Overrides:

getMemberNames in class DefaultUserAccessor

getMemberNamesAsList

public List<String> getMemberNamesAsList(com.atlassian.user.Group group)

Description copied from interface: UserAccessor

Same as UserAccessor.getMemberNames(com.atlassian.user.Group) but returns a List of user names as Strings rather than a Pager.

Specified by:

getMemberNamesAsList in interface GroupMembershipAccessor

Parameters:

group - to retrieve the member names from

Returns:

a list of Strings

getMembers

public Iterable<ConfluenceUser> getMembers(com.atlassian.user.Group group)

Description copied from interface: UserAccessor

Returns users who are members of the specified group (either directly or as a member of a nested group). Returns an empty iterable if the group is null or the group doesn't exist.

Elements are generated on demand and it is recommended to fetch only as many elements as are needed.

Parameters:

group - group to get members for

Returns:

users who are members of the specified group

getWriteableGroups

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

Description copied from interface: UserAccessor

Gets all editable groups. That is, returns any groups that belong to read/write repositories. Groups in readonly repositories that are ReadOnly are not returned.

Returns:

list of Groups that can be edited.

getPropertySet

@Transactional(readOnly=true)
public com.opensymphony.module.propertyset.PropertySet getPropertySet(ConfluenceUser user)

Returns:

the property set for the supplied user

findUsersAsList

public List<com.atlassian.user.User> findUsersAsList(com.atlassian.user.search.query.Query<com.atlassian.user.User> search)
                                              throws com.atlassian.user.EntityException

Throws:

com.atlassian.user.EntityException

findUsers

public com.atlassian.user.search.SearchResult<com.atlassian.user.User> findUsers(com.atlassian.user.search.query.Query<com.atlassian.user.User> query)
                                                                          throws com.atlassian.user.EntityException

Specified by:

findUsers in interface UserAccessor

Specified by:

findUsers in interface com.atlassian.user.search.query.EntityQueryParser

Overrides:

findUsers in class DefaultUserAccessor

Throws:

com.atlassian.user.EntityException

renameUser

public ConfluenceUser renameUser(ConfluenceUser user,
                                 String newUsername)
                          throws com.atlassian.user.EntityException

Description copied from interface: UserAccessor

Updates the username of the given user.

Parameters:

user - user to rename

newUsername - username to use for renaming

Returns:

renamed user

Throws:

com.atlassian.user.impl.EntityValidationException - if the new username does not meet the username requirements

com.atlassian.user.EntityException - if the operation is not allowed for the user

com.atlassian.user.impl.DuplicateEntityException - if the username is already taken

getGroupsByGroupNames

public List<com.atlassian.user.Group> getGroupsByGroupNames(List<String> groupNames)

Description copied from interface: UserAccessor

Returns a list of Group objects where the names match that of the provided list of group names. If no names are provided an empty list will be returned.

Parameters:

groupNames - the list group names for which the matching Group objects must be returned

Returns:

the list of resolved groups

getUsersByUserKeys

public List<ConfluenceUser> getUsersByUserKeys(List<com.atlassian.sal.api.user.UserKey> userKeys)

Description copied from interface: UserAccessor

Returns a list of ConfluenceUser with the supplied UserKeys or an empty list if the users do not exist. This method returns ConfluenceUser instances with pre-populated backing EmbeddedCrowdUser.

Specified by:

getUsersByUserKeys in interface ConfluenceUserResolver

Parameters:

userKeys - the user keys

Returns:

the list of ConfluenceUsers with UserKeys

getExistingUserByPerson

public @Nullable ConfluenceUser getExistingUserByPerson(@NonNull Person person)

Description copied from interface: UserAccessorInternal

Retrieve the corresponding ConfluenceUser (if any) for a Person, by username, or user key

Specified by:

getExistingUserByPerson in interface UserAccessorInternal

Specified by:

getExistingUserByPerson in interface ConfluenceUserResolver

Parameters:

person - the person whose corresponding ConfluenceUser should be retrieved

Returns:

Person as a confluence user, or null if user doesn't exist or if person is Anonymous

getExistingByApiUser

public Optional<ConfluenceUser> getExistingByApiUser(User user)

Description copied from interface: UserAccessorInternal

Retrieve the corresponding ConfluenceUser (if any) for a user, by user key or username

One of username or userkey must be set on the user object.

This method differs from UserAccessorInternal.getExistingUserByPerson(com.atlassian.confluence.api.model.people.Person) in its handling of anonymous, it is not possible to retrieve an anonymous user from this method. When a Option.none() is returned from this method it indicates that the user was not found in the user repository.

Specified by:

getExistingByApiUser in interface UserAccessorInternal

Specified by:

getExistingByApiUser in interface ConfluenceUserResolver

Parameters:

user - the user whose corresponding ConfluenceUser should be retrieved

Returns:

an optional confluence user if the user is found by userkey or username

countUnsyncedUsers

public int countUnsyncedUsers()

Description copied from interface: UserAccessor

Get a count of all unsynced users in Confluence. An unsynced user is a user that was managed in an external directory but has since been removed from the directory without being deleted in Confluence.

Returns:

the total number of all unsynced users.

getUsersByEmail

public com.atlassian.user.search.SearchResult getUsersByEmail(String email)

Specified by:

getUsersByEmail in interface UserAccessor

Overrides:

getUsersByEmail in class DefaultUserAccessor

alterPassword

public void alterPassword(com.atlassian.user.User user,
                          String plainTextPassword,
                          String token)
                   throws com.atlassian.user.EntityException

Throws:

com.atlassian.user.EntityException

alterPassword

public void alterPassword(com.atlassian.user.User user,
                          String plainTextPassword)
                   throws com.atlassian.user.EntityException

Specified by:

alterPassword in interface UserAccessor

Overrides:

alterPassword in class DefaultUserAccessor

Throws:

com.atlassian.user.EntityException