com.anabas.sharedlet
Interface CommunicationService


public interface CommunicationService
extends SharedletService

Provides distributed communication services via an event bus mechanism. This is the core service provided to sharedlets by the framework. Location In GXO

A sharedlet can find the CommunicationService under:

/services/CommunicationServce


Method Summary
 GMS_Stream createStream(java.lang.String name)
          Creates a stream to be used.
 GMS_Stream findStream(java.lang.String name)
          Find a stream by its name under the current meeting context.
 java.lang.String getConnectionID()
           
 GMS_StreamFactory getStreamFactory()
           
 
Methods inherited from interface com.anabas.sharedlet.SharedletService
init, resume, shutdown, suspend
 

Method Detail

getConnectionID

public java.lang.String getConnectionID()
Returns:
A unique connection ID for this communication service. Can be used to uniquely distringuish between instances of communication clients.

getStreamFactory

public GMS_StreamFactory getStreamFactory()
Returns:
The factory by which new streams are created.
See Also:
GMS_StreamFactory

createStream

public GMS_Stream createStream(java.lang.String name)
                        throws GXO_AccessDeniedException,
                               NamingException
Creates a stream to be used. A handle to the new streams will be bound under the meeting context's /streams// in the GXO directory.
Parameters:
name - The name of the stream to create.
Returns:
The created stream.
Throws:
GXO_AccessDeniedException - No permission to create the stream.
NamingException - The name of the stream does not conform to the GXO naming convention (JNDI DirContext convention).
See Also:
GMS_Stream, GXO_AccessDeniedException, NamingException

findStream

public GMS_Stream findStream(java.lang.String name)
                      throws NamingException
Find a stream by its name under the current meeting context.
Returns:
null The stream that matches the name parameter. null if not found.
See Also:
NamingException