csbase.logic

Class Role

java.lang.Object

csbase.logic.Role

All Implemented Interfaces:

IdInterface, java.io.Serializable

public class Role
extends java.lang.Object
implements java.io.Serializable, IdInterface

A classe Role representa um perfil de permissões.

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
Role(java.lang.Object id, RoleInfo info) Cria um perfil.

Method Summary

Methods

Modifier and Type	Method and Description
static void	addObserver(java.util.Observer o) Adiciona um observador local da classe.
static Role	createRole(RoleInfo info) Solicita ao provedor para criar um novo perfil no sistema.
static void	deleteObserver(java.util.Observer o) Remove um observador local da classe.
static void	deleteRole(java.lang.Object id) Solicita ao provedor para remover um perfil do sistema.
boolean	equalContents(java.lang.Object obj)
boolean	equals(java.lang.Object obj) Verifica se um perfil é igual a um outro.
static boolean	existsAnotherRole(java.lang.Object id, java.lang.String name) Verifica se já existe um outro perfil com o mesmo nome.
static java.util.List<Role>	getAllRoles() Solicita ao provedor todos os perfis cadastrados no sistema.
static java.util.List<Role>	getAllRoles(boolean sortByName) Solicita ao provedor todos os perfis cadastrados no sistema.
static java.util.Comparator<Role>	getDescrComparator() Obtém um comparator de Role pelo critério de ordem alfabética da descrição do perfil.
static Getter	getDescrGetter() Obtém um getter para a descrição de Role.
java.lang.String	getDescription() Obtém a descrição do perfil.
java.lang.Object	getId() Obtém o identificador do perfil.
java.lang.String	getName() Obtém nome do perfil.
static java.util.Comparator<Role>	getNameComparator() Obtém um comparator de Role pelo critério de ordem alfabética do nome do perfil.
static Getter	getNameGetter() Obtém um getter para o nome de Role.
java.lang.Object[]	getPermissionIds() Obtém as permissões do perfil.
static Role	getRole(java.lang.Object id) Solicita ao provedor um perfil que possui uma determinada identificação.
static Role	getRoleByName(java.lang.String name) Obtém o perfil que possui o nome especificado.
RoleInfo	getRoleInfo() Obtém uma cópia do RoleInfo deste perfil.
static boolean	hasAnyRoleWithPermission(java.lang.Object permissionId) Verifica se algum perfil possui uma determinada permissão.
int	hashCode() Calcula o código hash do objeto.
static Role	modifyRole(java.lang.Object id, RoleInfo info) Solicita ao provedor para modificar um perfil no sistema.
void	setPermissionIds(java.lang.Object[] permissionIds) Altera as permissões do perfil.
java.lang.String	toString()
static void	update(AdministrationEvent event) Esse método é chamado quando um serviço de administração sofre alguma alteração relativa a perfis.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

Role

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

Cria um perfil. Só será executado no servidor. Objetos são serializados para o cliente.

Parameters:

id - o identificador do perfil

info - as informações do perfil

Method Detail

getRole

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

Solicita ao provedor 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 ou null caso esse perfil não exista

Throws:

java.rmi.RemoteException - falha de rmi

getRoleByName

public static Role getRoleByName(java.lang.String name)
                          throws java.lang.Exception

Obtém o perfil que possui o nome especificado.

Parameters:

name - nome do perfil procurado

Returns:

perfil que possui o nome procurado ou null caso esse perfil não exista

Throws:

java.lang.Exception

getAllRoles

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

Solicita ao provedor todos os perfis cadastrados no sistema.

Returns:

um vetor com os perfis

Throws:

java.rmi.RemoteException - falha de rmi

existsAnotherRole

public static boolean existsAnotherRole(java.lang.Object id,
                        java.lang.String name)
                                 throws java.lang.Exception

Verifica se já existe um outro perfil com o mesmo nome.

Parameters:

id - o identificador de um perfil

name - o nome sendo procurado

Returns:

true se existir uma outro perfil com o nome procurado ou false no caso de não existir

Throws:

java.lang.Exception

getAllRoles

public static java.util.List<Role> getAllRoles(boolean sortByName)
                                        throws java.lang.Exception

Solicita ao provedor todos os perfis cadastrados no sistema. Os perfis podem estar ordenados por nome, se assim for solicitado.

Parameters:

sortByName - true se os perfis deverão estar ordenadas alfabeticamente pelo nome e false se a ordenação não é necessária

Returns:

um vetor com os perfis

Throws:

java.lang.Exception

createRole

public static Role createRole(RoleInfo info)
                       throws java.lang.Exception

Solicita ao provedor para criar um novo perfil no sistema.

Parameters:

info - as informações do perfil a ser criado.

Returns:

o perfil criado ou null caso já exista um perfil com a mesma identificação

Throws:

java.lang.Exception

modifyRole

public static Role modifyRole(java.lang.Object id,
              RoleInfo info)
                       throws java.lang.Exception

Solicita ao provedor para modificar um perfil no sistema.

Parameters:

id - a identificação do perfil a ser modificado

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

Returns:

o perfil modificado ou null se a modificação não pode ser efetuada: modificação de nome ou se não existe perfil com o identificador especificado.

Throws:

java.lang.Exception

deleteRole

public static void deleteRole(java.lang.Object id)
                       throws java.lang.Exception

Solicita ao provedor para remover um perfil do sistema.

Parameters:

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

Throws:

java.lang.Exception

update

public static void update(AdministrationEvent event)

Esse método é chamado quando um serviço de administração sofre alguma alteração relativa a perfis. Notifica seus observadores locais.

Parameters:

event - o evento que ocorreu no provedor de perfis

addObserver

public static void addObserver(java.util.Observer o)

Adiciona um observador local da classe. Sempre que a classe é avisada pelo serviço de administração de que alguma mudança ocorreu, os observadores locais também são notificados.

Parameters:

o - um observador local

deleteObserver

public static void deleteObserver(java.util.Observer o)

Remove um observador local da classe.

Parameters:

o - o observador a ser removido

getId

public java.lang.Object getId()

Obtém o identificador do perfil.

Specified by:

getId in interface IdInterface

Returns:

o identificador do perfil.

getName

public java.lang.String getName()

Obtém nome do perfil.

Returns:

o nome do perfil

getDescription

public java.lang.String getDescription()

Obtém a descrição do perfil.

Returns:

a descrição do perfil

getPermissionIds

public java.lang.Object[] getPermissionIds()

Obtém as permissões do perfil.

Returns:

o array de permissões do perfil.

setPermissionIds

public void setPermissionIds(java.lang.Object[] permissionIds)

Altera as permissões do perfil.

Parameters:

permissionIds - array de permissões do perfil.

getRoleInfo

public RoleInfo getRoleInfo()

Obtém uma cópia do RoleInfo deste perfil.

Returns:

a cópia do RoleInfo

getNameComparator

public static java.util.Comparator<Role> getNameComparator()

Obtém um comparator de Role pelo critério de ordem alfabética do nome do perfil.

Returns:

um comparador por nome

getDescrComparator

public static java.util.Comparator<Role> getDescrComparator()

Obtém um comparator de Role pelo critério de ordem alfabética da descrição do perfil.

Returns:

um comparador por descrição

getNameGetter

public static Getter getNameGetter()

Obtém um getter para o nome de Role.

Returns:

um getter para o nome

getDescrGetter

public static Getter getDescrGetter()

Obtém um getter para a descrição de Role.

Returns:

um getter para a descrição

equals

public boolean equals(java.lang.Object obj)

Verifica se um perfil é igual a um outro. Dois perfis de usuários são considerados o mesmo se eles possuem o mesmo identificador.

Overrides:

equals in class java.lang.Object

Parameters:

obj - o outro objeto com o qual esse perfil está sendo comparado.

Returns:

true ou false, se o perfil for ou não igual a um outro.

hashCode

public int hashCode()

Calcula o código hash do objeto.

Overrides:

hashCode in class java.lang.Object

Returns:

Inteiro que representa o código hash do objeto.

equalContents

public boolean equalContents(java.lang.Object obj)

hasAnyRoleWithPermission

public static boolean hasAnyRoleWithPermission(java.lang.Object permissionId)
                                        throws java.rmi.RemoteException

Verifica se algum perfil possui uma determinada permissão.

Parameters:

permissionId - Identificador da permissão.

Returns:

true caso o perfil possua esta permissão, ou false, caso contrário.

Throws:

java.rmi.RemoteException - falha de rmi

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object