Interface User

All Superinterfaces:
Principal

public interface User extends Principal
This interface provides read access to user data and is an extension of Principal.
  • Method Details

    • checkPassword

      PasswordCheckResult checkPassword(char[] password) throws PersistenceException
      Deprecated.
      As of version 1.8, replaced by UserProvider.checkUserPassword(String, char[])
      Throws:
      PersistenceException
    • getAttribute

      String getAttribute(String attributeName) throws UnsupportedUserAttributeException
      Returns the value of the provided attribute. If the attribute does not exist or no value is maintained, null is returned.
      Parameters:
      attributeName - The system-specific alias of the attribute to read.
      Returns:
      The value of the attribute or null.
      Throws:
      UnsupportedUserAttributeException - If the method is called with the attribute name which is not supported by the user store.
    • listAttributes

      Set<String> listAttributes()
      Returns a set of system-specific aliases of all attributes of this user.
      Returns:
      A set of attributes of this user.
    • getLocale

      Locale getLocale()
      Returns the locale of the user or null, if no locale is maintained for the user.
      Returns:
      The locale or null.
    • hasRole

      boolean hasRole(String roleName)
      Returns whether the user is assigned to the role with the provided name. The result does not depend on the existence of the role with the specified role name. So this method might return true, if the role is already deleted, but the user is still assigned.
      Parameters:
      roleName - The name of the role to check.
      Returns:
      True if the user is assigned to the role, otherwise false.
    • isValid

      boolean isValid(Calendar date)
      Returns the user's validity at the specified point in time. This method is usually used with the current time to check whether the user is allowed to access the system.
      Parameters:
      date - The date for which the validity should be checked.
      Returns:
      True if the user is valid on the specified point in time, otherwise false.
    • getRoles

      Set<String> getRoles()
      Returns a set of roles assigned to the user.
      Returns:
      A set of roles assigned to the user.
    • getAttributeValues

      String[] getAttributeValues(String attributeName)
      Returns an array of values for an attribute. If it does not exist or no value is maintained, null is returned.
      Parameters:
      attributeName - The alias of the attribute to read.
      Returns:
      The value of the attribute or null.
    • getGroups

      Set<String> getGroups()
      Returns the groups in which the user is included.