tecgraf.openbus.admin

Class BusAdminImpl

java.lang.Object

tecgraf.openbus.admin.BusAdminImpl

All Implemented Interfaces:

BusAdmin

public class BusAdminImpl
extends Object
implements BusAdmin

A classe implementa os comandos especificados na interface BusAdmin.

Author:

Tecgraf

Constructor Summary

Constructors

Constructor and Description
BusAdminImpl() Construtor da classe.

Method Summary

Modifier and Type	Method and Description
void	addValidator(String validator) Adiciona um validador no barramento.
void	connect(String host, int port, ORB orb) Conecta a inst�ncia do objeto a um barramento.
tecgraf.openbus.core.v2_0.services.offer_registry.admin.v1_0.EntityCategory	createCategory(String categoryID, String categoryName) Cadastra uma nova categoria no barramento.
tecgraf.openbus.core.v2_0.services.offer_registry.admin.v1_0.RegisteredEntity	createEntity(String entityID, String entityName, String categoryID) Cadastra uma nova entidade no barramento.
boolean	createInterface(String interfaceName) Cadastra uma nova interface no barramento.
void	delValidator(String validator) Remove um validador do barramento.
List<String>	getAdmins() Retorna uma lista das entidades administradoras atuais.
Map<tecgraf.openbus.core.v2_0.services.offer_registry.admin.v1_0.RegisteredEntityDesc,List<String>>	getAuthorizations() Retorna um mapa que contém as descrições de todas as entidades registradas no barramento, associadas às suas respectivas autorizações.
List<tecgraf.openbus.core.v2_0.services.offer_registry.admin.v1_0.EntityCategoryDesc>	getCategories() Retorna uma lista que contém descrições de todas as categorias das entidades do barramento.
List<tecgraf.openbus.core.v2_0.services.offer_registry.admin.v1_0.RegisteredEntityDesc>	getEntities() Retorna uma lista que contém descrições de todas as entidades registradas no barramento.
List<String>	getEntitiesWithCertificate() Retorna uma lista que contém IDs de todas as etidades com certificado registrado no barramento.
List<String>	getInterfaces() Retorna uma lista que contém as IDs de todas as interfaces registradas no barramento.
List<tecgraf.openbus.core.v2_0.services.access_control.LoginInfo>	getLogins() Retorna lista que contém as informações de todos os logins ativos no barramento.
short	getLogLevel() Retorna o valor atual da propriedade loglevel do barramento.
int	getMaxChannels() Retorna o valor atual da propriedade maxchannels do barramento.
List<tecgraf.openbus.core.v2_0.services.offer_registry.ServiceOfferDesc>	getOffers() Retorna uma lista que contém todas as descrições de ofertas de serviços do barramento.
short	getOilLogLevel() Retorna o valor atual da propriedade oilloglevel do barramento.
List<String>	getValidators() Retorna uma lista dos validadores atualmente disponíveis no barramento.
void	grantAdminTo(List<String> users) Confere direitos de administração a uma lista de entidades.
void	invalidateLogin(tecgraf.openbus.core.v2_0.services.access_control.LoginInfo loginInfo) Invalida um login ativo no barramento.
boolean	isReconfigurationCapable() Indica se o barramento disponibiliza a interface de reconfiguração dinâmica.
void	registerCertificate(String entityID, byte[] certificate) Registra um certificado no barramento.
void	reloadConfigsFile() Recarrega o arquivo de configurações no barramento.
void	removeCategory(String categoryID) Remove uma categoria do barramento.
void	removeCertificate(String entityID) Remove o certificado vinculado a uma entidade do barramento.
boolean	removeEntity(String entityID) Remove o registro de uma entidade do barramento.
void	removeInterface(String interfaceName) Remove uma interface do barramento.
void	removeOffer(tecgraf.openbus.core.v2_0.services.offer_registry.ServiceOfferDesc desc) Remove uma oferta de serviço.
void	revokeAdminFrom(List<String> users) Revoga direitos de administração de uma lista de entidades.
void	revokeAuthorization(String entityID, String interfaceName) Remove autorização para uma interface de uma entidade.
boolean	setAuthorization(String entityID, String interfaceName) Concede autorização para uma interface a uma entidade.
void	setLogLevel(short loglevel) Configura a propriedade loglevel do barramento.
void	setMaxChannels(int maxchannels) Configura a propriedade maxchannels do barramento.
void	setOilLogLevel(short oilLoglevel) Configura a propriedade oilloglevel do barramento.

Methods inherited from class java.lang.Object

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

Constructor Detail

BusAdminImpl

public BusAdminImpl()

Construtor da classe.

Method Detail

connect

public void connect(String host,
                    int port,
                    ORB orb)

Conecta a inst�ncia do objeto a um barramento. Como efeito colateral, atualiza as refer�ncias aos registros do barramento.

Parameters:

host - Host do barramento

port - Porta do barramento

orb - ORB do barramento

getCategories

public List<tecgraf.openbus.core.v2_0.services.offer_registry.admin.v1_0.EntityCategoryDesc> getCategories()
                                                                                                    throws tecgraf.openbus.core.v2_0.services.ServiceFailure

Retorna uma lista que contém descrições de todas as categorias das entidades do barramento.

Specified by:

getCategories in interface BusAdmin

Returns:

Lista com as descrições das categorias das entidades.

Throws:

tecgraf.openbus.core.v2_0.services.ServiceFailure

createCategory

public tecgraf.openbus.core.v2_0.services.offer_registry.admin.v1_0.EntityCategory createCategory(String categoryID,
                                                                                                  String categoryName)
                                                                                           throws tecgraf.openbus.core.v2_0.services.ServiceFailure,
                                                                                                  tecgraf.openbus.core.v2_0.services.UnauthorizedOperation,
                                                                                                  tecgraf.openbus.core.v2_0.services.offer_registry.admin.v1_0.EntityCategoryAlreadyExists

Cadastra uma nova categoria no barramento.

Specified by:

createCategory in interface BusAdmin

Parameters:

categoryID - ID da nova categoria.

categoryName - Nome da nova categoria.

Returns:

Categoria cadastrada.

Throws:

tecgraf.openbus.core.v2_0.services.ServiceFailure

tecgraf.openbus.core.v2_0.services.UnauthorizedOperation

tecgraf.openbus.core.v2_0.services.offer_registry.admin.v1_0.EntityCategoryAlreadyExists

removeCategory

public void removeCategory(String categoryID)
                    throws tecgraf.openbus.core.v2_0.services.ServiceFailure,
                           tecgraf.openbus.core.v2_0.services.UnauthorizedOperation,
                           tecgraf.openbus.core.v2_0.services.offer_registry.admin.v1_0.EntityCategoryInUse

Remove uma categoria do barramento.

Specified by:

removeCategory in interface BusAdmin

Parameters:

categoryID - ID da categoria a ser removida.

Throws:

tecgraf.openbus.core.v2_0.services.ServiceFailure

tecgraf.openbus.core.v2_0.services.UnauthorizedOperation

tecgraf.openbus.core.v2_0.services.offer_registry.admin.v1_0.EntityCategoryInUse

getEntities

public List<tecgraf.openbus.core.v2_0.services.offer_registry.admin.v1_0.RegisteredEntityDesc> getEntities()
                                                                                                    throws tecgraf.openbus.core.v2_0.services.ServiceFailure

Retorna uma lista que contém descrições de todas as entidades registradas no barramento.

Specified by:

getEntities in interface BusAdmin

Returns:

Lista com as descrições de todas as entidades.

Throws:

tecgraf.openbus.core.v2_0.services.ServiceFailure

createEntity

public tecgraf.openbus.core.v2_0.services.offer_registry.admin.v1_0.RegisteredEntity createEntity(String entityID,
                                                                                                  String entityName,
                                                                                                  String categoryID)
                                                                                           throws tecgraf.openbus.core.v2_0.services.ServiceFailure,
                                                                                                  tecgraf.openbus.core.v2_0.services.UnauthorizedOperation,
                                                                                                  tecgraf.openbus.core.v2_0.services.offer_registry.admin.v1_0.EntityAlreadyRegistered

Cadastra uma nova entidade no barramento.

Specified by:

createEntity in interface BusAdmin

Parameters:

entityID - ID da nova entidade.

entityName - Nome da nova entidade.

categoryID - ID de alguma categoria já cadastrada.

Returns:

Entidade cadastrada.

Throws:

tecgraf.openbus.core.v2_0.services.ServiceFailure

tecgraf.openbus.core.v2_0.services.UnauthorizedOperation

tecgraf.openbus.core.v2_0.services.offer_registry.admin.v1_0.EntityAlreadyRegistered

removeEntity

public boolean removeEntity(String entityID)
                     throws tecgraf.openbus.core.v2_0.services.ServiceFailure,
                            tecgraf.openbus.core.v2_0.services.UnauthorizedOperation

Remove o registro de uma entidade do barramento.

Specified by:

removeEntity in interface BusAdmin

Parameters:

entityID - ID da entidade a ser removida.

Returns:

true caso a entidade foi removida, e false caso contrário.

Throws:

tecgraf.openbus.core.v2_0.services.ServiceFailure

tecgraf.openbus.core.v2_0.services.UnauthorizedOperation

getEntitiesWithCertificate

public List<String> getEntitiesWithCertificate()
                                        throws tecgraf.openbus.core.v2_0.services.ServiceFailure,
                                               tecgraf.openbus.core.v2_0.services.UnauthorizedOperation

Retorna uma lista que contém IDs de todas as etidades com certificado registrado no barramento.

Specified by:

getEntitiesWithCertificate in interface BusAdmin

Returns:

Lista com as IDs de todas as entidades com certificado registrado.

Throws:

tecgraf.openbus.core.v2_0.services.ServiceFailure

tecgraf.openbus.core.v2_0.services.UnauthorizedOperation

registerCertificate

public void registerCertificate(String entityID,
                                byte[] certificate)
                         throws tecgraf.openbus.core.v2_0.services.ServiceFailure,
                                tecgraf.openbus.core.v2_0.services.UnauthorizedOperation,
                                tecgraf.openbus.core.v2_0.services.access_control.admin.v1_0.InvalidCertificate

Registra um certificado no barramento.

Specified by:

registerCertificate in interface BusAdmin

Parameters:

entityID - ID da entidade.

certificate - Certificado.

Throws:

tecgraf.openbus.core.v2_0.services.ServiceFailure

tecgraf.openbus.core.v2_0.services.UnauthorizedOperation

tecgraf.openbus.core.v2_0.services.access_control.admin.v1_0.InvalidCertificate

removeCertificate

public void removeCertificate(String entityID)
                       throws tecgraf.openbus.core.v2_0.services.ServiceFailure,
                              tecgraf.openbus.core.v2_0.services.UnauthorizedOperation

Remove o certificado vinculado a uma entidade do barramento.

Specified by:

removeCertificate in interface BusAdmin

Parameters:

entityID - ID da entidade a ser removida.

Throws:

tecgraf.openbus.core.v2_0.services.ServiceFailure

tecgraf.openbus.core.v2_0.services.UnauthorizedOperation

getInterfaces

public List<String> getInterfaces()
                           throws tecgraf.openbus.core.v2_0.services.ServiceFailure

Retorna uma lista que contém as IDs de todas as interfaces registradas no barramento.

Specified by:

getInterfaces in interface BusAdmin

Returns:

Lista com as IDs de todas as interfaces registradas.

Throws:

tecgraf.openbus.core.v2_0.services.ServiceFailure

createInterface

public boolean createInterface(String interfaceName)
                        throws tecgraf.openbus.core.v2_0.services.ServiceFailure,
                               tecgraf.openbus.core.v2_0.services.UnauthorizedOperation,
                               tecgraf.openbus.core.v2_0.services.offer_registry.admin.v1_0.InvalidInterface

Cadastra uma nova interface no barramento.

Specified by:

createInterface in interface BusAdmin

Parameters:

interfaceName - Nome da nova interface.

Returns:

true se a interface cadastrada inexistia no barramento; false em caso contrário.

Throws:

tecgraf.openbus.core.v2_0.services.ServiceFailure

tecgraf.openbus.core.v2_0.services.UnauthorizedOperation

tecgraf.openbus.core.v2_0.services.offer_registry.admin.v1_0.InvalidInterface

removeInterface

public void removeInterface(String interfaceName)
                     throws tecgraf.openbus.core.v2_0.services.ServiceFailure,
                            tecgraf.openbus.core.v2_0.services.UnauthorizedOperation,
                            tecgraf.openbus.core.v2_0.services.offer_registry.admin.v1_0.InterfaceInUse

Remove uma interface do barramento.

Specified by:

removeInterface in interface BusAdmin

Parameters:

interfaceName - Nome da interface a ser removida.

Throws:

tecgraf.openbus.core.v2_0.services.ServiceFailure

tecgraf.openbus.core.v2_0.services.UnauthorizedOperation

tecgraf.openbus.core.v2_0.services.offer_registry.admin.v1_0.InterfaceInUse

getAuthorizations

public Map<tecgraf.openbus.core.v2_0.services.offer_registry.admin.v1_0.RegisteredEntityDesc,List<String>> getAuthorizations()
                                                                                                                      throws tecgraf.openbus.core.v2_0.services.ServiceFailure

Retorna um mapa que contém as descrições de todas as entidades registradas no barramento, associadas às suas respectivas autorizações.

Specified by:

getAuthorizations in interface BusAdmin

Returns:

mapa com par chave-valor: descrição da entidade registrada no barramento e lista de autorizações associadas a essa entidade, respectivamente.

Throws:

tecgraf.openbus.core.v2_0.services.ServiceFailure

setAuthorization

public boolean setAuthorization(String entityID,
                                String interfaceName)
                         throws tecgraf.openbus.core.v2_0.services.ServiceFailure,
                                tecgraf.openbus.core.v2_0.services.UnauthorizedOperation,
                                tecgraf.openbus.core.v2_0.services.offer_registry.admin.v1_0.InvalidInterface

Concede autorização para uma interface a uma entidade.

Specified by:

setAuthorization in interface BusAdmin

Parameters:

entityID - ID da entidade a receber autorização.

interfaceName - Interface a ser autorizada.

Returns:

true se a autorização cadastrada inexistia no barramento; false em caso contrário.

Throws:

tecgraf.openbus.core.v2_0.services.ServiceFailure

tecgraf.openbus.core.v2_0.services.UnauthorizedOperation

tecgraf.openbus.core.v2_0.services.offer_registry.admin.v1_0.InvalidInterface

revokeAuthorization

public void revokeAuthorization(String entityID,
                                String interfaceName)
                         throws tecgraf.openbus.core.v2_0.services.ServiceFailure,
                                tecgraf.openbus.core.v2_0.services.UnauthorizedOperation,
                                tecgraf.openbus.core.v2_0.services.offer_registry.admin.v1_0.InvalidInterface,
                                tecgraf.openbus.core.v2_0.services.offer_registry.admin.v1_0.AuthorizationInUse

Remove autorização para uma interface de uma entidade.

Specified by:

revokeAuthorization in interface BusAdmin

Parameters:

entityID - ID da entidade a ter autorização removida.

interfaceName - Interface a ser autorizada.

Throws:

tecgraf.openbus.core.v2_0.services.ServiceFailure

tecgraf.openbus.core.v2_0.services.UnauthorizedOperation

tecgraf.openbus.core.v2_0.services.offer_registry.admin.v1_0.InvalidInterface

tecgraf.openbus.core.v2_0.services.offer_registry.admin.v1_0.AuthorizationInUse

getOffers

public List<tecgraf.openbus.core.v2_0.services.offer_registry.ServiceOfferDesc> getOffers()
                                                                                   throws tecgraf.openbus.core.v2_0.services.ServiceFailure

Retorna uma lista que contém todas as descrições de ofertas de serviços do barramento.

Specified by:

getOffers in interface BusAdmin

Returns:

Lista de descrições de ofertas de serviços.

Throws:

tecgraf.openbus.core.v2_0.services.ServiceFailure

removeOffer

public void removeOffer(tecgraf.openbus.core.v2_0.services.offer_registry.ServiceOfferDesc desc)
                 throws tecgraf.openbus.core.v2_0.services.ServiceFailure,
                        tecgraf.openbus.core.v2_0.services.UnauthorizedOperation

Remove uma oferta de serviço.

Specified by:

removeOffer in interface BusAdmin

Parameters:

desc - Descrição da oferta.

Throws:

tecgraf.openbus.core.v2_0.services.ServiceFailure

tecgraf.openbus.core.v2_0.services.UnauthorizedOperation

getLogins

public List<tecgraf.openbus.core.v2_0.services.access_control.LoginInfo> getLogins()
                                                                            throws tecgraf.openbus.core.v2_0.services.ServiceFailure,
                                                                                   tecgraf.openbus.core.v2_0.services.UnauthorizedOperation

Retorna lista que contém as informações de todos os logins ativos no barramento.

Specified by:

getLogins in interface BusAdmin

Returns:

Lista contendo informações de login das entidades.

Throws:

tecgraf.openbus.core.v2_0.services.ServiceFailure

tecgraf.openbus.core.v2_0.services.UnauthorizedOperation

invalidateLogin

public void invalidateLogin(tecgraf.openbus.core.v2_0.services.access_control.LoginInfo loginInfo)
                     throws tecgraf.openbus.core.v2_0.services.ServiceFailure,
                            tecgraf.openbus.core.v2_0.services.UnauthorizedOperation

Invalida um login ativo no barramento.

Specified by:

invalidateLogin in interface BusAdmin

Parameters:

loginInfo - Informação de login.

Throws:

tecgraf.openbus.core.v2_0.services.ServiceFailure

tecgraf.openbus.core.v2_0.services.UnauthorizedOperation

isReconfigurationCapable

public boolean isReconfigurationCapable()

Indica se o barramento disponibiliza a interface de reconfiguração dinâmica.

Specified by:

isReconfigurationCapable in interface BusAdmin

Returns:

true caso o barramento forneça a interface de reconfiguração dinâmica e false caso contrário.

reloadConfigsFile

public void reloadConfigsFile()
                       throws tecgraf.openbus.core.v2_0.services.ServiceFailure,
                              tecgraf.openbus.core.v2_0.services.UnauthorizedOperation

Description copied from interface: BusAdmin

Recarrega o arquivo de configurações no barramento.

Specified by:

reloadConfigsFile in interface BusAdmin

Throws:

tecgraf.openbus.core.v2_0.services.ServiceFailure

tecgraf.openbus.core.v2_0.services.UnauthorizedOperation

grantAdminTo

public void grantAdminTo(List<String> users)
                  throws tecgraf.openbus.core.v2_0.services.ServiceFailure,
                         tecgraf.openbus.core.v2_0.services.UnauthorizedOperation

Description copied from interface: BusAdmin

Confere direitos de administração a uma lista de entidades.

Specified by:

grantAdminTo in interface BusAdmin

Parameters:

users - Lista de entidades que receberá direitos de administração.

Throws:

tecgraf.openbus.core.v2_0.services.ServiceFailure

tecgraf.openbus.core.v2_0.services.UnauthorizedOperation

revokeAdminFrom

public void revokeAdminFrom(List<String> users)
                     throws tecgraf.openbus.core.v2_0.services.ServiceFailure,
                            tecgraf.openbus.core.v2_0.services.UnauthorizedOperation

Description copied from interface: BusAdmin

Revoga direitos de administração de uma lista de entidades.

Specified by:

revokeAdminFrom in interface BusAdmin

Parameters:

users - Lista de entidades que perderá direitos de administração.

Throws:

tecgraf.openbus.core.v2_0.services.ServiceFailure

tecgraf.openbus.core.v2_0.services.UnauthorizedOperation

getAdmins

public List<String> getAdmins()
                       throws tecgraf.openbus.core.v2_0.services.ServiceFailure

Description copied from interface: BusAdmin

Retorna uma lista das entidades administradoras atuais.

Specified by:

getAdmins in interface BusAdmin

Returns:

Lista contendo os nomes das entidades administradoras.

Throws:

tecgraf.openbus.core.v2_0.services.ServiceFailure

addValidator

public void addValidator(String validator)
                  throws tecgraf.openbus.core.v2_0.services.ServiceFailure,
                         tecgraf.openbus.core.v2_0.services.UnauthorizedOperation

Description copied from interface: BusAdmin

Adiciona um validador no barramento.

Specified by:

addValidator in interface BusAdmin

Parameters:

validator - Identificação do validador.

Throws:

tecgraf.openbus.core.v2_0.services.ServiceFailure

tecgraf.openbus.core.v2_0.services.UnauthorizedOperation

delValidator

public void delValidator(String validator)
                  throws tecgraf.openbus.core.v2_0.services.ServiceFailure,
                         tecgraf.openbus.core.v2_0.services.UnauthorizedOperation

Description copied from interface: BusAdmin

Remove um validador do barramento.

Specified by:

delValidator in interface BusAdmin

Parameters:

validator - Identificação do validador.

Throws:

tecgraf.openbus.core.v2_0.services.ServiceFailure

tecgraf.openbus.core.v2_0.services.UnauthorizedOperation

getValidators

public List<String> getValidators()
                           throws tecgraf.openbus.core.v2_0.services.ServiceFailure

Description copied from interface: BusAdmin

Retorna uma lista dos validadores atualmente disponíveis no barramento.

Specified by:

getValidators in interface BusAdmin

Returns:

Lista contendo as identificações dos validadores.

Throws:

tecgraf.openbus.core.v2_0.services.ServiceFailure

setMaxChannels

public void setMaxChannels(int maxchannels)
                    throws tecgraf.openbus.core.v2_0.services.ServiceFailure,
                           tecgraf.openbus.core.v2_0.services.UnauthorizedOperation

Description copied from interface: BusAdmin

Configura a propriedade maxchannels do barramento.

Specified by:

setMaxChannels in interface BusAdmin

Parameters:

maxchannels - Número máximo de canais a serem utilizados.

Throws:

tecgraf.openbus.core.v2_0.services.ServiceFailure

tecgraf.openbus.core.v2_0.services.UnauthorizedOperation

getMaxChannels

public int getMaxChannels()
                   throws tecgraf.openbus.core.v2_0.services.ServiceFailure

Description copied from interface: BusAdmin

Retorna o valor atual da propriedade maxchannels do barramento.

Specified by:

getMaxChannels in interface BusAdmin

Returns:

Número máximo de canais configurado atualmente.

Throws:

tecgraf.openbus.core.v2_0.services.ServiceFailure

setLogLevel

public void setLogLevel(short loglevel)
                 throws tecgraf.openbus.core.v2_0.services.ServiceFailure,
                        tecgraf.openbus.core.v2_0.services.UnauthorizedOperation

Description copied from interface: BusAdmin

Configura a propriedade loglevel do barramento.

Specified by:

setLogLevel in interface BusAdmin

Parameters:

loglevel - Nível de log do barramento.

Throws:

tecgraf.openbus.core.v2_0.services.ServiceFailure

tecgraf.openbus.core.v2_0.services.UnauthorizedOperation

getLogLevel

public short getLogLevel()
                  throws tecgraf.openbus.core.v2_0.services.ServiceFailure

Description copied from interface: BusAdmin

Retorna o valor atual da propriedade loglevel do barramento.

Specified by:

getLogLevel in interface BusAdmin

Returns:

Nível de log do barramento configurado atualmente.

Throws:

tecgraf.openbus.core.v2_0.services.ServiceFailure

setOilLogLevel

public void setOilLogLevel(short oilLoglevel)
                    throws tecgraf.openbus.core.v2_0.services.ServiceFailure,
                           tecgraf.openbus.core.v2_0.services.UnauthorizedOperation

Description copied from interface: BusAdmin

Configura a propriedade oilloglevel do barramento.

Specified by:

setOilLogLevel in interface BusAdmin

Parameters:

oilLoglevel - Nível de log do middleware OiL no barramento.

Throws:

tecgraf.openbus.core.v2_0.services.ServiceFailure

tecgraf.openbus.core.v2_0.services.UnauthorizedOperation

getOilLogLevel

public short getOilLogLevel()
                     throws tecgraf.openbus.core.v2_0.services.ServiceFailure

Description copied from interface: BusAdmin

Retorna o valor atual da propriedade oilloglevel do barramento.

Specified by:

getOilLogLevel in interface BusAdmin

Returns:

Nível de log do middleware OiL configurado atualmente.

Throws:

tecgraf.openbus.core.v2_0.services.ServiceFailure