csbase.remote

Interface AdministrationServiceInterface

All Superinterfaces:

java.rmi.Remote, RemoteObservable, ServiceInterface, TransactionInterface

public interface AdministrationServiceInterface
extends TransactionInterface, ServiceInterface, RemoteObservable

Define a interface remota do serviço de acesso a usuários, grupos de usuários, perfis e plataformas.

Author:

Tecgraf/PUC-Rio

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	SERVICE_NAME Nome do serviço para o ServiceManager

Method Summary

Methods

Modifier and Type	Method and Description
Permission	createPermission(Permission permission) Cria uma nova permissão no sistema.
Platform	createPlatform(PlatformInfo info) Cria uma nova plataforma no sistema.
Role	createRole(RoleInfo info) Cria um novo perfil no sistema.
User	createUser(UserInfo info) Cria um novo usuário no sistema.
UserGroup	createUserGroup(UserGroupInfo info) Cria um novo UserGroup no sistema.
void	deletePermission(java.lang.Object id) Remove uma permissão do sistema.
void	deletePlatform(java.lang.Object id) Remove uma plataforma
void	deleteRole(java.lang.Object id) Remove um perfil do sistema.
void	deleteUser(java.lang.Object id) Remove um usuário do sistema.
void	deleteUserGroup(java.lang.Object id) Remove um UserGroup do sistema.
java.util.List<Permission>	getAllPermissions() Obtém todas as permissões cadastradas no sistema.
java.util.List<Permission>	getAllPermissionsWithPasswords() Obtém todas as permissões cadastradas no sistema, com eventuais senhas que elas possuam.
java.util.List<Platform>	getAllPlatforms() Obtém todas as plataformas cadastradas no sistema.
java.util.List<Role>	getAllRoles() Obtém todos os perfis cadastrados no sistema.
java.util.List<UserGroup>	getAllUserGroups() Obtém uma lista de todas os UserGroups do sistema.
java.util.List<UserOutline>	getAllUserOutlines() Obtém uma lista de informações sumarizadas de todos os usuários do sistema.
java.util.List<User>	getAllUsers() Obtém um vetor de todos os usuários do sistema.
java.util.List<UserUpdate>	getAllUserUpdates() Obtém uma lista de informações sumarizadas necessárias para fazer a atualização de uma cópia do repositório de usuários.
Permission	getPermission(java.lang.Object id) Obtém uma permissão que possui uma determinada identificação.
java.util.List<java.lang.String>	getPermissionClasses() Obtém os nomes de todas as classes concretas de permissões utilizadas no sistema.
Permission	getPermissionWithPassword(java.lang.Object id) Obtém uma permissão que possui uma determinada identificação.
javax.swing.ImageIcon	getPhoto(java.lang.Object id) Busca a foto de um usuário.
Platform	getPlatform(java.lang.Object id) Obtém a plataforma que possui o identificador especificado.
Role	getRole(java.lang.Object id) Obtém um perfil que possui uma determinada identificação.
User	getUser(java.lang.Object id) Obtém um usuário que possui uma determinada identificação.
UserGroup	getUserGroup(java.lang.Object id) Obtém um UserGroup que possui uma determinada identificação.
Permission	modifyPermission(java.lang.Object id, Permission permission) Modifica uma permissão no sistema.
Platform	modifyPlatform(java.lang.Object id, PlatformInfo info) Modifica uma plataforma no sistema.
Role	modifyRole(java.lang.Object id, RoleInfo info) Modifica um perfil no sistema.
User	modifyUser(java.lang.Object id, UserInfo info) Modifica um usuário no sistema.
UserGroup	modifyUserGroup(java.lang.Object id, UserGroupInfo info) Modifica um UserGroup no sistema.

Methods inherited from interface csbase.remote.TransactionInterface

isLocked, lock, unlock

Methods inherited from interface csbase.remote.ServiceInterface

getName, isActive

Methods inherited from interface csbase.remote.RemoteObservable

addObserver, countObservers, deleteObserver, deleteObservers, notifyObservers

Field Detail

SERVICE_NAME

static final java.lang.String SERVICE_NAME

Nome do serviço para o ServiceManager

See Also:

Constant Field Values

Method Detail

getAllUsers

java.util.List<User> getAllUsers()
                                 throws java.rmi.RemoteException

Obtém um vetor de todos os usuários do sistema. Essas informações são representadas por objetos da classe User.

Returns:

um vetor com todos os usuários

Throws:

java.rmi.RemoteException

getAllUserUpdates

java.util.List<UserUpdate> getAllUserUpdates()
                                             throws java.rmi.RemoteException

Obtém 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:

um vetor com os resumos de atualização de todos os usuários

Throws:

java.rmi.RemoteException

getAllUserOutlines

java.util.List<UserOutline> getAllUserOutlines()
                                               throws java.rmi.RemoteException

Obtém uma lista de informações sumarizadas de todos os usuários do sistema.

Returns:

um vetor com informações de usuários

Throws:

java.rmi.RemoteException

getUser

User getUser(java.lang.Object id)
             throws java.rmi.RemoteException

Obtém um usuário que possui uma determinada identificação.

Parameters:

id - a identificação de um usuário

Returns:

o usuário que possui a identificação requisitada ou null caso esse usuário não exista

Throws:

java.rmi.RemoteException

createUser

User createUser(UserInfo info)
                throws java.rmi.RemoteException

Cria um novo usuário no sistema. Não podem existir dois usuários com o mesmo login.

Parameters:

info - os dados do usuário a ser incluído

Returns:

o novo usuário

Throws:

java.rmi.RemoteException

getPhoto

javax.swing.ImageIcon getPhoto(java.lang.Object id)
                               throws java.rmi.RemoteException

Busca a foto de um usuário.

Parameters:

id - a identificação do usuário a ser modificado

Returns:

a imagem

Throws:

java.rmi.RemoteException

modifyUser

User modifyUser(java.lang.Object id,
              UserInfo info)
                throws java.rmi.RemoteException

Modifica um usuário no sistema. Não é permitido mudar o login de um usuário.

Parameters:

id - a identificação do usuário a ser modificado

info - o dados a serem usuados na modificação desse usuário

Returns:

o usuário após a modificação

Throws:

java.rmi.RemoteException

deleteUser

void deleteUser(java.lang.Object id)
                throws java.rmi.RemoteException,
                       AdministrationDeleteException

Remove um usuário do sistema.

Parameters:

id - o identificador do usuário a ser removido do sistema.

Throws:

java.rmi.RemoteException - falha de rmi

AdministrationDeleteException - se o usuário possuir projetos

getAllUserGroups

java.util.List<UserGroup> getAllUserGroups()
                                           throws java.rmi.RemoteException

Obtém uma lista de todas os UserGroups do sistema.

Returns:

um vetor com os UserGroups

Throws:

java.rmi.RemoteException

getUserGroup

UserGroup getUserGroup(java.lang.Object id)
                       throws java.rmi.RemoteException

Obtém um UserGroup que possui uma determinada identificação.

Parameters:

id - a identificação de um UserGroup

Returns:

o UserGroup que possui a identificação requisitada ou null caso ele não exista

Throws:

java.rmi.RemoteException

createUserGroup

UserGroup createUserGroup(UserGroupInfo info)
                          throws java.rmi.RemoteException

Cria um novo UserGroup no sistema. Não podem existir dois UserGroups com o mesmo nome.

Parameters:

info - os dados do grupo de usuários a ser incluído

Returns:

o grupo de usuários criado

Throws:

java.rmi.RemoteException

modifyUserGroup

UserGroup modifyUserGroup(java.lang.Object id,
                        UserGroupInfo info)
                          throws java.rmi.RemoteException

Modifica um UserGroup no sistema. Não é possível mudar o nome de um UserGroup se já existir outro com esse mesmo nome.

Parameters:

id - o identificador do UserGroup a ser modificado

info - os dados da grupo de usuários a ser modificado

Returns:

o grupo de usuários modificado

Throws:

java.rmi.RemoteException

deleteUserGroup

void deleteUserGroup(java.lang.Object id)
                     throws java.rmi.RemoteException,
                            AdministrationDeleteException

Remove um UserGroup do sistema.

Parameters:

id - a identificação do grupo de usuários a ser removido do sistema.

Throws:

AdministrationDeleteException - erro levantado quando existe usuario associado com o UserGroup.

java.rmi.RemoteException

getAllRoles

java.util.List<Role> getAllRoles()
                                 throws java.rmi.RemoteException

Obtém todos os perfis cadastrados no sistema.

Returns:

vetor com os perfis

Throws:

java.rmi.RemoteException

getRole

Role getRole(java.lang.Object id)
             throws java.rmi.RemoteException

Obtém um perfil que possui uma determinada identificação.

Parameters:

id - a identificação de um perfil

Returns:

o perfil que possui a identificação requisitada

Throws:

java.rmi.RemoteException

createRole

Role createRole(RoleInfo info)
                throws java.rmi.RemoteException

Cria um novo perfil no sistema.

Parameters:

info - as informações do novo perfil.

Returns:

o perfil criado

Throws:

java.rmi.RemoteException

modifyRole

Role modifyRole(java.lang.Object id,
              RoleInfo info)
                throws java.rmi.RemoteException

Modifica um perfil no sistema.

Parameters:

id - - identificador do perfil a ser modificado

info - as informações a serem usadas na modificação do perfil.

Returns:

o perfil modificado

Throws:

java.rmi.RemoteException

deleteRole

void deleteRole(java.lang.Object id)
                throws java.rmi.RemoteException,
                       AdministrationDeleteException

Remove um perfil do sistema.

Parameters:

id - o identificador do perfil a ser removido do sistema.

Throws:

AdministrationDeleteException - erro levantado quando existe usuario associado com o perfil.

java.rmi.RemoteException

getPermissionClasses

java.util.List<java.lang.String> getPermissionClasses()
                                                      throws java.rmi.RemoteException

Obtém os nomes de todas as classes concretas de permissões utilizadas no sistema.

Returns:

vetor com os nomes das classes de permissões

Throws:

java.rmi.RemoteException

getAllPermissions

java.util.List<Permission> getAllPermissions()
                                             throws java.rmi.RemoteException

Obtém todas as permissões cadastradas no sistema.

Returns:

vetor com as permissões

Throws:

java.rmi.RemoteException

getAllPermissionsWithPasswords

java.util.List<Permission> getAllPermissionsWithPasswords()
                                                          throws java.rmi.RemoteException

Obtém todas as permissões cadastradas no sistema, com eventuais senhas que elas possuam. Este método é utilizado por servidores locais, logados como admin, para fazer a sincronização das bases de permissões. Todas as permissões do tipo UserPasswordPermission retornadas por este método têm a senha guardada no campo password.

Returns:

vetor com as permissões

Throws:

java.rmi.RemoteException

getPermission

Permission getPermission(java.lang.Object id)
                         throws java.rmi.RemoteException

Obtém uma permissão que possui uma determinada identificação.

Parameters:

id - a identificação de uma permissão

Returns:

a permissão que possui a identificação requisitada

Throws:

java.rmi.RemoteException

getPermissionWithPassword

Permission getPermissionWithPassword(java.lang.Object id)
                                     throws java.rmi.RemoteException

Obtém uma permissão que possui uma determinada identificação. Este método é utilizado por servidores locais, logados como admin, para fazer a sincronização das bases de permissões. Toda permissão do tipo UserPasswordPermission retornada por este método tem a senha guardada no campo password.

Parameters:

id - a identificação de uma permissão

Returns:

a permissão que possui a identificação requisitada, com senha

Throws:

java.rmi.RemoteException

createPermission

Permission createPermission(Permission permission)
                            throws java.rmi.RemoteException

Cria uma nova permissão no sistema.

Parameters:

permission - a nova permissão.

Returns:

a permissão criada

Throws:

java.rmi.RemoteException

modifyPermission

Permission modifyPermission(java.lang.Object id,
                          Permission permission)
                            throws java.rmi.RemoteException

Modifica uma permissão no sistema.

Parameters:

id - o identificador da permissão a ser alterada.

permission - a nova versão da permissão.

Returns:

a permissão modificada

Throws:

java.rmi.RemoteException

deletePermission

void deletePermission(java.lang.Object id)
                      throws java.rmi.RemoteException,
                             AdministrationDeleteException

Remove uma permissão do sistema.

Parameters:

id - o identificador da permissão a ser removida do sistema.

Throws:

AdministrationDeleteException - erro levantado quando existe usuario ou um perfil utilizando a permissão.

java.rmi.RemoteException

getAllPlatforms

java.util.List<Platform> getAllPlatforms()
                                         throws java.rmi.RemoteException

Obtém todas as plataformas cadastradas no sistema.

Returns:

vetor com as plataformas

Throws:

java.rmi.RemoteException

getPlatform

Platform getPlatform(java.lang.Object id)
                     throws java.rmi.RemoteException

Obtém a plataforma que possui o identificador especificado.

Parameters:

id - identificador da plataforma

Returns:

plataforma que possui o identificador especificado ou null caso essa plataforma não exista

Throws:

java.rmi.RemoteException

createPlatform

Platform createPlatform(PlatformInfo info)
                        throws java.rmi.RemoteException

Cria uma nova plataforma no sistema.

Parameters:

info - as informações da nova plataforma

Returns:

plataforma criada

Throws:

java.rmi.RemoteException

modifyPlatform

Platform modifyPlatform(java.lang.Object id,
                      PlatformInfo info)
                        throws java.rmi.RemoteException

Modifica uma plataforma no sistema.

Parameters:

id - identificador da plataforma a ser modificada

info - as novas informações da plataforma

Returns:

plataforma modificada

Throws:

java.rmi.RemoteException

deletePlatform

void deletePlatform(java.lang.Object id)
                    throws java.rmi.RemoteException

Remove uma plataforma

Parameters:

id - identificador da plataforma a ser removida

Throws:

java.rmi.RemoteException