Class User

java.lang.Object

com.goldenleaf.shop.model.User

Direct Known Subclasses:

Admin, Customer

@Entity
public abstract class User
extends Object

Abstract base entity representing a user in the system.

This is the root of a InheritanceType.JOINED inheritance hierarchy. Concrete user types such as Customer and Admin extend this class. Common fields are stored in the users table, while type-specific columns are stored in their own dedicated tables.

The login field is unique across all user types and is used as the primary credential identifier. The passwordHash stores the hashed password (e.g. BCrypt). The lastActivity field is updated on every successful login or meaningful action.

Since:

1.0.0

See Also:

• Customer
• Admin
• EmptyLoginException
• EmptyLastActivityException

Constructor Summary

Constructors

Constructor	Description
User()	Default constructor required by JPA.
User(String login, String passwordHash, String name, LocalDate lastActivity)	Convenience constructor for creating a new user instance.

Method Summary

Modifier and Type	Method	Description
Long	getId()
LocalDate	getLastActivity()
String	getLogin()	Returns the user's login.
void	setLastActivity(LocalDate lastActivity)	Updates the last activity date.
void	setLogin(String login)	Sets the user's login.
void	setPassword(String hashedPassword)

Methods inherited from class java.lang.Object

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

Constructor Details

User

public User()

Default constructor required by JPA.

User

public User(String login,
 String passwordHash,
 String name,
 LocalDate lastActivity)

Convenience constructor for creating a new user instance.

Parameters:

login - unique login

passwordHash - already hashed password

name - display name

lastActivity - date of last activity (usually LocalDate.now() on creation)

Throws:

EmptyLoginException - if login is blank

EmptyLastActivityException - if lastActivity is null

Method Details

getId

public Long getId()

getLogin

public String getLogin()
                throws EmptyLoginException

Returns the user's login.

Returns:

the login

Throws:

EmptyLoginException - if login is null or blank (should never happen in a persisted entity)

setLogin

public void setLogin(String login)
              throws EmptyLoginException

Sets the user's login.

Parameters:

login - new login value

Throws:

EmptyLoginException - if the provided login is null or blank

setPassword

public void setPassword(String hashedPassword)

getLastActivity

public LocalDate getLastActivity()

setLastActivity

public void setLastActivity(LocalDate lastActivity)
                     throws EmptyLastActivityException

Updates the last activity date.

Parameters:

lastActivity - new activity date

Throws:

EmptyLastActivityException - if null is provided