csbase.server.services.administrationservice

Class DefaultUserDAO

java.lang.Object

csbase.server.services.administrationservice.DefaultUserDAO

All Implemented Interfaces:

UserDAO

public class DefaultUserDAO
extends java.lang.Object
implements UserDAO

Implementação padrão do DAO de usuário. Utiliza armazenamento em arquivo (serialização de objetos).

Author:

Jorge Alexandre

See Also:

DefaultAdministrationDAOFactory

Constructor Summary

Constructors

Constructor and Description
DefaultUserDAO()

Method Summary

Methods

Modifier and Type	Method and Description
csbase.logic.User	changeUser(csbase.logic.User superuser, java.lang.String delegatedLogin) Tranforma um super-usuário em um usuário comum.
csbase.logic.User	createUser(csbase.logic.UserInfo info) Persiste o usuário na fonte de dados.
void	deleteUser(java.lang.Object id) Exclui um usuário na fonte de dados.
csbase.logic.User	modifyUser(java.lang.Object id, csbase.logic.UserInfo info) Modifica um usuário na fonte de dados.
java.util.Set<java.lang.Object>	readAllUserIds() Recupera o conjunto de identificadores de todos os usuários existentes na fonte de dados.
java.util.List<csbase.logic.UserOutline>	readAllUserOutlines() Recupera da fonte de dados, uma lista de informações sumarizadas de todos os usuários do sistema.
java.util.List<csbase.logic.User>	readAllUsers() Recupera todos os usuários que existem na fonte de dados.
java.util.List<csbase.logic.UserUpdate>	readAllUserUpdates() Recupera uma lista de informações sumarizadas necessárias para fazer a atualização de uma cópia do repositório de usuários.
csbase.logic.User	readUser(java.lang.Object id) Recupera um usuário da fonte de dados pelo seu identificador.

Methods inherited from class java.lang.Object

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

Constructor Detail

DefaultUserDAO

public DefaultUserDAO()

Method Detail

createUser

public csbase.logic.User createUser(csbase.logic.UserInfo info)
                             throws DAOException

Description copied from interface: UserDAO

Persiste o usuário na fonte de dados.

Specified by:

createUser in interface UserDAO

Parameters:

info - informações de usuário que serão persistida.

Returns:

uma referência para o usuário persistido contendo o seu identificador.

Throws:

DAOException - se ocorrer algum problema na inclusão do usuário na fonte de dados.

deleteUser

public void deleteUser(java.lang.Object id)
                throws DAOException

Description copied from interface: UserDAO

Exclui um usuário na fonte de dados.

Specified by:

deleteUser in interface UserDAO

Parameters:

id - identificador do usuário.

Throws:

DAOException - se ocorrer algum problema na exclusão do usuário na fonte de dados.

modifyUser

public csbase.logic.User modifyUser(java.lang.Object id,
                           csbase.logic.UserInfo info)
                             throws DAOException

Description copied from interface: UserDAO

Modifica um usuário na fonte de dados.

Specified by:

modifyUser in interface UserDAO

Parameters:

id - identificador do usuário.

info - informações que serão modificadas.

Returns:

uma referência para o usuário modificado.

Throws:

DAOException - se ocorrer algum problema na modificação do usuário na fonte de dados.

readAllUserIds

public java.util.Set<java.lang.Object> readAllUserIds()
                                               throws DAOException

Description copied from interface: UserDAO

Recupera o conjunto de identificadores de todos os usuários existentes na fonte de dados.

Specified by:

readAllUserIds in interface UserDAO

Returns:

uma referência para o conjunto de identificadores.

Throws:

DAOException - se ocorrer algum problema na consulta a fonte de dados.

readAllUserOutlines

public java.util.List<csbase.logic.UserOutline> readAllUserOutlines()
                                                             throws DAOException

Description copied from interface: UserDAO

Recupera da fonte de dados, uma lista de informações sumarizadas de todos os usuários do sistema.

Specified by:

readAllUserOutlines in interface UserDAO

Returns:

uma referência para a lista com as informações sumarizadas dos usuários.

Throws:

DAOException - se ocorrer algum problema na consulta a fonte de dados.

readAllUserUpdates

public java.util.List<csbase.logic.UserUpdate> readAllUserUpdates()
                                                           throws DAOException

Description copied from interface: UserDAO

Recupera uma lista de informações sumarizadas necessárias para fazer a atualização de uma cópia do repositório de usuários. Essas informações são representadas por objetos da classe UserUpdate.

Specified by:

readAllUserUpdates in interface UserDAO

Returns:

uma referência para a lista com os resumos de atualização de todos os usuários.

Throws:

DAOException - se ocorrer algum problema na consulta a fonte de dados.

readAllUsers

public java.util.List<csbase.logic.User> readAllUsers()
                                               throws DAOException

Description copied from interface: UserDAO

Recupera todos os usuários que existem na fonte de dados.

Specified by:

readAllUsers in interface UserDAO

Returns:

uma referência para a lista com os usuários.

Throws:

DAOException - se ocorrer algum problema na consulta a fonte de dados.

readUser

public csbase.logic.User readUser(java.lang.Object id)
                           throws DAOException

Description copied from interface: UserDAO

Recupera um usuário da fonte de dados pelo seu identificador.

Specified by:

readUser in interface UserDAO

Parameters:

id - identificador do usuário.

Returns:

referência para o usuário ou nulo se o usuário não existir na fonte de dados.

Throws:

DAOException - se ocorrer algum problema na consulta a fonte de dados.

changeUser

public csbase.logic.User changeUser(csbase.logic.User superuser,
                           java.lang.String delegatedLogin)
                             throws DAOException

Tranforma um super-usuário em um usuário comum. IMPORTANTE: Se o usuário passado por parâmetro for um super-usuário, cria uma instância de User para o usuário delegado por ele, senão deve ser lançada uma PermissionException. Se o usuário for um super-usuário, cria uma instância de User para o usuário delegado por ele. OBS: O Administrador(admin) não precisa de permissão de super-usuário para delegar um outro usuário e, por questões de segurança, não pode ser um usuário delegado por nenhum super-usuário.

Specified by:

changeUser in interface UserDAO

Parameters:

superuser - usuário no qual será verificado a permissão de super-usuário.

delegatedLogin - login do usuário que será delegado pelo super-usuário sem a necessidade de senha.

Returns:

uma instância de User para o usuário delegado ou nulo se delegatedLogin for nulo.

Throws:

csbase.exception.PermissionException - se o usuário não tiver permissão de super-usuário ou se o usuário delegado for o Administrador(login=admin).

csbase.exception.ServiceFailureException - se ocorrer erro na criação do usuário delegado.

DAOException - se ocorrer algum problema na consulta a fonte de dados.