tecgraf.openbus.services.collaboration.easy

Interface IEasyCollaboration

All Known Implementing Classes:

EasyCollaboration

public interface IEasyCollaboration

Interface para biblioteca de apoio ao serviço de colaboração. O objetivo dessa interface é fornecer alguns métodos a serem utilizados nas atividades mais corriqueiras relacionadas ao uso de sessões de colaboração.

Author:

Tecgraf/PUC-Rio

Method Summary

Modifier and Type	Method and Description
List<Any>	consumeAnys() Consome os objetos, encapsulados com o tipo variável Any de CORBA, do canal de eventos.
List<byte[]>	consumeDataKeys() Consome os datakeys no canal de eventos.
void	exitCollaboration() Encerra a sessão de colaboração.
void	shareAny(Any any) Compartilha um objeto, desde que encapsulado com o tipo variável Any de CORBA, no canal de eventos.
void	shareDataKey(byte[] key) Compartilha um datakey no canal de eventos.
void	shareDataKeys(List<byte[]> keys) Compartilha uma lista de datakeys no canal de eventos.
CollaborationSession	startCollaboration() Inicia uma sessão de colaboração.

Method Detail

startCollaboration

CollaborationSession startCollaboration()
                                 throws ServiceFailure

Inicia uma sessão de colaboração. Esse método deve ser responsável por buscar o serviço de colaboração, criar uma sessão e registrá-la no registro de sessões. Além disso, um consumidor deve ser cadastrado no canal de eventos da sessão para a troca de informações.

Returns:

sessão de colaboração

Throws:

ServiceFailure

exitCollaboration

void exitCollaboration()
                throws ServiceFailure

Encerra a sessão de colaboração. Também remove observadores e consumidores do canal de eventos.

Throws:

ServiceFailure

shareDataKey

void shareDataKey(byte[] key)
           throws ServiceFailure

Compartilha um datakey no canal de eventos.

Parameters:

key - datakey

Throws:

ServiceFailure

shareDataKeys

void shareDataKeys(List<byte[]> keys)
            throws ServiceFailure

Compartilha uma lista de datakeys no canal de eventos.

Parameters:

keys - lista de datakeys

Throws:

ServiceFailure

shareAny

void shareAny(Any any)
       throws ServiceFailure

Compartilha um objeto, desde que encapsulado com o tipo variável Any de CORBA, no canal de eventos. Para encapsular o objeto em um Any é preciso que o tipo esteja declarado em IDL e que se use os métodos insert da respectiva classe com sufixo Helper para inserir o objeto em um Any.

Parameters:

any - instância do Any

Throws:

ServiceFailure

consumeDataKeys

List<byte[]> consumeDataKeys()

Consome os datakeys no canal de eventos.

Returns:

lista de array de bytes

consumeAnys

List<Any> consumeAnys()

Consome os objetos, encapsulados com o tipo variável Any de CORBA, do canal de eventos. Para obter o objeto a partir de um Any é preciso que seu tipo esteja declarado em IDL e que se use os métodos extract da respectiva classe com sufixo Helper para extraí-lo de um Any.

Returns:

lista de instâncias de Any