com.pcbsys.nirvana.client.nDataGroup Class Reference

This class represents a individual data group object. More...

Inheritance diagram for com.pcbsys.nirvana.client.nDataGroup:
com.pcbsys.nirvana.client.nDataStream

Public Member Functions

virtual void add (nDataStream stream)
 Add a new stream to this data group More...
 
void add (IEnumerable< nDataStream > streams)
 Adds the specified streams to this group More...
 
virtual void add (nDataGroup group)
 Adds an existing data group to this data group, allowing groups to be cascaded More...
 
virtual void addListener (nDataGroupListener listener)
 Add a new listener to this group so that when Streams or Groups are added or deleted the listener is notified More...
 
virtual void addPublisher (string subject)
 Allow the specified subject to be allowed to publish to this group More...
 
virtual void addSnoop (nDataStream stream)
 Add a new snoop stream to this data group. More...
 
virtual bool contains (nDataStream stream)
 Checks if the stream exists in this group More...
 
virtual bool contains (string streamId)
 Checks if the stream id exists in this group More...
 
virtual bool containsSnoop (nDataStream stream)
 Checks if the snoop stream exists in this group More...
 
virtual bool containsSnoop (string streamId)
 Checks if the snoop stream id exists in this group More...
 
nRegisteredEvent createRegisteredEvent ()
 Registers a new nRegisteredEvent with the data stream allowing just the updates to be sent through to the clients More...
 
nConflationAttributes getConflationAttributes ()
 Get the conflation attributes for this data group if they exist More...
 
virtual nDataGroup getGroup (string groupName)
 Returns the DataGroup specified, if it is contained within this group. More...
 
int getGroupCount ()
 Returns the number of DataGroups (if any) contained within this group. More...
 
virtual IEnumerable< nDataGroupgetGroups ()
 Obtain a list of the nDataGroup objects contained within this group More...
 
nDataGroup[] getGroupsContaining ()
 Locate the groups that currently contain this group More...
 
virtual long getID ()
 Return the id of this nDataGroup object More...
 
virtual nDataGroupListener getListener ()
 returns the current listener for the datagroup More...
 
int getPriority ()
 Returns the level of priority associated with this data group More...
 
virtual IEnumerable< string > getPublishers ()
 Obtain a list of publisher ids More...
 
nSession getSession ()
 Returns the session associated with this data group instance More...
 
virtual nDataStream getSnoopStream (string streamId)
 Get the nDataStream snoop object corresponding to the name More...
 
virtual nDataStream getStream (string streamId)
 Get the nDataStream object corresponding to the name More...
 
virtual IEnumerable< nDataStreamgetStreams ()
 Obtain the list of nDataStream objects contained within this group More...
 
bool isClosed ()
 Returns true if this group has been deleted More...
 
bool isMulticastEnabled ()
 Flag to indicate whether this Data Group is multicast enabled More...
 
bool isNested ()
 Flag indicating whether this group is nested within one of more other groups More...
 
bool isReadOnly ()
 Flag to indicate whether this group is read only. More...
 
virtual void remove (nDataStream stream)
 Remove the stream from this data group More...
 
virtual void remove (nDataGroup group)
 Remove the specified data group from this one More...
 
virtual void removePublisher (string subject)
 Remove the specified subject from the list of authorised publishers for this group More...
 
virtual void removeSnoop (nDataStream stream)
 Remove the snoop stream from this data group More...
 
virtual void setReadOnly ()
 Mark the nDataGroup as read only More...
 
virtual int size ()
 Get the current count of streams contained in this nDataGroup More...
 

Properties

virtual string Name [get]
 
Returns
the name of this Data Group

 
- Properties inherited from com.pcbsys.nirvana.client.nDataStream
virtual string Name [get]
 The stream name More...
 
virtual string Subject [get]
 The stream subject More...
 

Detailed Description

This class represents a individual data group object.

Since
6.0

Member Function Documentation

virtual void com.pcbsys.nirvana.client.nDataGroup.add ( nDataStream  stream)
virtual

Add a new stream to this data group

Parameters
stream- the stream to add
Exceptions
nSecurityException
nRequestTimedOutException
nSessionPausedException
nSessionNotConnectedException
void com.pcbsys.nirvana.client.nDataGroup.add ( IEnumerable< nDataStream streams)

Adds the specified streams to this group

Parameters
streamsan IEnumerable of nDataStreams to be added to this group
Exceptions
nSecurityException
nRequestTimedOutException
nSessionPausedException
nSessionNotConnectedException
virtual void com.pcbsys.nirvana.client.nDataGroup.add ( nDataGroup  group)
virtual

Adds an existing data group to this data group, allowing groups to be cascaded

Parameters
group- group to be added
Exceptions
nSecurityException
nRequestTimedOutException
nSessionPausedException
nSessionNotConnectedException
virtual void com.pcbsys.nirvana.client.nDataGroup.addListener ( nDataGroupListener  listener)
virtual

Add a new listener to this group so that when Streams or Groups are added or deleted the listener is notified

Parameters
listenerthe listener to receive callbacks on this data group
Exceptions
nDataGroupDeletedException
virtual void com.pcbsys.nirvana.client.nDataGroup.addPublisher ( string  subject)
virtual

Allow the specified subject to be allowed to publish to this group

Parameters
subjectthe subject to give permissions to
Exceptions
nDataGroupIsReadOnlyException
nDataGroupDeletedException
nIllegalArgumentException
virtual void com.pcbsys.nirvana.client.nDataGroup.addSnoop ( nDataStream  stream)
virtual

Add a new snoop stream to this data group.

This stream will be hidden from the group, with no callbacks fired for it

Parameters
stream- the stream to add
Exceptions
nSecurityException
nRequestTimedOutException
nSessionPausedException
nSessionNotConnectedException
virtual bool com.pcbsys.nirvana.client.nDataGroup.contains ( nDataStream  stream)
virtual

Checks if the stream exists in this group

Parameters
streamthe stream or group to test for
Returns
true if this group contains the id of the specified stream.
virtual bool com.pcbsys.nirvana.client.nDataGroup.contains ( string  streamId)
virtual

Checks if the stream id exists in this group

Parameters
streamIdname of the stream or group to test for
Returns
true if this group contains the specified stream id
Exceptions
nDataGroupDeletedException
virtual bool com.pcbsys.nirvana.client.nDataGroup.containsSnoop ( nDataStream  stream)
virtual

Checks if the snoop stream exists in this group

Parameters
streamthe stream or group to test for
Returns
true if this group contains the id of the specified stream.
virtual bool com.pcbsys.nirvana.client.nDataGroup.containsSnoop ( string  streamId)
virtual

Checks if the snoop stream id exists in this group

Parameters
streamIdname of the stream or group to test for
Returns
true if this group contains the specified stream id
Exceptions
nDataGroupDeletedException
nRegisteredEvent com.pcbsys.nirvana.client.nDataGroup.createRegisteredEvent ( )

Registers a new nRegisteredEvent with the data stream allowing just the updates to be sent through to the clients

Exceptions
nDataGroupDeletedException
nConflationAttributes com.pcbsys.nirvana.client.nDataGroup.getConflationAttributes ( )

Get the conflation attributes for this data group if they exist

Returns
the conflation attributes if they exist
virtual nDataGroup com.pcbsys.nirvana.client.nDataGroup.getGroup ( string  groupName)
virtual

Returns the DataGroup specified, if it is contained within this group.

Parameters
groupNamethe group to find
Returns
the nDataGroup matching the groupName
Exceptions
nDataGroupDeletedException
int com.pcbsys.nirvana.client.nDataGroup.getGroupCount ( )

Returns the number of DataGroups (if any) contained within this group.

Exceptions
nDataGroupDeletedException
virtual IEnumerable<nDataGroup> com.pcbsys.nirvana.client.nDataGroup.getGroups ( )
virtual

Obtain a list of the nDataGroup objects contained within this group

Returns
an IEnumerable of known groups
Exceptions
nDataGroupDeletedException
nDataGroup [] com.pcbsys.nirvana.client.nDataGroup.getGroupsContaining ( )

Locate the groups that currently contain this group

Returns
an array of nDataGroup objects containing the group
Exceptions
nDataGroupDeletedException
virtual long com.pcbsys.nirvana.client.nDataGroup.getID ( )
virtual

Return the id of this nDataGroup object

Returns
the unique long value representing this nDataGroup
virtual nDataGroupListener com.pcbsys.nirvana.client.nDataGroup.getListener ( )
virtual

returns the current listener for the datagroup

Returns
this data group's listener
int com.pcbsys.nirvana.client.nDataGroup.getPriority ( )

Returns the level of priority associated with this data group

Returns
a value between 0 and 9 indicating priority
virtual IEnumerable<string> com.pcbsys.nirvana.client.nDataGroup.getPublishers ( )
virtual

Obtain a list of publisher ids

Returns
an IEnumerable of currently allowed publishers
nSession com.pcbsys.nirvana.client.nDataGroup.getSession ( )

Returns the session associated with this data group instance

virtual nDataStream com.pcbsys.nirvana.client.nDataGroup.getSnoopStream ( string  streamId)
virtual

Get the nDataStream snoop object corresponding to the name

Parameters
streamIdname of the stream
Returns
the nDataStream object matching the name
Exceptions
nDataGroupDeletedException
virtual nDataStream com.pcbsys.nirvana.client.nDataGroup.getStream ( string  streamId)
virtual

Get the nDataStream object corresponding to the name

Parameters
streamIdname of the stream
Returns
the nDataStream object matching the name
Exceptions
nDataGroupDeletedException
virtual IEnumerable<nDataStream> com.pcbsys.nirvana.client.nDataGroup.getStreams ( )
virtual

Obtain the list of nDataStream objects contained within this group

Returns
an IEnumerable of known streams
Exceptions
nDataGroupDeletedException
bool com.pcbsys.nirvana.client.nDataGroup.isClosed ( )

Returns true if this group has been deleted

Returns
true if deleted
bool com.pcbsys.nirvana.client.nDataGroup.isMulticastEnabled ( )

Flag to indicate whether this Data Group is multicast enabled

Returns
true if enabled, false otherwise
bool com.pcbsys.nirvana.client.nDataGroup.isNested ( )

Flag indicating whether this group is nested within one of more other groups

Returns
true if nested else false
bool com.pcbsys.nirvana.client.nDataGroup.isReadOnly ( )

Flag to indicate whether this group is read only.

If it is, it will be the default Data Group object

Returns
true is default Data Group
virtual void com.pcbsys.nirvana.client.nDataGroup.remove ( nDataStream  stream)
virtual

Remove the stream from this data group

Parameters
streamthe stream to be removed
Exceptions
nSecurityException
nRequestTimedOutException
nSessionPausedException
nSessionNotConnectedException
virtual void com.pcbsys.nirvana.client.nDataGroup.remove ( nDataGroup  group)
virtual

Remove the specified data group from this one

Parameters
group
Exceptions
nSecurityException
nRequestTimedOutException
nSessionPausedException
nSessionNotConnectedException
virtual void com.pcbsys.nirvana.client.nDataGroup.removePublisher ( string  subject)
virtual

Remove the specified subject from the list of authorised publishers for this group

Parameters
subjectthe subject to remove permissions from
Exceptions
nDataGroupIsReadOnlyException
nDataGroupDeletedException
nIllegalArgumentException
virtual void com.pcbsys.nirvana.client.nDataGroup.removeSnoop ( nDataStream  stream)
virtual

Remove the snoop stream from this data group

Parameters
streamthe stream to be removed
Exceptions
nSecurityException
nRequestTimedOutException
nSessionPausedException
nSessionNotConnectedException
virtual void com.pcbsys.nirvana.client.nDataGroup.setReadOnly ( )
virtual

Mark the nDataGroup as read only

virtual int com.pcbsys.nirvana.client.nDataGroup.size ( )
virtual

Get the current count of streams contained in this nDataGroup

Returns
the number of streams in this group