ligaaas.teamc.service

Class UserEJB

java.lang.Object

ligaaas.teamc.service.UserEJB

@PermitAll
public class UserEJB
extends Object

EJB for User

Author:

teamC

Constructor Summary

Constructors

Constructor and Description
UserEJB()

Method Summary

Modifier and Type	Method and Description
ligaaas.teamc.domain.User	activateUser(Long userId) Activates the account of a user.
void	delete(long userId) Deletes a User.
ligaaas.teamc.domain.User	find(long userId) Returns the User identified by id.
List<ligaaas.teamc.domain.User>	findByEmail(String userEmail) Returns a List of User with the specified email.
List<ligaaas.teamc.domain.User>	findByLogin(String userLogin) Returns the User identified by id.
List<ligaaas.teamc.domain.User>	findByToken(String userToken) Returns the User identified by token.
String	generateHash(ligaaas.teamc.domain.User user) Generates the hash of a given user.
ligaaas.teamc.domain.User	registerUser(ligaaas.teamc.domain.User user) Register a new User.
ligaaas.teamc.domain.User	update(ligaaas.teamc.domain.User user) Updates a user.
ligaaas.teamc.domain.User	updatePassword(ligaaas.teamc.domain.User user, String newUserPassword) Updates a user password.

Methods inherited from class java.lang.Object

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

Constructor Detail

UserEJB

public UserEJB()

Method Detail

generateHash

public String generateHash(ligaaas.teamc.domain.User user)

Generates the hash of a given user.

Parameters:

user - The user used to calculate the hash.

Returns:

The hash of the user

update

@RolesAllowed(value="registered")
public ligaaas.teamc.domain.User update(ligaaas.teamc.domain.User user)

Updates a user.

Parameters:

user - A modified User to be persisted.

Returns:

The persistent version of the User modified.

Throws:

NullPointerException - if the User is null.

IllegalArgumentException - if User doesn't exist.

IllegalArgumentException - if the password is distinct to the persisted.

javax.ejb.EJBAccessException - if user to update isn't the current principal.

javax.ejb.EJBAccessException - if the current User isn't registered.

updatePassword

@RolesAllowed(value="registered")
public ligaaas.teamc.domain.User updatePassword(ligaaas.teamc.domain.User user,
                                                                                  String newUserPassword)

Updates a user password.

Parameters:

user - A user to modify the password.

newUserPassword - The new password to add.

Returns:

The persistent version of the User modified.

Throws:

NullPointerException - if the User is null.

NullPointerException - if the newUserPassword is null.

IllegalArgumentException - if User doesn't exist.

javax.ejb.EJBAccessException - if user to update isn't the current principal.

javax.ejb.EJBAccessException - if the current User isn't registered.

delete

@RolesAllowed(value="registered")
public void delete(long userId)

Deletes a User.

Parameters:

userId. - The id of the User to be deleted.

Throws:

NullPointerException - if the User does not exist.

javax.ejb.EJBAccessException - if user to delete isn't the current principal.

javax.ejb.EJBAccessException - if the current User isn't registered.

findByLogin

public List<ligaaas.teamc.domain.User> findByLogin(String userLogin)

Returns the User identified by id. If there is no User with the specified id, null will be returned.

Parameters:

userLogin. - The id of the user to be returned.

Returns:

The User with the given id.

Throws:

IllegalArgumentException - if User login is null

findByToken

public List<ligaaas.teamc.domain.User> findByToken(String userToken)

Returns the User identified by token. If there is no User with the specified token, null will be returned.

Parameters:

userToken. - The token of the user to be returned.

Returns:

The User with the given token.

Throws:

IllegalArgumentException - if User token is null

findByEmail

public List<ligaaas.teamc.domain.User> findByEmail(String userEmail)

Returns a List of User with the specified email.

Parameters:

userEmail. - The email of the User to be searched.

Returns:

A List of User with the specified email.

Throws:

IllegalArgumentException - if User email is null

registerUser

public ligaaas.teamc.domain.User registerUser(ligaaas.teamc.domain.User user)

Register a new User.

Parameters:

user. - A new User to be registered.

Returns:

A new User is created with an notification sent to the email.

Throws:

IllegalArgumentException - if User is null

IllegalArgumentException - if User login is already in use.

IllegalArgumentException - if User email is already in use.

find

public ligaaas.teamc.domain.User find(long userId)

Returns the User identified by id. If there is no User with the specified id, null will be returned.

Parameters:

userId - The id of the user to be returned.

Returns:

The User with the given id.

activateUser

public ligaaas.teamc.domain.User activateUser(Long userId)

Activates the account of a user.

Parameters:

userId - The id of the user to be activated.

Returns:

The persistence version of the User activated or null if there is not an User with the specified userId or if the user was already activated.

Throws:

IllegalArgumentException - if the userId is less than one.

javax.ejb.EJBAccessException - if current user is not anonymous.