Package com.easydesk.security.adaptor

Class UserManagerAdaptor<U extends User>

java.lang.Object

com.easydesk.security.adaptor.UserManagerAdaptor<U>

Type Parameters:

U - User type

All Implemented Interfaces:

SecurityEntityManager<User,Long>, UserManager, Serializable

@Component
public class UserManagerAdaptor<U extends User>
extends Object
implements UserManager

Torque OM(EasyDeskUserImpl) 을 이용하여 사용자를 관리하는 UserManager 구현.

password 의 변환과 검증은 주입받은 CredentialService 에 위임한다.

See Also:

• Serialized Form

Constructor Summary

Constructors

Constructor	Description
UserManagerAdaptor(CredentialService credentialService)	CredentialService 를 주입받아 UserManagerAdaptor 를 생성한다.

Method Summary

Modifier and Type	Method	Description
User	add(User entity)	새 사용자를 저장소에 추가한다.
void	authenticate(User user, String plainTextPassword)	Authenticate an User with the specified password.
void	changePassword(User user, String oldPassword, String newPassword)	Change the password for an User.
boolean	exists(User entity)	id 로 사용자가 저장소에 존재하는지 확인한다.
boolean	exists(String name)	login 이름에 해당하는 사용자가 저장소에 존재하는지 확인한다.
void	forcePassword(User user, String password)	Forcibly sets new password for an User.
EasyDeskAccessControlListImpl	getACL(User user)	사용자의 User-Group-Role 정보로 AccessControlList 를 생성한다.
User[]	getByName(String... name)	login 이름에 해당하는 사용자를 구한다.
User	getInstance()	새 사용자 instance 를 생성한다.
User	getInstance(Long id)	id 에 해당하는 사용자를 구한다.
void	remove(User entity)	사용자를 저장소에서 삭제한다.
void	rename(User entity, String name)	사용자 이름 변경은 지원하지 않는다.
<T extends User> UserSet<T>	retrieveUserList(Object criteria)	조건에 맞는 사용자 목록을 구한다.
void	saveUser(User user)	Saves User's data in the permanent storage.

Methods inherited from class java.lang.Object

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

Constructor Details

UserManagerAdaptor

public UserManagerAdaptor(CredentialService credentialService)

CredentialService 를 주입받아 UserManagerAdaptor 를 생성한다.

Parameters:

credentialService - password 변환과 검증에 사용하는 CredentialService

Method Details

getInstance

public User getInstance()

새 사용자 instance 를 생성한다. 저장소에 저장하지는 않는다.

Specified by:

getInstance in interface SecurityEntityManager<User,Long>

Returns:

새 EasyDeskUserImpl

getInstance

public User getInstance(Long id)
                 throws DataBackendException,
UnknownEntityException

id 에 해당하는 사용자를 구한다.

Specified by:

getInstance in interface SecurityEntityManager<User,Long>

Parameters:

id - user id

Returns:

id 에 해당하는 사용자

Throws:

DataBackendException - 저장소 접근 중 오류가 발생한 경우

UnknownEntityException - id 에 해당하는 사용자가 없는 경우

getByName

public User[] getByName(String... name)
                 throws DataBackendException,
UnknownEntityException

login 이름에 해당하는 사용자를 구한다.

Specified by:

getByName in interface SecurityEntityManager<User,Long>

Parameters:

name - login 이름

Returns:

login 이름에 해당하는 사용자

Throws:

DataBackendException - 저장소 접근 중 오류가 발생한 경우

UnknownEntityException - 이름에 해당하는 사용자가 없는 경우

rename

public void rename(User entity,
 String name)
            throws DataBackendException,
UnknownEntityException

사용자 이름 변경은 지원하지 않는다.

Specified by:

rename in interface SecurityEntityManager<User,Long>

Parameters:

entity - 대상 사용자

name - 새 이름

Throws:

DataBackendException - 발생하지 않는다

UnknownEntityException - 발생하지 않는다

UnsupportedOperationException - 항상 발생 (지원하지 않음)

remove

public void remove(User entity)
            throws DataBackendException,
UnknownEntityException

사용자를 저장소에서 삭제한다.

Specified by:

remove in interface SecurityEntityManager<User,Long>

Parameters:

entity - 삭제할 사용자

Throws:

DataBackendException - 삭제 중 오류가 발생한 경우

UnknownEntityException - 사용자가 존재하지 않는 경우

add

public User add(User entity)
         throws DataBackendException,
EntityExistsException

새 사용자를 저장소에 추가한다. 입력한 password 를 CredentialService 로 변환하여 저장한다.

Specified by:

add in interface SecurityEntityManager<User,Long>

Parameters:

entity - 추가할 사용자 (id 가 없어야 하며, password 는 plain text)

Returns:

저장된 사용자

Throws:

DataBackendException - password 변환 또는 저장 중 오류가 발생한 경우

EntityExistsException - id 가 이미 있거나 같은 이름의 사용자가 존재하는 경우

exists

public boolean exists(User entity)
               throws DataBackendException

id 로 사용자가 저장소에 존재하는지 확인한다.

Specified by:

exists in interface SecurityEntityManager<User,Long>

Parameters:

entity - 확인할 사용자

Returns:

존재하면 true, 조회 중 오류가 발생하면 false

Throws:

DataBackendException - 저장소 접근 중 오류가 발생한 경우

exists

public boolean exists(String name)
               throws DataBackendException

login 이름에 해당하는 사용자가 저장소에 존재하는지 확인한다.

Specified by:

exists in interface SecurityEntityManager<User,Long>

Parameters:

name - 확인할 login 이름

Returns:

존재하면 true

Throws:

DataBackendException - 저장소 접근 중 오류가 발생한 경우

retrieveUserList

public <T extends User> UserSet<T> retrieveUserList(Object criteria)
                                             throws DataBackendException

조건에 맞는 사용자 목록을 구한다. 현재는 지원하지 않는다.

Specified by:

retrieveUserList in interface UserManager

Type Parameters:

T - User type

Parameters:

criteria - torque criteria

Returns:

사용자 목록

Throws:

DataBackendException - 발생하지 않는다

UnsupportedOperationException - 항상 발생 (미구현)

saveUser

public void saveUser(User user)
              throws UnknownEntityException,
DataBackendException

Saves User's data in the permanent storage. The user account is required to exist in the storage.

Specified by:

saveUser in interface UserManager

Parameters:

user - the user object to save

Throws:

UnknownEntityException - if the user's account does not exist in the database.

DataBackendException - if there is a problem accessing the storage.

authenticate

public void authenticate(User user,
 String plainTextPassword)
                  throws PasswordMismatchException,
UnknownEntityException,
DataBackendException

Authenticate an User with the specified password. If authentication is successful the method returns nothing. If there are any problems, exception was thrown.

사용자 id 가 있으면 id 로, 없으면 이름으로 존재 여부를 확인한 뒤 CredentialService 로 password 를 검증한다.

Specified by:

authenticate in interface UserManager

Parameters:

user - an User object to authenticate.

plainTextPassword - the user supplied password.

Throws:

PasswordMismatchException - if the supplied password was incorrect.

UnknownEntityException - if the user's record does not exist in the database.

DataBackendException - if there is a problem accessing the storage.

changePassword

public void changePassword(User user,
 String oldPassword,
 String newPassword)
                    throws PasswordMismatchException,
UnknownEntityException,
DataBackendException

Change the password for an User. 현재 password 를 검증한 후 새 password 로 변경한다.

Specified by:

changePassword in interface UserManager

Parameters:

user - an User to change password for.

oldPassword - the current password suplied by the user.

newPassword - the new password requested by the user.

Throws:

PasswordMismatchException - if the supplied password was incorrect.

UnknownEntityException - if the user's record does not exist in the database.

DataBackendException - if there is a problem accessing the storage.

forcePassword

public void forcePassword(User user,
 String password)
                   throws UnknownEntityException,
DataBackendException

Forcibly sets new password for an User.

This is supposed by the administrator to change the forgotten or compromised passwords. Certain implementatations of this feature would require administrative level access to the authenticating server / program. 새 password 를 CredentialService 로 변환하여 저장한다.

Specified by:

forcePassword in interface UserManager

Parameters:

user - an User to change password for.

password - the new password. (plain text)

Throws:

UnknownEntityException - if the user's record does not exist in the database.

DataBackendException - if there is a problem accessing the storage.

getACL

public EasyDeskAccessControlListImpl getACL(User user)
                                     throws UnknownEntityException

사용자의 User-Group-Role 정보로 AccessControlList 를 생성한다.

Specified by:

getACL in interface UserManager

Parameters:

user - the user

Returns:

사용자의 EasyDeskAccessControlListImpl

Throws:

UnknownEntityException - if the implementation of ACL interface could not be determined, or does not exist.