org.squashtest.tm.service.internal.user

Class AdministrationServiceImpl

java.lang.Object

org.squashtest.tm.service.internal.user.AdministrationServiceImpl

All Implemented Interfaces:

AdministrationService, UserManagerService

@Service(value="squashtest.tm.service.AdministrationService")
@Transactional
public class AdministrationServiceImpl
extends Object
implements AdministrationService

Author:

bsiri

Constructor Summary

Constructors

Constructor and Description
AdministrationServiceImpl()

Method Summary

Methods

Modifier and Type	Method and Description
void	activateUser(long userId)
void	activateUsers(Collection<Long> userIds)
void	addUser(org.squashtest.tm.domain.users.User user, long groupId, String password)
void	associateToTeams(long userId, List<Long> teamIds) Will add user to teams members lists.
void	checkLoginAvailability(String login) Checks if a user already exist with the same login in the database.
org.squashtest.tm.domain.users.User	createAdministrator(org.squashtest.tm.domain.users.User user, String password) Creates a user with the given password.
void	createAuthentication(long userId, String password) Creates authentication data for given user.
org.squashtest.tm.domain.users.User	createUserFromLogin(String login) Creates a stub User using the given login and returns it.
void	createUserWithoutCredentials(org.squashtest.tm.domain.users.User user, long groupId) Creates a user without credentials.
void	deactivateUser(long userId)
void	deactivateUsers(Collection<Long> userIds)
void	deassociateTeams(long userId, List<Long> teamIds) Will remove user from teams members lists.
void	deleteUsers(Collection<Long> userIds)
org.squashtest.tm.domain.AdministrationStatistics	findAdministrationStatistics() will ask database how much there is of some entities and return it in a AdministrationStatistics bean.
List<org.squashtest.tm.domain.users.User>	findAllActiveUsersOrderedByLogin()
List<org.squashtest.tm.domain.users.User>	findAllAdminOrManager()
List<String>	findAllDuplicateLogins() Logins are considered as duplicate when they are equal without case-sensitivity.
List<org.squashtest.tm.domain.users.Team>	findAllNonAssociatedTeams(long userId) Will return a list of all Team that do not have the concerned User as a member access restricted to admins
List<org.squashtest.tm.domain.project.Project>	findAllProjects()
org.squashtest.tm.core.foundation.collection.PagedCollectionHolder<List<org.squashtest.tm.domain.users.User>>	findAllUsersFiltered(org.squashtest.tm.core.foundation.collection.PagingAndSorting sorter, org.squashtest.tm.core.foundation.collection.Filtering filter)
List<org.squashtest.tm.domain.users.UsersGroup>	findAllUsersGroupOrderedByQualifiedName()
List<org.squashtest.tm.domain.users.User>	findAllUsersOrderedByLogin()
org.squashtest.tm.domain.users.User	findByLogin(String login) This is not secured on purpose.
String	findCaseAwareLogin(String login) Given a login, returns the unique actual matching login without case sensisivity
String	findLoginMessage()
org.squashtest.tm.core.foundation.collection.PagedCollectionHolder<List<org.squashtest.tm.domain.users.Team>>	findSortedAssociatedTeams(long userId, org.squashtest.tm.core.foundation.collection.PagingAndSorting paging, org.squashtest.tm.core.foundation.collection.Filtering filtering) Will return an paged and filtered list of Teams that have the concerned user as a member.
AuthenticatedUser	findUserById(long userId)
String	findWelcomeMessage()
void	modifyLoginMessage(String loginMessage)
void	modifyUserEmail(long userId, String newEmail)
void	modifyUserFirstName(long userId, String newName)
void	modifyUserLastName(long userId, String newName)
void	modifyUserLogin(long userId, String newLogin)
void	modifyWelcomeMessage(String welcomeMessage)
void	resetUserPassword(long userId, String newPassword)
void	setAdministratorAuthenticationService(AdministratorAuthenticationService adminService)
void	setConfigurationService(ConfigurationService configurationService)
void	setUserGroupAuthority(long userId, long groupId)

Methods inherited from class java.lang.Object

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

Constructor Detail

AdministrationServiceImpl

public AdministrationServiceImpl()

Method Detail

setAdministratorAuthenticationService

public void setAdministratorAuthenticationService(AdministratorAuthenticationService adminService)

setConfigurationService

public void setConfigurationService(ConfigurationService configurationService)

modifyUserFirstName

public void modifyUserFirstName(long userId,
                       String newName)

Specified by:

modifyUserFirstName in interface UserManagerService

modifyUserLastName

public void modifyUserLastName(long userId,
                      String newName)

Specified by:

modifyUserLastName in interface UserManagerService

modifyUserLogin

public void modifyUserLogin(long userId,
                   String newLogin)

Specified by:

modifyUserLogin in interface UserManagerService

modifyUserEmail

public void modifyUserEmail(long userId,
                   String newEmail)

Specified by:

modifyUserEmail in interface UserManagerService

findUserById

@PreAuthorize(value="hasRole(\'ROLE_ADMIN\')")
public AuthenticatedUser findUserById(long userId)

Specified by:

findUserById in interface UserManagerService

findAllUsersOrderedByLogin

@PreAuthorize(value="hasRole(\'ROLE_ADMIN\')")
public List<org.squashtest.tm.domain.users.User> findAllUsersOrderedByLogin()

Specified by:

findAllUsersOrderedByLogin in interface UserManagerService

findAllActiveUsersOrderedByLogin

@PreAuthorize(value="hasRole(\'ROLE_ADMIN\')")
public List<org.squashtest.tm.domain.users.User> findAllActiveUsersOrderedByLogin()

Specified by:

findAllActiveUsersOrderedByLogin in interface UserManagerService

findAllUsersFiltered

@PreAuthorize(value="hasRole(\'ROLE_ADMIN\')")
public org.squashtest.tm.core.foundation.collection.PagedCollectionHolder<List<org.squashtest.tm.domain.users.User>> findAllUsersFiltered(org.squashtest.tm.core.foundation.collection.PagingAndSorting sorter,
                                                                                                                                              org.squashtest.tm.core.foundation.collection.Filtering filter)

Specified by:

findAllUsersFiltered in interface UserManagerService

findAllUsersGroupOrderedByQualifiedName

@PreAuthorize(value="hasRole(\'ROLE_ADMIN\')")
public List<org.squashtest.tm.domain.users.UsersGroup> findAllUsersGroupOrderedByQualifiedName()

Specified by:

findAllUsersGroupOrderedByQualifiedName in interface UserManagerService

addUser

@PreAuthorize(value="hasRole(\'ROLE_ADMIN\')")
public void addUser(org.squashtest.tm.domain.users.User user,
                        long groupId,
                        String password)

Specified by:

addUser in interface UserManagerService

setUserGroupAuthority

@PreAuthorize(value="hasRole(\'ROLE_ADMIN\')")
public void setUserGroupAuthority(long userId,
                                      long groupId)

Specified by:

setUserGroupAuthority in interface UserManagerService

deactivateUser

@PreAuthorize(value="hasRole(\'ROLE_ADMIN\')")
public void deactivateUser(long userId)

Specified by:

deactivateUser in interface UserManagerService

activateUser

@PreAuthorize(value="hasRole(\'ROLE_ADMIN\')")
public void activateUser(long userId)

Specified by:

activateUser in interface UserManagerService

deactivateUsers

@PreAuthorize(value="hasRole(\'ROLE_ADMIN\')")
public void deactivateUsers(Collection<Long> userIds)

Specified by:

deactivateUsers in interface UserManagerService

activateUsers

@PreAuthorize(value="hasRole(\'ROLE_ADMIN\')")
public void activateUsers(Collection<Long> userIds)

Specified by:

activateUsers in interface UserManagerService

deleteUsers

@PreAuthorize(value="hasRole(\'ROLE_ADMIN\')")
public void deleteUsers(Collection<Long> userIds)

Specified by:

deleteUsers in interface UserManagerService

findAllProjects

public List<org.squashtest.tm.domain.project.Project> findAllProjects()

Specified by:

findAllProjects in interface AdministrationService

modifyWelcomeMessage

public void modifyWelcomeMessage(String welcomeMessage)

Specified by:

modifyWelcomeMessage in interface AdministrationService

modifyLoginMessage

public void modifyLoginMessage(String loginMessage)

Specified by:

modifyLoginMessage in interface AdministrationService

findWelcomeMessage

public String findWelcomeMessage()

Specified by:

findWelcomeMessage in interface AdministrationService

findLoginMessage

public String findLoginMessage()

Specified by:

findLoginMessage in interface AdministrationService

resetUserPassword

@PreAuthorize(value="hasRole(\'ROLE_ADMIN\')")
public void resetUserPassword(long userId,
                                  String newPassword)

Specified by:

resetUserPassword in interface UserManagerService

findAdministrationStatistics

public org.squashtest.tm.domain.AdministrationStatistics findAdministrationStatistics()

Description copied from interface: AdministrationService

will ask database how much there is of some entities and return it in a AdministrationStatistics bean.

Specified by:

findAdministrationStatistics in interface AdministrationService

Returns:

AdministrationStatistics as result of counts in database.

See Also:

AdministrationService.findAdministrationStatistics()

deassociateTeams

@PreAuthorize(value="hasRole(\'ROLE_ADMIN\')")
public void deassociateTeams(long userId,
                                 List<Long> teamIds)

Description copied from interface: UserManagerService

Will remove user from teams members lists.
access restricted to admins

Specified by:

deassociateTeams in interface UserManagerService

Parameters:

userId - : the id of the concerned User

teamIds - : ids of Teams to remove user from.

See Also:

UserManagerService.deassociateTeams(long, List)

associateToTeams

@PreAuthorize(value="hasRole(\'ROLE_ADMIN\')")
public void associateToTeams(long userId,
                                 List<Long> teamIds)

Description copied from interface: AdministrationService

Will add user to teams members lists.
access restricted to admins

Specified by:

associateToTeams in interface AdministrationService

Parameters:

userId - : the id of the concerned User

teamIds - : ids of the Teams to add user to.

See Also:

AdministrationService.associateToTeams(long, List)

findSortedAssociatedTeams

@PreAuthorize(value="hasRole(\'ROLE_ADMIN\')")
public org.squashtest.tm.core.foundation.collection.PagedCollectionHolder<List<org.squashtest.tm.domain.users.Team>> findSortedAssociatedTeams(long userId,
                                                                                                                                                   org.squashtest.tm.core.foundation.collection.PagingAndSorting paging,
                                                                                                                                                   org.squashtest.tm.core.foundation.collection.Filtering filtering)

Description copied from interface: UserManagerService

Will return an paged and filtered list of Teams that have the concerned user as a member.
access restricted to admins

Specified by:

findSortedAssociatedTeams in interface UserManagerService

Parameters:

userId - : the id of the concerned user

paging - : the PagingAndSorting criteria that the result has to match

filtering - : the Filtering criteria that the result has to match

Returns:

See Also:

UserManagerService.findSortedAssociatedTeams(long, PagingAndSorting, Filtering)

findAllNonAssociatedTeams

@PreAuthorize(value="hasRole(\'ROLE_ADMIN\')")
public List<org.squashtest.tm.domain.users.Team> findAllNonAssociatedTeams(long userId)

Description copied from interface: UserManagerService

Will return a list of all Team that do not have the concerned User as a member
access restricted to admins

Specified by:

findAllNonAssociatedTeams in interface UserManagerService

Parameters:

userId - : the id of the concerned User

Returns:

the list of all non associated Teams

See Also:

UserManagerService.findAllNonAssociatedTeams(long)

findByLogin

public org.squashtest.tm.domain.users.User findByLogin(String login)

This is not secured on purpose.

Specified by:

findByLogin in interface UserManagerService

See Also:

UserManagerService.findByLogin(java.lang.String)

createUserFromLogin

public org.squashtest.tm.domain.users.User createUserFromLogin(@NotNull
                                                      String login)
                                                        throws org.squashtest.tm.exception.user.LoginAlreadyExistsException

Description copied from interface: UserManagerService

Creates a stub User using the given login and returns it. This should throw an exception when the user already exists.

Specified by:

createUserFromLogin in interface UserManagerService

Returns:

the new User

Throws:

org.squashtest.tm.exception.user.LoginAlreadyExistsException - when user already exists

See Also:

UserManagerService.createUserFromLogin(java.lang.String)

createUserWithoutCredentials

public void createUserWithoutCredentials(org.squashtest.tm.domain.users.User user,
                                long groupId)

Description copied from interface: UserManagerService

Creates a user without credentials. This should be used when authentication is managed by an external provider only.

Specified by:

createUserWithoutCredentials in interface UserManagerService

See Also:

UserManagerService.createUserWithoutCredentials(org.squashtest.tm.domain.users.User, long)

createAuthentication

public void createAuthentication(long userId,
                        String password)
                          throws org.squashtest.tm.exception.user.LoginAlreadyExistsException

Description copied from interface: UserManagerService

Creates authentication data for given user.

Specified by:

createAuthentication in interface UserManagerService

Throws:

org.squashtest.tm.exception.user.LoginAlreadyExistsException - when authentication data already exixts

See Also:

UserManagerService.createAuthentication(long, java.lang.String)

findAllAdminOrManager

@PreAuthorize(value="hasRole(\'ROLE_TM_PROJECT_MANAGER\') or hasRole(\'ROLE_ADMIN\')")
public List<org.squashtest.tm.domain.users.User> findAllAdminOrManager()

Specified by:

findAllAdminOrManager in interface UserManagerService

createAdministrator

public org.squashtest.tm.domain.users.User createAdministrator(org.squashtest.tm.domain.users.User user,
                                                      String password)
                                                        throws org.squashtest.tm.exception.user.LoginAlreadyExistsException

Description copied from interface: UserManagerService

Creates a user with the given password. This new user shall have the ROLE_ADMIN role. This method should not have any security constraint because we might need it to provision the authentication system (ie there is no user yet).

Specified by:

createAdministrator in interface UserManagerService

Throws:

org.squashtest.tm.exception.user.LoginAlreadyExistsException

See Also:

UserManagerService.createAdministrator(org.squashtest.tm.domain.users.User, java.lang.String)

checkLoginAvailability

public void checkLoginAvailability(String login)

Description copied from interface: UserManagerService

Checks if a user already exist with the same login in the database.
If so, raises a LoginAlreadyExistsException The login is checked according to the state of the case-sensitivity feature.

Specified by:

checkLoginAvailability in interface UserManagerService

findAllDuplicateLogins

public List<String> findAllDuplicateLogins()

Description copied from interface: UserManagerService

Logins are considered as duplicate when they are equal without case-sensitivity.

Specified by:

findAllDuplicateLogins in interface UserManagerService

Returns:

the list of duplicate logins / username

See Also:

UserManagerService.findAllDuplicateLogins()

findCaseAwareLogin

public String findCaseAwareLogin(String login)

Description copied from interface: UserManagerService

Given a login, returns the unique actual matching login without case sensisivity

Specified by:

findCaseAwareLogin in interface UserManagerService

Returns:

actual login or `null` when the login was not found.

See Also:

UserManagerService.findCaseAwareLogin(java.lang.String)