csbase.server.services.openbusservice

Class OpenBusService

java.lang.Object

csbase.remote.RemoteObjectObservable

csbase.server.ServerRemoteObjectObservable

csbase.server.Service

csbase.server.services.openbusservice.OpenBusService

All Implemented Interfaces:

csbase.remote.OpenBusServiceInterface, csbase.remote.RemoteObservable, csbase.remote.RemoteObserverNotifierInterface, csbase.remote.ServiceInterface, Remote

public final class OpenBusService
extends Service
implements csbase.remote.OpenBusServiceInterface

Representa o serviço que trata da conexão do CSBase com o OpenBus.

Author:

Tecgraf/PUC-Rio

Field Summary

Fields inherited from class csbase.remote.RemoteObjectObservable

observerManager

Fields inherited from interface csbase.remote.OpenBusServiceInterface

SERVICE_NAME

Method Summary

Modifier and Type	Method and Description
void	addFacet(String name, String interfaceName, Servant servant) Adiciona uma faceta que será ofertada no OpenBus.
static void	createService() Cria a instância única do serviço.
csbase.logic.openbus.OpenBusLoginToken	doTokenLogin(csbase.logic.openbus.OpenBusLoginToken token) Autentica uma conexão usando um token e retorna um novo token para ser utilizado pelo cliente.
void	exitChain() Sai da cadeia de chamadas.
scs.core.IComponent	findService(Properties properties) Procura no barramento um serviço com as propriedades especificadas.
scs.core.IComponent	findServiceById(String id)
scs.core.IComponent[]	findServiceList(Properties properties) Procura no barramento todos serviços com as propriedades especificadas.
void	finishCSBaseAccess() Finaliza o acesso do usuário do serviço CSBase na sessão em que foi feita uma requisição através do OpenBus.
csbase.logic.BusInfo	getBusInfo()
scs.core.ComponentContext	getComponentContext(String facetId) Obtém o contexto do componente que publicou uma determinada faceta.
String	getEntityName() Obtém o nome de entidade cadastrado no OpenBus.
Set<scs.core.ComponentId>	getFailedComponents() Obtém um conjunto com os componentes com falha no registro.
static OpenBusService	getInstance() Obtém a instância única do serviço.
OpenbusStatus	getOpenbusStatus() Obtém o estado da conexão com o barramento Openbus.
ORB	getORB() Obtém o ORB utilizado pelo serviço.
String	getPrivateKeyFilePath() Obtém o caminho do arquivo da chave privada para acesso ao barramento Openbus.
String	getRegisteredComponentBusId(scs.core.ComponentId id) Obtém o identificador da publicação do componente no barramento.
String[]	getRegisteredComponentFacets(scs.core.ComponentId id) Obtém as facetas de um componente registrado como oferta de serviço pelo CSBase.
Properties	getRegisteredComponentProperties(scs.core.ComponentId id) Obtém as propriedades de um componente registrado como oferta de serviço pelo CSBase.
Set<scs.core.ComponentId>	getRegisteredComponents()
String	getRequesterSystemId() Obtém o identificador do sistema em que o usuário está executando uma requisição através do OpenBus.
String	getRequesterUserId() Obtém o identificador do usuário que está executando uma requisição através do OpenBus.
POA	getRootPOA() Obtém o POA raiz.
protected boolean	has2Update(Object arg, Object event)
String	initCSBaseAccess() Inicia o usuário do serviço CSBase e também o sistema onde esse usuário está executando uma requisição através do OpenBus.
void	initService() Método abstrato de inicialização do serviço.
boolean	isActive() Verifica se o serviço está ativo.
boolean	isConnected()
boolean	isRegistryServerActive()
void	joinChain() Une-se à cadeia de chamadas.
void	joinChain(byte[] chain) Une-se à cadeia de chamadas.
void	shutdownService() Método abstrato de término do serviço

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, isEnabled, isInternalServerRequest, isLoggingNotifications, isPropertyNull, logNotification, setEnabled, setKey, setSystemId, setUserId, setUserLocale

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

Method Detail

getORB

public ORB getORB()

Obtém o ORB utilizado pelo serviço.

Returns:

o ORB

getRootPOA

public POA getRootPOA()
               throws csbase.exception.OperationFailureException

Obtém o POA raiz.

Returns:

o POA raiz

Throws:

csbase.exception.OperationFailureException - caso ocorra algum erro na obtenção do POA

joinChain

public void joinChain()

Une-se à cadeia de chamadas.

joinChain

public void joinChain(byte[] chain)
               throws csbase.exception.OperationFailureException

Une-se à cadeia de chamadas.

Parameters:

chain - a representação de cadeia de chamandas em array de bytes

Throws:

csbase.exception.OperationFailureException - caso ocorra algum erro na união à cadeia de chamadas.

exitChain

public void exitChain()

Sai da cadeia de chamadas.

getInstance

public static OpenBusService getInstance()

Obtém a instância única do serviço.

Returns:

A instância única do serviço.

createService

public static void createService()
                          throws ServerException

Cria a instância única do serviço.

Throws:

ServerException - Se houver erro na inicialização.

initService

public void initService()

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

Specified by:

initService in class Service

findService

public scs.core.IComponent findService(Properties properties)
                                throws csbase.exception.OperationFailureException

Procura no barramento um serviço com as propriedades especificadas. Os serviços que estiverem indisponíveis serão desconsiderados.

Parameters:

properties - as propriedades usadas como critério de busca

Returns:

um serviço qualquer que atenda os critérios de busca ou nulo caso não exista um serviço com os critérios especificados

Throws:

csbase.exception.OperationFailureException - caso ocorra algum erro na busca do serviço

findServiceList

public scs.core.IComponent[] findServiceList(Properties properties)
                                      throws csbase.exception.OperationFailureException

Procura no barramento todos serviços com as propriedades especificadas. Os serviços que estiverem indisponíveis serão desconsiderados.

Parameters:

properties - as propriedades usadas como critérios de busca

Returns:

a lista de serviços que atendem os critérios de busca

Throws:

csbase.exception.OperationFailureException - caso ocorra algum erro na busca do serviço

findServiceById

public scs.core.IComponent findServiceById(String id)
                                    throws csbase.exception.OperationFailureException

Throws:

csbase.exception.OperationFailureException

getRequesterUserId

public String getRequesterUserId()

Obtém o identificador do usuário que está executando uma requisição através do OpenBus.

Returns:

O identificador do usuário ou null, caso não haja requisição em execução.

getRequesterSystemId

public String getRequesterSystemId()

Obtém o identificador do sistema em que o usuário está executando uma requisição através do OpenBus.

Returns:

o identificador do sistema ou null, caso não haja requisição em execução

initCSBaseAccess

public String initCSBaseAccess()

Inicia o usuário do serviço CSBase e também o sistema onde esse usuário está executando uma requisição através do OpenBus. Para isso, considera-se como base a credencial usada para acesso no OpenBus.

Returns:

retorna o identificador do usuário

finishCSBaseAccess

public void finishCSBaseAccess()

Finaliza o acesso do usuário do serviço CSBase na sessão em que foi feita uma requisição através do OpenBus. O sistema em que esse usuário estava executando a requisição também é finalizado na sessão.

shutdownService

public void shutdownService()

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

Specified by:

shutdownService in class Service

isActive

public boolean isActive()

Verifica se o serviço está ativo.

Specified by:

isActive in interface csbase.remote.ServiceInterface

Overrides:

isActive in class Service

Returns:

um flag booleano indicativo.

has2Update

protected boolean has2Update(Object arg,
                             Object event)

Specified by:

has2Update in class csbase.remote.RemoteObjectObservable

addFacet

public void addFacet(String name,
                     String interfaceName,
                     Servant servant)

Adiciona uma faceta que será ofertada no OpenBus.

Parameters:

name - da faceta

interfaceName - identificador da interface da faceta

servant - servant que implementa a interface da faceta

getBusInfo

public csbase.logic.BusInfo getBusInfo()

Specified by:

getBusInfo in interface csbase.remote.OpenBusServiceInterface

getOpenbusStatus

public OpenbusStatus getOpenbusStatus()

Obtém o estado da conexão com o barramento Openbus.

Returns:

estado da conexão

isConnected

public boolean isConnected()

isRegistryServerActive

public boolean isRegistryServerActive()

getEntityName

public String getEntityName()

Obtém o nome de entidade cadastrado no OpenBus.

Returns:

O nome de entidade.

getPrivateKeyFilePath

public String getPrivateKeyFilePath()

Obtém o caminho do arquivo da chave privada para acesso ao barramento Openbus.

Returns:

o caminho do arquivo da chave privada.

getRegisteredComponents

public Set<scs.core.ComponentId> getRegisteredComponents()

Specified by:

getRegisteredComponents in interface csbase.remote.OpenBusServiceInterface

getRegisteredComponentFacets

public String[] getRegisteredComponentFacets(scs.core.ComponentId id)

Obtém as facetas de um componente registrado como oferta de serviço pelo CSBase.

Parameters:

id - o identificador do componente publicado no barramento

Returns:

o array com as facetas (repId da IDL) ou null caso não exista um componente publicado com o identificador fornecido.

getRegisteredComponentProperties

public Properties getRegisteredComponentProperties(scs.core.ComponentId id)

Obtém as propriedades de um componente registrado como oferta de serviço pelo CSBase.

Parameters:

id - o identificador do componente publicado no barramento

Returns:

o array com as propriedades ou null caso não exista um componente publicado com o identificador fornecido.

getRegisteredComponentBusId

public String getRegisteredComponentBusId(scs.core.ComponentId id)

Obtém o identificador da publicação do componente no barramento.

Parameters:

id - o identificador do componente

Returns:

o identificador da publicação do componente no barramento

getFailedComponents

public Set<scs.core.ComponentId> getFailedComponents()

Obtém um conjunto com os componentes com falha no registro. Só pode ser executado pelo admin.

Specified by:

getFailedComponents in interface csbase.remote.OpenBusServiceInterface

Returns:

conjunto com os componentes com falha no registro

doTokenLogin

public csbase.logic.openbus.OpenBusLoginToken doTokenLogin(csbase.logic.openbus.OpenBusLoginToken token)

Autentica uma conexão usando um token e retorna um novo token para ser utilizado pelo cliente.

Parameters:

token - o token usado para autenticar uma conexão

Returns:

o token que será enviado para o cliente para autenticar sua conexão com o barramento.

getComponentContext

public scs.core.ComponentContext getComponentContext(String facetId)

Obtém o contexto do componente que publicou uma determinada faceta.

Parameters:

facetId - identificador da faceta

Returns:

o contexto do componente