Package com.atlassian.confluence.user

Interface UserAccessor

All Superinterfaces:
ConfluenceUserResolver, com.atlassian.user.search.query.EntityQueryParser, GroupMembershipAccessor, GroupResolver, UserExistenceChecker, UserPreferencesAccessor, UserProfilePictureAccessor
All Known Subinterfaces:
UserAccessorInternal
All Known Implementing Classes:
DefaultUserAccessor, ReadOnlyUserAccessor
public interface UserAccessor extends com.atlassian.user.search.query.EntityQueryParser, UserPreferencesAccessor, ConfluenceUserResolver, UserProfilePictureAccessor, GroupResolver, GroupMembershipAccessor, UserExistenceChecker
This interface will be deprecated and removed in a future release once alternatives are made available. It is a combination of several interfaces that are more specific and should be used instead.

  • Field Details

    • GROUP_CONFLUENCE_USERS

      @Deprecated static final String GROUP_CONFLUENCE_USERS
      Deprecated.
      since 5.2. Use @link{com.atlassian.confluence.setup.settings.Settings#getDefaultUsersGroup()} instead.
      See Also:

    • GROUP_CONFLUENCE_ADMINS

      static final String GROUP_CONFLUENCE_ADMINS
      The name of the group with special administration privileges in the application.
      See Also:

    • DEFAULT_GROUP_NAMES

      @Deprecated static final List<String> DEFAULT_GROUP_NAMES
      Deprecated.
      since 5.2. Use getAllDefaultGroupNames() instead.

    • PROFILE_PICTURE_BUILTIN_PATH

      static final String PROFILE_PICTURE_BUILTIN_PATH
      Relative path to default profile pictures in the web application, used to determine whether a user has uploaded a custom profile picture.
      See Also:

  • Method Details

    • getUser

      @Deprecated com.atlassian.user.User getUser(String name)
      Deprecated.
      since 5.2. See ConfluenceUserResolver.getUserByName(String)
      Returns the user with the specified name, or null if the user doesn't exist or the name is null. Note that use rname lookups are case-insensitive, so the user you get back may not have exactly the same name as the name passed to this method.
      Parameters:
      name - the user name of the user
      Returns:
      the User with the supplied user name or null.

    • createUser

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

    • isReadOnly

      boolean isReadOnly(com.atlassian.user.User user)
      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

      boolean isReadOnly(com.atlassian.user.Group group)
      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.

    • isSuperUser

      @Deprecated boolean isSuperUser(com.atlassian.user.User user)
      Deprecated.
      since 3.5
      Return true is the user is a super user. This should not be used to infer any special permission exempt behaviours. In general, relying on group memberships for special behaviour is a bad idea. Permission checks in the application like
      invalid reference 
      com.atlassian.confluence.security.PermissionManager#hasPermission(User, Permission, Object)
      already take care of super-user permission exempt checks and more. If checking for exemption from any permission checks is still required explicitly, use
      invalid reference 
      com.atlassian.confluence.security.PermissionManager#isConfluenceAdministrator(User)
      instead. It also takes care of more checks than a group-membership for permission exemption. e.g. Checking exemptions before applying permission related query and/or filter, see AlphabeticalListPagesAction.getFilter(ConfluenceUser)
      Parameters:
      user - the user to check for (the null user will always return false)
      Returns:
      true if the user is super-user, false otherwise.

    • getGroupsAsList

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

    • getMemberNamesAsList

      List<String> getMemberNamesAsList(com.atlassian.user.Group group)
      Same as GroupMembershipAccessor.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

      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). 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

    • getMembers

      Iterable<ConfluenceUser> getMembers(com.atlassian.user.Group group, int limit)
      Returns users who are members of the specified group. This API will only return users upto the given limit (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
      limit - maximum number of users to return
      Returns:
      users who are members of the specified group

    • getGroupNames

      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.
      Parameters:
      user - the user to perform the membership check for
      Returns:
      a list of group names

    • getGroupNamesForUserName

      List<String> getGroupNamesForUserName(String userName)
      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

    • getWriteableGroups

      List<com.atlassian.user.Group> getWriteableGroups()
      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

      @Deprecated(forRemoval=true) com.opensymphony.module.propertyset.PropertySet getPropertySet(ConfluenceUser user)
      Deprecated, for removal: This API element is subject to removal in a future version.
      since 7.7, read-only from 10.0, for removal in 11.0. Use UserPreferencesAccessor.getUserPreferences(ConfluenceUser) instead.
      Returns:
      the property set for the supplied user
      Since:
      5.2

    • getUserNamesWithConfluenceAccess

      List<String> getUserNamesWithConfluenceAccess()
      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:

    • countLicenseConsumingUsers

      int countLicenseConsumingUsers()
      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.
      Since:
      5.5
      See Also:

    • findUsersAsList

      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

    • setUserProfilePicture

      void setUserProfilePicture(com.atlassian.user.User user, Attachment attachment)
      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
      Throws:
      IllegalArgumentException - if the image is not attached to the user's personal information

    • setUserProfilePicture

      void setUserProfilePicture(com.atlassian.user.User targetUser, String imagePath)
      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:
      targetUser - the user to set a profile picture for
      imagePath - the image path to that picture.

    • getAllDefaultGroupNames

      @Deprecated List<String> getAllDefaultGroupNames()
      Deprecated.
      Since 5.2. This method is vague and returns a collection containing the result of Settings.getDefaultUsersGroup() and GROUP_CONFLUENCE_ADMINS. Clients should explicitly decide what they need and use that.
      Get the list of default group names.
      Returns:
      a list with the default group names.

    • getNewUserDefaultGroupName

      @Deprecated 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.

    • renameUser

      ConfluenceUser renameUser(ConfluenceUser user, String newUsername) throws com.atlassian.user.EntityException
      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
      UserManagementOperationFailedException - if the operation fails for unknown reason
      com.atlassian.user.impl.DuplicateEntityException - if the username is already taken
      Since:
      5.2

    • getGroupsByGroupNames

      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. 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
      Since:
      7.5.0

    • countUnsyncedUsers

      int countUnsyncedUsers()
      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.
      Since:
      6.13.0

    • isLicensedToAddMoreUsers

      @Deprecated boolean isLicensedToAddMoreUsers()
      Deprecated.
      since 7.17 use UserChecker.isLicensedToAddMoreUsers()

    • isDeactivated

      @Deprecated boolean isDeactivated(com.atlassian.user.User user)
      Deprecated.
      since 7.17 Use DisabledUserManager.isDisabled(User)

    • isDeactivated

      @Deprecated boolean isDeactivated(String username)
      Deprecated.
      since 7.17 Use DisabledUserManager.isDisabled(String)

    • alterPassword

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

    • deactivateUserLocally

      void deactivateUserLocally(com.atlassian.user.User user) throws com.atlassian.user.EntityException
      Deactivate the specified user, which prevents them logging in. Does nothing if the user is already deactivated. This only deactivates the user from local confluence db, even if the user is coming from remote directory
      Parameters:
      user - the User to be deactivated
      Throws:
      com.atlassian.user.impl.EntityValidationException - if the user is invalid or cannot be deactivated
      com.atlassian.user.EntityException

    • reactivateUserLocally

      void reactivateUserLocally(com.atlassian.user.User user) throws com.atlassian.user.EntityException
      Marks the specified user as active, which allows them to log in. Does nothing if the user is already active. This only activates the user from local confluence db, even if the user is coming from remote directory
      Parameters:
      user - the User to be reactivated
      Throws:
      com.atlassian.user.impl.EntityValidationException - if the user is invalid or cannot be reactivated
      com.atlassian.user.EntityException

    • addUser

      @Deprecated com.atlassian.user.User addUser(String username, String password, String email, String fullname, String[] groups)
      Deprecated.
      since 3.5 use createUser(User, Credential) and addMembership(Group, User)

    • addUser

      @Deprecated com.atlassian.user.User addUser(String username, String password, String email, String fullname)
      Deprecated.
      since 3.5 use createUser(User, Credential)

    • getUserNames

      com.atlassian.user.search.page.Pager<String> getUserNames()
      Returns a pager of all usernames in the system. Clients should not normally use this method, but perform a search using EntityQueryParser.findUsers(Query) or the CrowdService API instead.

    • getUsers

      com.atlassian.user.search.page.Pager<com.atlassian.user.User> getUsers()
      Returns a pager of all users in the system. Clients should not normally use this method, but perform a search using EntityQueryParser.findUsers(Query) or the CrowdService API instead.

    • getGroups

      com.atlassian.user.search.page.Pager<com.atlassian.user.Group> getGroups()
      Returns a pager of all groups in the system. Clients should not normally use this method, but perform a search using EntityQueryParser.findGroups(Query) or the CrowdService API instead.

    • addGroup

      com.atlassian.user.Group addGroup(String name)
      Creates a group with the specified name and returns it.
      Throws:
      IllegalArgumentException - if the group name is empty or null
      com.atlassian.core.exception.InfrastructureException - if the group could not be created

    • removeGroup

      void removeGroup(com.atlassian.user.Group group)
      Removes the specified group. Does nothing if the group does not exist.
      Throws:
      com.atlassian.core.exception.InfrastructureException - if the group could not be removed

    • removeUser

      void removeUser(com.atlassian.user.User user) throws com.atlassian.core.exception.InfrastructureException
      Removes the specified user. Does nothing if the user does not exist.
      Throws:
      com.atlassian.core.exception.InfrastructureException - if the user could not be removed

    • getGroupCreateIfNecessary

      com.atlassian.user.Group getGroupCreateIfNecessary(String name)

    • saveUser

      void saveUser(com.atlassian.user.User user)
      Persists changes made to a user (e.g. changing email or full name).
      Throws:
      com.atlassian.core.exception.InfrastructureException - if the user could not be updated successfully

    • getUsersByEmail

      com.atlassian.user.search.SearchResult<com.atlassian.user.User> getUsersByEmail(String email)

    • deactivateUser

      void deactivateUser(com.atlassian.user.User user)
      Deactivate the specified user, which prevents them logging in. Does nothing if the user is already deactivated.

    • reactivateUser

      void reactivateUser(com.atlassian.user.User user)
      Marks the specified user as active, which allows them to log in. Does nothing if the user is already active.

    • isUserRemovable

      boolean isUserRemovable(com.atlassian.user.User user) throws com.atlassian.user.EntityException
      Throws:
      com.atlassian.user.EntityException

    • getGroups

      com.atlassian.user.search.page.Pager<com.atlassian.user.Group> getGroups(com.atlassian.user.User user)

    • hasMembership

      boolean hasMembership(com.atlassian.user.Group group, com.atlassian.user.User user)
      Returns true if the specified user and group both exist, and the user is a member of the group (either directly or as a member of a nested group). In all other circumstances, returns false.

    • hasMembership

      boolean hasMembership(String groupName, String username)
      Returns true if the specified user and group both exist, and the user is a member of the group (either directly or as a member of a nested group). In all other circumstances, returns false.

    • addMembership

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

    • addMembership

      void addMembership(String groupname, String username)

    • removeMembership

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

    • createGroup

      com.atlassian.user.Group createGroup(String groupname)

    • authenticate

      boolean authenticate(String username, String password)

    • alterPassword

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

    • removeMembership

      boolean removeMembership(String groupname, String username)