Class User

java.lang.Object
com.erudika.para.core.User
All Implemented Interfaces:
Linkable, ParaObject, Votable, Serializable
public class User extends Object implements ParaObject
The core user object. Stores information about users.
Author:
Alex Bogdanovski [[email protected]]
See Also:

  • Field Details

    • MAX_PASSWORD_LENGTH

      public static final int MAX_PASSWORD_LENGTH
      Maximum password length.
      See Also:

  • Constructor Details

    • User

      public User()
      No-args constructor.

    • User

      public User(String id)
      Default constructor.
      Parameters:
      id - the id

  • Method Details

    • getTokenSecret

      public String getTokenSecret()
      Token secret - used for generating JWT tokens. Changing this secret would invalidate all existing user tokens. A kind of global "logout".
      Returns:
      a random string

    • setTokenSecret

      public void setTokenSecret(String tokenSecret)
      Sets the token secret.
      Parameters:
      tokenSecret - a random string

    • getPicture

      public String getPicture()
      The profile picture URL.
      Returns:
      a URL or null

    • setPicture

      public void setPicture(String picture)
      Sets the profile picture URL.
      Parameters:
      picture - the picture URL.

    • getActive

      public Boolean getActive()
      Returns true if this account is active.
      Returns:
      true if active

    • setActive

      public void setActive(Boolean active)
      Sets the account active.
      Parameters:
      active - true if active

    • getTwoFA

      public Boolean getTwoFA()
      Returns true if 2FA is enabled.
      Returns:
      true if 2FA is enabled

    • setTwoFA

      public void setTwoFA(Boolean twoFA)
      Sets 2FA enabled/disabled.
      Parameters:
      twoFA - true if 2FA is enabled

    • getTwoFAkey

      public String getTwoFAkey()
      Returns the 2FA secret key. Used for checking the TOTP code.
      Returns:
      the 2FA secret key. Used for checking the TOTP code.

    • setTwoFAkey

      public void setTwoFAkey(String twoFAkey)
      Sets the 2FA secret key.
      Parameters:
      twoFAkey - secret key

    • getTwoFAbackupKeyHash

      public String getTwoFAbackupKeyHash()
      Returns the hashed backup key (shown only once). Used for disabling 2FA.
      Returns:
      the hashed backup key (shown only once). Used for disabling 2FA.

    • setTwoFAbackupKeyHash

      public void setTwoFAbackupKeyHash(String twoFAbackupKeyHash)
      Sets the 2FA backup key hash.
      Parameters:
      twoFAbackupKeyHash - bcrypt hash

    • getGroups

      public String getGroups()
      Returns the security groups for this user.
      Returns:
      the groups string

    • setGroups

      public void setGroups(String groups)
      Sets the security groups for this user.
      Parameters:
      groups - the groups string

    • getIdentifier

      public String getIdentifier()
      Returns the main identifier for this user. An identifier is basically a unique username that identifies a user.
      Returns:
      the main identifier

    • setIdentifier

      public void setIdentifier(String identifier)
      Sets the main identifier.
      Parameters:
      identifier - the main identifier

    • getEmail

      public String getEmail()
      The user's email.
      Returns:
      email

    • setEmail

      public void setEmail(String email)
      Sets the email.
      Parameters:
      email - email

    • getCurrency

      public String getCurrency()
      The user's currency preference.
      Returns:
      a currency 3-letter code in uppercase

    • setCurrency

      public void setCurrency(String currency)
      Sets a preferred currency. Default is "EUR".
      Parameters:
      currency - a 3-letter currency code

    • resetTokenSecret

      public void resetTokenSecret()
      Generates a new token secret. This is whould be equivalent to "logout everywhere".

    • canModify

      public boolean canModify(ParaObject obj)
      Note: this method assumes that child objects can be modified by their parents. This might not work for special cases where a parent has no rights over a child.
      Parameters:
      obj - an object
      Returns:
      true if the user is the creator or parent of this object or an admin user

    • create

      public String create()
      Description copied from interface: ParaObject
      Stores this object in the data store.
      Specified by:
      create in interface ParaObject
      Returns:
      the id of the object (a new id if object is new)
      See Also:

    • delete

      public void delete()
      Description copied from interface: ParaObject
      Deletes the object permanently by removing it from the data store.
      Specified by:
      delete in interface ParaObject
      See Also:

    • attachIdentifier

      public void attachIdentifier(String identifier)
      Attaches a new identifier to this user.
      Parameters:
      identifier - a new identifier

    • detachIdentifier

      public void detachIdentifier(String identifier)
      Detaches a secondary identifier which is not already used by this user.
      Parameters:
      identifier - an attached identifier

    • isFacebookUser

      public boolean isFacebookUser()
      Is the main identifier a Facebook id.
      Returns:
      true if user is signed in with Facebook

    • isGooglePlusUser

      public boolean isGooglePlusUser()
      Is the main identifier a Google+ id.
      Returns:
      true if user is signed in with Google+

    • isLinkedInUser

      public boolean isLinkedInUser()
      Is the main identifier a LinkedIn id.
      Returns:
      true if user is signed in with LinkedIn

    • isTwitterUser

      public boolean isTwitterUser()
      Is the main identifier a Twitter id.
      Returns:
      true if user is signed in with Twitter

    • isGitHubUser

      public boolean isGitHubUser()
      Is the main identifier a GitHub id.
      Returns:
      true if user is signed in with GitHub

    • isMicrosoftUser

      public boolean isMicrosoftUser()
      Is the main identifier a Microsoft/Windows account id.
      Returns:
      true if user is signed in with a Microsoft account

    • isSlackUser

      public boolean isSlackUser()
      Is the main identifier a Slack account id.
      Returns:
      true if user is signed in with a Slack account

    • isMattermostUser

      public boolean isMattermostUser()
      Is the main identifier a Mattermost account id.
      Returns:
      true if user is signed in with a Mattermost account

    • isAmazonUser

      public boolean isAmazonUser()
      Is the main identifier a Amazon account id.
      Returns:
      true if user is signed in with a Amazon account

    • isLDAPUser

      public boolean isLDAPUser()
      Is the main identifier a LDAP account.
      Returns:
      true if user is signed in with a LDAP account

    • isSAMLUser

      public boolean isSAMLUser()
      Is the main identifier a SAML account.
      Returns:
      true if user is signed in with a SAML account

    • isPasswordlessUser

      public boolean isPasswordlessUser()
      Is the main identifier a custom SSO account.
      Returns:
      true if user is signed in with a custom SSO JWT token

    • isOAuth2User

      public boolean isOAuth2User()
      Is the main identifier from a generic OAuth 2.0/OpenID Connect provider.
      Returns:
      true if user is signed in with a generic OAauth 2.0 account

    • isAdmin

      public boolean isAdmin()
      Checks for admin rights.
      Returns:
      true if user has admin rights

    • isModerator

      public boolean isModerator()
      Checks for moderator rights.
      Returns:
      true if user has mod rights

    • getIdentityProvider

      public String getIdentityProvider()
      Returns the name of the identity provider.
      Returns:
      "facebook", "google"... etc.

    • hasValidIdentifier

      public boolean hasValidIdentifier()
      Validates the identifier property value.
      Returns:
      true if the user identifier has valid syntax.

    • getPassword

      public String getPassword()
      The password. A transient field used for validation.
      Returns:
      the password.

    • setPassword

      public void setPassword(String password)
      Sets a password.
      Parameters:
      password - a password

    • getIdpIdToken

      public String getIdpIdToken()
      Used for storing the ID token from an OpenID Connect/OAuth 2.0 identity provider.
      Returns:
      an ID token (JWT is always assumed to be the format)

    • setIdpIdToken

      public void setIdpIdToken(String idpIdToken)
      Sets the IDP ID token.
      Parameters:
      idpIdToken - a token

    • getIdpAccessToken

      public String getIdpAccessToken()
      Used for storing the access token from an OpenID Connect/OAuth 2.0 identity provider.
      Returns:
      a JWT access token (JWT is always assumed to be the format)

    • setIdpAccessToken

      public void setIdpAccessToken(String idpAccessToken)
      Sets the IDP access token.
      Parameters:
      idpAccessToken - a token

    • getIdpRefreshToken

      public String getIdpRefreshToken()
      Stores the refresh token from the identity provider.
      Returns:
      a JWT refresh token

    • setIdpRefreshToken

      public void setIdpRefreshToken(String idpRefreshToken)
      Sets the refresh token.
      Parameters:
      idpRefreshToken - a refresh token

    • getIdpIdTokenPayload

      public String getIdpIdTokenPayload()
      Returns the JWT payload for the ID token coming from the IDP. Used for delegating user attributes data to clients. This must be a Base64-encoded JSON string.
      Returns:
      the payload part in Base64

    • getIdpAccessTokenPayload

      public String getIdpAccessTokenPayload()
      Returns the JWT payload for the access token coming from the IDP. Used for delegating user attributes data to clients. This must be a Base64-encoded JSON string.
      Returns:
      the payload part in Base64

    • readUserForIdentifier

      public static final User readUserForIdentifier(User u)
      Returns a user object for a given identifier.
      Parameters:
      u - a user having a valid identifier set.
      Returns:
      a user or null if no user is found for this identifier

    • passwordMatches

      public static final boolean passwordMatches(User u) throws RateLimitException
      Checks if a user has entered the correct password. Compares password hashes.
      Parameters:
      u - a user with a set password
      Returns:
      true if password matches the one in the data store
      Throws:
      RateLimitException - if rate limit is exceeded when password doesn't match.

    • generatePasswordResetToken

      public final String generatePasswordResetToken()
      Generates a new password reset token. Sent via email for pass reset.
      Returns:
      the pass reset token

    • resetPassword

      public final boolean resetPassword(String token, String newpass)
      Changes the user password permanently.
      Parameters:
      token - the reset token. see generatePasswordResetToken()
      newpass - the new password
      Returns:
      true if successful

    • generateEmailConfirmationToken

      public String generateEmailConfirmationToken()
      Generates a new email confirmation token. Sent via email for user activation.
      Returns:
      a Base64 encoded UUID

    • activateWithEmailToken

      public final boolean activateWithEmailToken(String token)
      Activates a user if a given token matches the one stored.
      Parameters:
      token - the email confirmation token. see generateEmailConfirmationToken()
      Returns:
      true if successful

    • isValidPasswordResetToken

      public final boolean isValidPasswordResetToken(String token)
      Validates a token sent via email for password reset.
      Parameters:
      token - a token
      Returns:
      true if valid

    • isValidEmailConfirmationToken

      public final boolean isValidEmailConfirmationToken(String token)
      Validates a token sent for email confirmation.
      Parameters:
      token - a token
      Returns:
      true if valid

    • getId

      public final String getId()
      Returns the object ID.
      Specified by:
      getId in interface ParaObject
      Returns:
      the id

    • setId

      public final void setId(String id)
      Sets the object ID.
      Specified by:
      setId in interface ParaObject
      Parameters:
      id - the id

    • getType

      public final String getType()
      Returns the object type.
      Specified by:
      getType in interface ParaObject
      Returns:
      the type

    • setType

      public final void setType(String type)
      Sets the object type.
      Specified by:
      setType in interface ParaObject
      Parameters:
      type - the type

    • getAppid

      public String getAppid()
      Returns the app identifier.
      Specified by:
      getAppid in interface ParaObject
      Returns:
      the appid

    • setAppid

      public void setAppid(String appid)
      Sets the app identifier.
      Specified by:
      setAppid in interface ParaObject
      Parameters:
      appid - the appid

    • getObjectURI

      public String getObjectURI()
      Returns the object URI.
      Specified by:
      getObjectURI in interface ParaObject
      Returns:
      the URI
      See Also:

    • getTags

      public List<String> getTags()
      Returns the tags.
      Specified by:
      getTags in interface ParaObject
      Returns:
      the tags
      See Also:

    • setTags

      public void setTags(List<String> tags)
      Sets the tags.
      Specified by:
      setTags in interface ParaObject
      Parameters:
      tags - the tags

    • getStored

      public Boolean getStored()
      Returns true if the object is stored in the database.
      Specified by:
      getStored in interface ParaObject
      Returns:
      true if stored

    • setStored

      public void setStored(Boolean stored)
      Sets the stored flag.
      Specified by:
      setStored in interface ParaObject
      Parameters:
      stored - the stored flag

    • getIndexed

      public Boolean getIndexed()
      Returns true if the object is indexed.
      Specified by:
      getIndexed in interface ParaObject
      Returns:
      true if indexed

    • setIndexed

      public void setIndexed(Boolean indexed)
      Sets the indexed flag.
      Specified by:
      setIndexed in interface ParaObject
      Parameters:
      indexed - the indexed flag

    • getCached

      public Boolean getCached()
      Returns true if the object is cached.
      Specified by:
      getCached in interface ParaObject
      Returns:
      true if cached

    • setCached

      public void setCached(Boolean cached)
      Sets the cached flag.
      Specified by:
      setCached in interface ParaObject
      Parameters:
      cached - the cached flag

    • getTimestamp

      public Long getTimestamp()
      Returns the timestamp.
      Specified by:
      getTimestamp in interface ParaObject
      Returns:
      the timestamp

    • setTimestamp

      public void setTimestamp(Long timestamp)
      Sets the timestamp.
      Specified by:
      setTimestamp in interface ParaObject
      Parameters:
      timestamp - the timestamp

    • getCreatorid

      public String getCreatorid()
      Returns the creator ID.
      Specified by:
      getCreatorid in interface ParaObject
      Returns:
      the creatorid

    • setCreatorid

      public void setCreatorid(String creatorid)
      Sets the creator ID.
      Specified by:
      setCreatorid in interface ParaObject
      Parameters:
      creatorid - the creatorid

    • getName

      public final String getName()
      Returns the object name.
      Specified by:
      getName in interface ParaObject
      Returns:
      the name

    • setName

      public final void setName(String name)
      Sets the object name.
      Specified by:
      setName in interface ParaObject
      Parameters:
      name - the name

    • getPlural

      public String getPlural()
      Returns the plural form of the object type.
      Specified by:
      getPlural in interface ParaObject
      Returns:
      the plural name

    • getParentid

      public String getParentid()
      Returns the parent ID.
      Specified by:
      getParentid in interface ParaObject
      Returns:
      the parentid

    • setParentid

      public void setParentid(String parentid)
      Sets the parent ID.
      Specified by:
      setParentid in interface ParaObject
      Parameters:
      parentid - the parentid

    • getUpdated

      public Long getUpdated()
      Returns the updated timestamp.
      Specified by:
      getUpdated in interface ParaObject
      Returns:
      the updated timestamp

    • setUpdated

      public void setUpdated(Long updated)
      Sets the updated timestamp.
      Specified by:
      setUpdated in interface ParaObject
      Parameters:
      updated - the updated timestamp

    • update

      public void update()
      Updates the object in the database.
      Specified by:
      update in interface ParaObject
      See Also:

    • exists

      public boolean exists()
      Returns true if the object exists in the database.
      Specified by:
      exists in interface ParaObject
      Returns:
      true if exists
      See Also:

    • voteUp

      public boolean voteUp(String userid)
      Votes up for the object.
      Specified by:
      voteUp in interface Votable
      Parameters:
      userid - the voter ID
      Returns:
      true if successful

    • voteDown

      public boolean voteDown(String userid)
      Votes down for the object.
      Specified by:
      voteDown in interface Votable
      Parameters:
      userid - the voter ID
      Returns:
      true if successful

    • getVotes

      public Integer getVotes()
      Returns the number of votes.
      Specified by:
      getVotes in interface Votable
      Returns:
      the votes

    • setVotes

      public void setVotes(Integer votes)
      Sets the number of votes.
      Specified by:
      setVotes in interface Votable
      Parameters:
      votes - the votes

    • getVersion

      public Long getVersion()
      Returns the version of the object.
      Specified by:
      getVersion in interface ParaObject
      Returns:
      the version

    • setVersion

      public void setVersion(Long version)
      Sets the version of the object.
      Specified by:
      setVersion in interface ParaObject
      Parameters:
      version - the version

    • countLinks

      public Long countLinks(String type2)
      Counts the number of links to other objects of a certain type.
      Specified by:
      countLinks in interface Linkable
      Parameters:
      type2 - the other type
      Returns:
      the number of links

    • getLinks

      public List<Linker> getLinks(String type2, Pager... pager)
      Returns a list of links to other objects of a certain type.
      Specified by:
      getLinks in interface Linkable
      Parameters:
      type2 - the other type
      pager - a pager
      Returns:
      a list of links

    • getLinkedObjects

      public <P extends ParaObject> List<P> getLinkedObjects(String type, Pager... pager)
      Returns a list of linked objects of a certain type.
      Specified by:
      getLinkedObjects in interface Linkable
      Type Parameters:
      P - the type of linked objects
      Parameters:
      type - the other type
      pager - a pager
      Returns:
      a list of linked objects

    • findLinkedObjects

      public <P extends ParaObject> List<P> findLinkedObjects(String type, String field, String query, Pager... pager)
      Finds linked objects of a certain type that match a specific field and query.
      Specified by:
      findLinkedObjects in interface Linkable
      Type Parameters:
      P - the type of linked objects
      Parameters:
      type - the other type
      field - the field to search in
      query - the search query
      pager - a pager
      Returns:
      a list of linked objects

    • isLinked

      public boolean isLinked(String type2, String id2)
      Returns true if the object is linked to another object of a certain type and ID.
      Specified by:
      isLinked in interface Linkable
      Parameters:
      type2 - the other type
      id2 - the other ID
      Returns:
      true if linked

    • isLinked

      public boolean isLinked(ParaObject toObj)
      Returns true if the object is linked to another object.
      Specified by:
      isLinked in interface Linkable
      Parameters:
      toObj - the other object
      Returns:
      true if linked

    • link

      public String link(String id2)
      Links the object to another object of a certain type and ID.
      Specified by:
      link in interface Linkable
      Parameters:
      id2 - the other ID
      Returns:
      the link ID

    • unlink

      public void unlink(String type, String id2)
      Unlinks the object from another object of a certain type and ID.
      Specified by:
      unlink in interface Linkable
      Parameters:
      type - the other type
      id2 - the other ID

    • unlinkAll

      public void unlinkAll()
      Unlinks the object from all other objects.
      Specified by:
      unlinkAll in interface Linkable

    • countChildren

      public Long countChildren(String type)
      Counts the number of children of a certain type.
      Specified by:
      countChildren in interface Linkable
      Parameters:
      type - the child type
      Returns:
      the number of children

    • getChildren

      public <P extends ParaObject> List<P> getChildren(String type, Pager... pager)
      Returns a list of children of a certain type.
      Specified by:
      getChildren in interface Linkable
      Type Parameters:
      P - the type of children
      Parameters:
      type - the child type
      pager - a pager
      Returns:
      a list of children

    • getChildren

      public <P extends ParaObject> List<P> getChildren(String type, String field, String term, Pager... pager)
      Returns a list of children of a certain type that match a specific field and term.
      Specified by:
      getChildren in interface Linkable
      Type Parameters:
      P - the type of children
      Parameters:
      type - the child type
      field - the field to search in
      term - the search term
      pager - a pager
      Returns:
      a list of children

    • findChildren

      public <P extends ParaObject> List<P> findChildren(String type, String query, Pager... pager)
      Finds children of a certain type that match a specific query.
      Specified by:
      findChildren in interface Linkable
      Type Parameters:
      P - the type of children
      Parameters:
      type - the child type
      query - the search query
      pager - a pager
      Returns:
      a list of children

    • deleteChildren

      public void deleteChildren(String type)
      Deletes all children of a certain type.
      Specified by:
      deleteChildren in interface Linkable
      Parameters:
      type - the child type

    • hashCode

      public int hashCode()
      Returns the hash code for this object.
      Overrides:
      hashCode in class Object
      Returns:
      hash code

    • equals

      public boolean equals(Object obj)
      Returns true if this object is equal to another.
      Overrides:
      equals in class Object
      Parameters:
      obj - the other object
      Returns:
      true if equal

    • toString

      public String toString()
      Returns a JSON string representation of this object.
      Overrides:
      toString in class Object
      Returns:
      JSON string