Class PersonServiceImpl

java.lang.Object
com.atlassian.confluence.api.impl.service.people.PersonServiceImpl
All Implemented Interfaces:
PersonService

public class PersonServiceImpl extends Object implements PersonService
  • Constructor Details

  • Method Details

    • create

      public UserKey create(UserDetailsForCreation userDetailsForCreation)
      Description copied from interface: PersonService
      Create a new active user
      Specified by:
      create in interface PersonService
      Parameters:
      userDetailsForCreation - User Details
      Returns:
      UserKey User Key
    • getCurrentUser

      public Person getCurrentUser(Expansion... expansions)
      Description copied from interface: PersonService
      Get the currently logged in user
      Specified by:
      getCurrentUser in interface PersonService
    • find

      public PersonService.PersonFinder find(Expansion... expansions)
      Description copied from interface: PersonService
      Create a person finder to locate persons Restrictions can be applied to the finder using the appropriate withFoo() method

      For example:

       personService.find()
            .withKey("DEV")
            .fetchOne()
       
       
      Specified by:
      find in interface PersonService
      Returns:
      a new PersonFinder
    • fetchActiveUsers

      public PageResponse<Person> fetchActiveUsers(PageRequest request)
      Description copied from interface: PersonService
      Fetch a page of active users (users which count towards the license limit). The page is ordered by last login date, ascending with people who never logged in first. The results will exclude users that are: - anonymous, - deactivated, - externally deleted, - shadowed - unlicensed This feature relies on search index and might not be accurate when site reindex is in progress.
      Specified by:
      fetchActiveUsers in interface PersonService
      Parameters:
      request - The page request
      Returns:
      a page of active users
    • disable

      public void disable(String username)
      Description copied from interface: PersonService
      Disable the given User identified by username. This method is idempotent i.e. if the user is already disabled then no action will be taken.
      Specified by:
      disable in interface PersonService
      Parameters:
      username - The username identifying the given user.
    • enable

      public void enable(String username)
      Description copied from interface: PersonService
      Enable the given User identified by username. This method is idempotent i.e. if the user is already enabled then no action will be taken.
      Specified by:
      enable in interface PersonService
      Parameters:
      username - The username identifying the given user.
    • update

      public void update(UserDetailsForUpdate userDetailsForUpdate)
      Description copied from interface: PersonService
      Update the current user with the supplied details (full name or email).
      Specified by:
      update in interface PersonService
      Parameters:
      userDetailsForUpdate - User Details
    • update

      public void update(String username, UserDetailsForUpdate userDetailsForUpdate)
      Description copied from interface: PersonService
      Update the given user with the supplied details (full name or email).
      Specified by:
      update in interface PersonService
      Parameters:
      username - The username identifying the given user.
      userDetailsForUpdate - User Details
    • delete

      public LongTaskSubmission delete(Person personToDelete)
      Description copied from interface: PersonService
      Delete the given person.

      The deletion happens asynchronously so a LongTaskSubmission is returned, that can be used to track progress.

      Specified by:
      delete in interface PersonService
      Parameters:
      personToDelete - the person to delete
      Returns:
      a LongTaskSubmission describing the user deletion operation
    • search

      Description copied from interface: PersonService
      Create a person searcher to find people matching search criteria For given search category and/or criteria, return all People matching the supplied criteria.

      For example:

       personService.search()
            .forUnsyncedUsers("joe")
            .fetchMany(..)
       
       
      Specified by:
      search in interface PersonService
      Returns:
      a new PersonSearcher
    • addMembership

      public void addMembership(String username, String groupName)
      Description copied from interface: PersonService
      Add the given User identified by username to the given Group identified by groupName. This method is idempotent i.e. if the membership already exists then no action will be taken.
      Specified by:
      addMembership in interface PersonService
      Parameters:
      username - The username identifying the given user.
      groupName - The group name identifying the given group.
    • removeMembership

      public void removeMembership(String username, String groupName)
      Description copied from interface: PersonService
      Remove the given User identified by username from the given Group identified by groupName. This method is idempotent i.e. if the membership is not present then no action will be taken.
      Specified by:
      removeMembership in interface PersonService
      Parameters:
      username - The username identifying the given user.
      groupName - The group name identifying the given group.
    • changeUserPassword

      public void changeUserPassword(String userName, String newPass)
      Description copied from interface: PersonService
      Change the password of the given user.
      Specified by:
      changeUserPassword in interface PersonService
      Parameters:
      userName - The userName identifying the given user.
      newPass - New Password
    • changeMyPassword

      public void changeMyPassword(PasswordChangeDetails passwordChangeDetails)
      Description copied from interface: PersonService
      Change the password of the current user.
      Specified by:
      changeMyPassword in interface PersonService
      Parameters:
      passwordChangeDetails - password change details
    • validator

      public PersonService.Validator validator()
      Description copied from interface: PersonService
      Get the validator of the Person Service.
      Specified by:
      validator in interface PersonService