csbase.server.services.administrationservice

Interface UserDAO

All Known Implementing Classes:

DefaultUserDAO

public interface UserDAO

Interface para acesso a dados de usuários. A criação de objetos que implementam essa interface é responsabilidade da fábrica de DAOs do serviço de administração (AdministrationDAOFactory ).

Author:

Jorge Alexandre

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.

Method Detail

readUser

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

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

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.

readAllUserUpdates

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

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.

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.

readAllUserIds

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

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

Returns:

uma referência para o conjunto de identificadores.

Throws:

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

readAllUserOutlines

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

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

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.

readAllUsers

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

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

Returns:

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

Throws:

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

createUser

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

Persiste o usuário na fonte de dados.

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.

modifyUser

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

Modifica um usuário na fonte de dados.

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.

deleteUser

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

Exclui um usuário na fonte de dados.

Parameters:

id - identificador do usuário.

Throws:

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

changeUser

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.

Parameters:

superuser - referência para um super-usuário.

delegatedLogin - identificador de login para um usuário comum (delegado).

Returns:

uma referência para o usuário delegado.

Throws:

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

PermissionException - se o usuário passado no parâmetro superuser NÃO for um super-usuário.