csbase.server.services.administrationservice

Class AdministrationService

java.lang.Object

csbase.remote.RemoteObjectObservable

csbase.server.ServerRemoteObjectObservable

csbase.server.Service

csbase.server.services.administrationservice.AdministrationService

All Implemented Interfaces:

csbase.remote.AdministrationServiceInterface, csbase.remote.RemoteObservable, csbase.remote.RemoteObserverNotifierInterface, csbase.remote.ServiceInterface, csbase.remote.TransactionCallbackInterface, csbase.remote.TransactionInterface, java.rmi.Remote

Direct Known Subclasses:

LocalAdministrationService

public class AdministrationService
extends Service
implements csbase.remote.AdministrationServiceInterface, csbase.remote.TransactionCallbackInterface

A classe AdministrationService implementa o serviço central de administração, responsável pela gerência de usuários, grupos de usuários, perfis e plataformas. Servidores locais usam instâncias da sub-classe LocalAdministrationService.

Author:

Tecgraf/PUC-Rio

Field Summary

Fields

Modifier and Type	Field and Description
protected PermissionDAO	permissionDAO Objeto de acesso a dados de Permissões
protected PlatformDAO	platformDAO Objeto de acesso a dados de plataformas
protected RoleDAO	roleDAO Objeto de acesso a dados de perfis
protected TransactionManager	transaction Gerente de transações
protected UserDAO	userDAO Objeto de acesso a dados de usuários
protected UserGroupDAO	userGroupsDAO Objeto de acesso a dados de UserGroup's

Fields inherited from class csbase.remote.RemoteObjectObservable

observerManager

Fields inherited from interface csbase.remote.AdministrationServiceInterface

SERVICE_NAME

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AdministrationService() Cria uma instância do serviço de administração.

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.
protected void	checkCreatePermissionPermission() Verifica se o usuário pode criar permissões.
protected void	checkCreatePlatformPermission() Verifica se o usuário pode criar plataformas.
protected void	checkCreateRolePermission() Verifica se o usuário pode criar perfis.
protected void	checkCreateUserGroupPermission() Verifica se o usuário pode criar grupos de usuários.
protected void	checkCreateUserPermission() Verifica se o usuário pode criar usuários.
protected void	checkDeletePermissionPermission() Verifica se o usuário pode remover permissões.
protected void	checkDeletePlatformPermission() Verifica se o usuário pode remover plataformas.
protected void	checkDeleteRolePermission() Verifica se o usuário pode remover perfis.
protected void	checkDeleteUserGroupPermission() Verifica se o usuário pode remover grupos de usuários.
protected void	checkDeleteUserPermission() Verifica se o usuário pode remover usuários.
protected void	checkGetPermissionWithPassword() Verifica se o usuário pode obter permissões com senhas.
protected void	checkModifyPermissionPermission() Verifica se o usuário pode alterar permissões.
protected void	checkModifyPlatformPermission() Verifica se o usuário pode alterar plataformas.
protected void	checkModifyRolePermission() Verifica se o usuário pode alterar perfis.
protected void	checkModifyUserGroupPermission() Verifica se o usuário pode alterar grupos de usuários.
protected void	checkModifyUserPermission(java.lang.Object id, csbase.logic.UserInfo info) Verifica se o usuário corrente pode alterar um usuário.
protected void	checkNoProjects(java.lang.Object userId) Verifica se um usuário possui projetos.
protected void	checkTransaction() Verifica se a transação está travada.
csbase.logic.Permission	createPermission(csbase.logic.Permission permission)
csbase.logic.Platform	createPlatform(csbase.logic.PlatformInfo info)
csbase.logic.Role	createRole(csbase.logic.RoleInfo info)
static void	createService() Constrói uma instância do serviço.
csbase.logic.User	createUser(csbase.logic.UserInfo info)
csbase.logic.UserGroup	createUserGroup(csbase.logic.UserGroupInfo info)
void	deletePermission(java.lang.Object id)
void	deletePlatform(java.lang.Object id)
void	deleteRole(java.lang.Object id)
void	deleteUser(java.lang.Object id)
void	deleteUserGroup(java.lang.Object id)
java.util.List<csbase.logic.Permission>	getAllPermissions()
java.util.List<csbase.logic.Permission>	getAllPermissionsWithPasswords()
java.util.List<csbase.logic.Platform>	getAllPlatforms()
java.util.List<csbase.logic.Role>	getAllRoles()
java.util.List<csbase.logic.UserGroup>	getAllUserGroups()
java.util.Set<java.lang.Object>	getAllUserIds() Obtém os identificadores de todos os usuários do sistema.
java.util.List<csbase.logic.UserOutline>	getAllUserOutlines()
java.util.List<csbase.logic.User>	getAllUsers()
java.util.List<csbase.logic.UserUpdate>	getAllUserUpdates()
static AdministrationService	getInstance() Obtém uma instância do servico.
csbase.logic.Permission	getPermission(java.lang.Object id)
java.util.List<java.lang.String>	getPermissionClasses()
csbase.logic.Permission	getPermissionWithPassword(java.lang.Object id)
javax.swing.ImageIcon	getPhoto(java.lang.Object id)
java.lang.String	getPhotoDirectory() Obtém o diretório de fotos.
csbase.logic.Platform	getPlatform(java.lang.Object id)
csbase.logic.Role	getRole(java.lang.Object id)
csbase.logic.User	getUser(java.lang.Object id)
csbase.logic.UserGroup	getUserGroup(java.lang.Object id)
protected boolean	has2Update(java.lang.Object arg, java.lang.Object event) Indica se, para o argumento fornecido, o evento especificado precisa ser notificado ao observador.
void	initService() Método abstrato de inicialização do serviço.
boolean	isAlive()
boolean	isLocked()
boolean	lock(csbase.remote.TransactionCallbackInterface cb)
csbase.logic.Permission	modifyPermission(java.lang.Object id, csbase.logic.Permission permission)
csbase.logic.Platform	modifyPlatform(java.lang.Object id, csbase.logic.PlatformInfo info)
csbase.logic.Role	modifyRole(java.lang.Object id, csbase.logic.RoleInfo info)
csbase.logic.User	modifyUser(java.lang.Object id, csbase.logic.UserInfo info)
csbase.logic.UserGroup	modifyUserGroup(java.lang.Object id, csbase.logic.UserGroupInfo info)
protected void	notifyObservers(int type, java.lang.Object item) Notifica alteração aos observadores.
protected void	removeUserFromSharedProjects(java.lang.Object userId) Remove o usuário de todos os projetos a que ele tem acesso, porém não é dono.
void	shutdownService() Método abstrato de término do serviço
void	unlock(csbase.remote.TransactionCallbackInterface cb)

Methods inherited from class csbase.server.Service

getBooleanProperty, getDefaultLocale, getDoubleProperty, getExternalPropertyFile, getFormattedString, getFormattedString, getInitializationDependencies, getInstance, getIntProperty, getKey, getLongProperty, getName, getOptionalString, getOptionalString, getOSPropertyPath, getSenderName, getServices, getString, getString, getStringListProperty, getStringProperty, getSystemId, getThreadLocale, getUser, getUserPermission, hasProperty, incrCounter, isActive, isEnabled, isInternalServerRequest, isLoggingNotifications, isPropertyNull, logNotification, setEnabled, setKey, setSystemId, setUserId

Methods inherited from class csbase.server.ServerRemoteObjectObservable

handleException, handleFatalError

Methods inherited from class csbase.remote.RemoteObjectObservable

addObserver, countObservers, deleteObserver, deleteObserver, deleteObservers, has2update, notifyObservers

Methods inherited from class java.lang.Object

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

Methods inherited from interface csbase.remote.ServiceInterface

getName, isActive

Methods inherited from interface csbase.remote.RemoteObservable

addObserver, countObservers, deleteObserver, deleteObservers, notifyObservers

Field Detail

transaction

protected TransactionManager transaction

Gerente de transações

userDAO

protected UserDAO userDAO

Objeto de acesso a dados de usuários

userGroupsDAO

protected UserGroupDAO userGroupsDAO

Objeto de acesso a dados de UserGroup's

roleDAO

protected RoleDAO roleDAO

Objeto de acesso a dados de perfis

platformDAO

protected PlatformDAO platformDAO

Objeto de acesso a dados de plataformas

permissionDAO

protected PermissionDAO permissionDAO

Objeto de acesso a dados de Permissões

Constructor Detail

AdministrationService

protected AdministrationService()
                         throws ServerException

Cria uma instância do serviço de administração.

Throws:

ServerException - Caso ocorra algum erro na criação do serviço.

Method Detail

createService

public static void createService()
                          throws ServerException

Constrói uma instância do serviço.

Throws:

ServerException - Caso ocorra algum erro na criação do serviço.

getInstance

public static AdministrationService getInstance()

Obtém uma instância do servico.

Returns:

Instância do servico.

shutdownService

public void shutdownService()

Método abstrato de término do serviço

Specified by:

shutdownService in class Service

getPhotoDirectory

public java.lang.String getPhotoDirectory()

Obtém o diretório de fotos.

Returns:

O diretório de fotos.

initService

public void initService()
                 throws ServerException

Método abstrato de inicialização do serviço.

Specified by:

initService in class Service

Throws:

ServerException - em caso de falha

notifyObservers

protected void notifyObservers(int type,
                   java.lang.Object item)

Notifica alteração aos observadores.

Parameters:

type - O tipo do evento.

item - O argumento que será enviado aos observadores.

has2Update

protected boolean has2Update(java.lang.Object arg,
                 java.lang.Object event)

Indica se, para o argumento fornecido, o evento especificado precisa ser notificado ao observador.

Specified by:

has2Update in class csbase.remote.RemoteObjectObservable

Parameters:

arg - argumento do observador.

event - evento a ser enviado.

Returns:

se o evento deve ser enviado.

lock

public boolean lock(csbase.remote.TransactionCallbackInterface cb)

Specified by:

lock in interface csbase.remote.TransactionInterface

isLocked

public boolean isLocked()

Specified by:

isLocked in interface csbase.remote.TransactionInterface

unlock

public void unlock(csbase.remote.TransactionCallbackInterface cb)

Specified by:

unlock in interface csbase.remote.TransactionInterface

checkTransaction

protected void checkTransaction()
                         throws csbase.exception.ServiceFailureException

Verifica se a transação está travada.

Throws:

csbase.exception.ServiceFailureException - Caso a transação esteja travada.

getUser

public csbase.logic.User getUser(java.lang.Object id)

Specified by:

getUser in interface csbase.remote.AdministrationServiceInterface

getAllUserUpdates

public java.util.List<csbase.logic.UserUpdate> getAllUserUpdates()

Specified by:

getAllUserUpdates in interface csbase.remote.AdministrationServiceInterface

getAllUserIds

public java.util.Set<java.lang.Object> getAllUserIds()

Obtém os identificadores de todos os usuários do sistema.

Returns:

Um conjunto com os identificadores de todos os usuários do sistema.

getAllUserOutlines

public java.util.List<csbase.logic.UserOutline> getAllUserOutlines()

Specified by:

getAllUserOutlines in interface csbase.remote.AdministrationServiceInterface

getAllUsers

public java.util.List<csbase.logic.User> getAllUsers()

Specified by:

getAllUsers in interface csbase.remote.AdministrationServiceInterface

checkCreateUserPermission

protected void checkCreateUserPermission()
                                  throws csbase.exception.PermissionException

Verifica se o usuário pode criar usuários.

Throws:

csbase.exception.PermissionException - Caso o usuário não possa criar usuários.

createUser

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

Specified by:

createUser in interface csbase.remote.AdministrationServiceInterface

checkModifyUserPermission

protected void checkModifyUserPermission(java.lang.Object id,
                             csbase.logic.UserInfo info)
                                  throws java.rmi.RemoteException,
                                         csbase.exception.PermissionException

Verifica se o usuário corrente pode alterar um usuário.

Parameters:

id - O identificador do usuário que será alterado.

info - Informações sobre o usuário que será alterado.

Throws:

java.rmi.RemoteException - falha de rmi

csbase.exception.PermissionException - Caso o usuário corrente não possa alterar um usuário.

getPhoto

public javax.swing.ImageIcon getPhoto(java.lang.Object id)

Specified by:

getPhoto in interface csbase.remote.AdministrationServiceInterface

modifyUser

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

Specified by:

modifyUser in interface csbase.remote.AdministrationServiceInterface

Throws:

java.rmi.RemoteException

checkDeleteUserPermission

protected void checkDeleteUserPermission()
                                  throws csbase.exception.PermissionException

Verifica se o usuário pode remover usuários.

Throws:

csbase.exception.PermissionException - Caso o usuário não possa remover usuários.

checkNoProjects

protected void checkNoProjects(java.lang.Object userId)
                        throws csbase.exception.administration.AdministrationDeleteException

Verifica se um usuário possui projetos.

Parameters:

userId - O identificador do usuário.

Throws:

csbase.exception.administration.AdministrationDeleteException - Caso o usuário possua projetos.

removeUserFromSharedProjects

protected void removeUserFromSharedProjects(java.lang.Object userId)

Remove o usuário de todos os projetos a que ele tem acesso, porém não é dono.

Parameters:

userId - id do usuário.

deleteUser

public void deleteUser(java.lang.Object id)
                throws java.rmi.RemoteException,
                       csbase.exception.administration.AdministrationDeleteException

Specified by:

deleteUser in interface csbase.remote.AdministrationServiceInterface

Throws:

java.rmi.RemoteException

csbase.exception.administration.AdministrationDeleteException

changeUser

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

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:

csbase.exception.ServiceFailureException - se ocorrer algum problema no acesso aos dados.

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

getUserGroup

public csbase.logic.UserGroup getUserGroup(java.lang.Object id)

Specified by:

getUserGroup in interface csbase.remote.AdministrationServiceInterface

getAllUserGroups

public java.util.List<csbase.logic.UserGroup> getAllUserGroups()

Specified by:

getAllUserGroups in interface csbase.remote.AdministrationServiceInterface

checkCreateUserGroupPermission

protected void checkCreateUserGroupPermission()
                                       throws csbase.exception.PermissionException

Verifica se o usuário pode criar grupos de usuários.

Throws:

csbase.exception.PermissionException - Caso o usuário não possa criar grupos d usuários.

createUserGroup

public csbase.logic.UserGroup createUserGroup(csbase.logic.UserGroupInfo info)

Specified by:

createUserGroup in interface csbase.remote.AdministrationServiceInterface

checkModifyUserGroupPermission

protected void checkModifyUserGroupPermission()
                                       throws csbase.exception.PermissionException

Verifica se o usuário pode alterar grupos de usuários.

Throws:

csbase.exception.PermissionException - Caso o usuário não possa alterar grupos de usuários.

modifyUserGroup

public csbase.logic.UserGroup modifyUserGroup(java.lang.Object id,
                                     csbase.logic.UserGroupInfo info)

Specified by:

modifyUserGroup in interface csbase.remote.AdministrationServiceInterface

checkDeleteUserGroupPermission

protected void checkDeleteUserGroupPermission()
                                       throws csbase.exception.PermissionException

Verifica se o usuário pode remover grupos de usuários.

Throws:

csbase.exception.PermissionException - Caso o usuário não possa remover grupos de usuários.

deleteUserGroup

public void deleteUserGroup(java.lang.Object id)
                     throws java.rmi.RemoteException,
                            csbase.exception.administration.AdministrationDeleteException

Specified by:

deleteUserGroup in interface csbase.remote.AdministrationServiceInterface

Throws:

java.rmi.RemoteException

csbase.exception.administration.AdministrationDeleteException

getAllRoles

public java.util.List<csbase.logic.Role> getAllRoles()

Specified by:

getAllRoles in interface csbase.remote.AdministrationServiceInterface

getRole

public csbase.logic.Role getRole(java.lang.Object id)

Specified by:

getRole in interface csbase.remote.AdministrationServiceInterface

checkCreateRolePermission

protected void checkCreateRolePermission()
                                  throws csbase.exception.PermissionException

Verifica se o usuário pode criar perfis.

Throws:

csbase.exception.PermissionException - Caso o usuário não possa criar perfis.

createRole

public csbase.logic.Role createRole(csbase.logic.RoleInfo info)

Specified by:

createRole in interface csbase.remote.AdministrationServiceInterface

checkModifyRolePermission

protected void checkModifyRolePermission()
                                  throws csbase.exception.PermissionException

Verifica se o usuário pode alterar perfis.

Throws:

csbase.exception.PermissionException - Caso o usuário não possa alterar perfis.

modifyRole

public csbase.logic.Role modifyRole(java.lang.Object id,
                           csbase.logic.RoleInfo info)

Specified by:

modifyRole in interface csbase.remote.AdministrationServiceInterface

checkDeleteRolePermission

protected void checkDeleteRolePermission()
                                  throws csbase.exception.PermissionException

Verifica se o usuário pode remover perfis.

Throws:

csbase.exception.PermissionException - Caso o usuário não possa remover perfis.

deleteRole

public void deleteRole(java.lang.Object id)
                throws csbase.exception.administration.AdministrationDeleteException,
                       java.rmi.RemoteException

Specified by:

deleteRole in interface csbase.remote.AdministrationServiceInterface

Throws:

csbase.exception.administration.AdministrationDeleteException

java.rmi.RemoteException

getPermissionClasses

public java.util.List<java.lang.String> getPermissionClasses()

Specified by:

getPermissionClasses in interface csbase.remote.AdministrationServiceInterface

getAllPermissions

public java.util.List<csbase.logic.Permission> getAllPermissions()

Specified by:

getAllPermissions in interface csbase.remote.AdministrationServiceInterface

checkGetPermissionWithPassword

protected void checkGetPermissionWithPassword()
                                       throws csbase.exception.PermissionException

Verifica se o usuário pode obter permissões com senhas.

Throws:

csbase.exception.PermissionException - Caso o usuário não possa obter permissões com senhas.

getAllPermissionsWithPasswords

public java.util.List<csbase.logic.Permission> getAllPermissionsWithPasswords()

Specified by:

getAllPermissionsWithPasswords in interface csbase.remote.AdministrationServiceInterface

getPermission

public csbase.logic.Permission getPermission(java.lang.Object id)

Specified by:

getPermission in interface csbase.remote.AdministrationServiceInterface

getPermissionWithPassword

public csbase.logic.Permission getPermissionWithPassword(java.lang.Object id)

Specified by:

getPermissionWithPassword in interface csbase.remote.AdministrationServiceInterface

checkCreatePermissionPermission

protected void checkCreatePermissionPermission()
                                        throws csbase.exception.PermissionException

Verifica se o usuário pode criar permissões.

Throws:

csbase.exception.PermissionException - Caso o usuário não possa criar permissões.

createPermission

public csbase.logic.Permission createPermission(csbase.logic.Permission permission)

Specified by:

createPermission in interface csbase.remote.AdministrationServiceInterface

checkModifyPermissionPermission

protected void checkModifyPermissionPermission()
                                        throws csbase.exception.PermissionException

Verifica se o usuário pode alterar permissões.

Throws:

csbase.exception.PermissionException - Caso o usuário não possa alterar permissões.

modifyPermission

public csbase.logic.Permission modifyPermission(java.lang.Object id,
                                       csbase.logic.Permission permission)

Specified by:

modifyPermission in interface csbase.remote.AdministrationServiceInterface

checkDeletePermissionPermission

protected void checkDeletePermissionPermission()
                                        throws csbase.exception.PermissionException

Verifica se o usuário pode remover permissões.

Throws:

csbase.exception.PermissionException - Caso o usuário não possa remover permissões.

deletePermission

public void deletePermission(java.lang.Object id)
                      throws csbase.exception.administration.AdministrationDeleteException,
                             java.rmi.RemoteException

Specified by:

deletePermission in interface csbase.remote.AdministrationServiceInterface

Throws:

csbase.exception.administration.AdministrationDeleteException

java.rmi.RemoteException

getAllPlatforms

public java.util.List<csbase.logic.Platform> getAllPlatforms()

Specified by:

getAllPlatforms in interface csbase.remote.AdministrationServiceInterface

getPlatform

public csbase.logic.Platform getPlatform(java.lang.Object id)

Specified by:

getPlatform in interface csbase.remote.AdministrationServiceInterface

checkCreatePlatformPermission

protected void checkCreatePlatformPermission()
                                      throws csbase.exception.PermissionException

Verifica se o usuário pode criar plataformas.

Throws:

csbase.exception.PermissionException - Caso o usuário não possa criar plataformas.

createPlatform

public csbase.logic.Platform createPlatform(csbase.logic.PlatformInfo info)

Specified by:

createPlatform in interface csbase.remote.AdministrationServiceInterface

checkModifyPlatformPermission

protected void checkModifyPlatformPermission()
                                      throws csbase.exception.PermissionException

Verifica se o usuário pode alterar plataformas.

Throws:

csbase.exception.PermissionException - Caso o usuário não possa alterar plataformas.

modifyPlatform

public csbase.logic.Platform modifyPlatform(java.lang.Object id,
                                   csbase.logic.PlatformInfo info)

Specified by:

modifyPlatform in interface csbase.remote.AdministrationServiceInterface

checkDeletePlatformPermission

protected void checkDeletePlatformPermission()
                                      throws csbase.exception.PermissionException

Verifica se o usuário pode remover plataformas.

Throws:

csbase.exception.PermissionException - Caso o usuário não possa remover plataformas.

deletePlatform

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

Specified by:

deletePlatform in interface csbase.remote.AdministrationServiceInterface

Throws:

java.rmi.RemoteException

isAlive

public boolean isAlive()
                throws java.rmi.RemoteException

Specified by:

isAlive in interface csbase.remote.TransactionCallbackInterface

Throws:

java.rmi.RemoteException