com.pcbsys.nirvana.nAdminAPI.nServiceNode Class Reference

This class provides a mechanism to get information about P2P services on a particular realm. More...

Inheritance diagram for com.pcbsys.nirvana.nAdminAPI.nServiceNode:
com.pcbsys.nirvana.nAdminAPI.nNode com.pcbsys.nirvana.client.Observable

Public Member Functions

void addACLEntries (nACL entries)
 Adds a list of acl entries to the service nodes acl More...
 
void addACLEntry (nACLEntry entry)
 Adds an nACLEntry to this service nodes acl More...
 
virtual void addListener (nConnectionListener listener)
 Adds a listener to this service. More...
 
virtual void closed (nRealmNode node)
 Called when the nRealmNode is closed, for internal use only. More...
 
virtual void delListener ()
 Removes the registered listener for this service. More...
 
virtual nACL getACLs ()
 Returns a nACL object containing a list of nServiceACLEntry More...
 
virtual float getConnectionRate ()
 The number of subscriptions made to this store per second More...
 
virtual float getConsumedRate ()
 The number of events published per second More...
 
virtual int getCurrentNoOfConnections ()
 Returns the number of current connections this service is handling More...
 
virtual long getCurrentNumberOfEvents ()
 Returns the number of events within the channel/queue More...
 
virtual nServiceInfo getInformation ()
 Returns a nServiceInfo containing information about the service More...
 
virtual string getLocalName ()
 Returns the local name without folder information for this service. More...
 
virtual float getPublishRate ()
 The number of events published per second More...
 
virtual nRealmNode getRealm ()
 Returns the Realm Node this leaf node is associated with. More...
 
virtual long getTotalConsumed ()
 Returns the total number of events that this channel has delivered to subscribers More...
 
virtual long getTotalNoOfConnections ()
 Returns the total number of connections that this channel has had since the realm started More...
 
virtual long getTotalPublished ()
 Returns the total number of events published/pushed to this channel/queue since the realm has started More...
 
virtual long getUsedSpace ()
 Returns the number of bytes that this channel/queue consumes on the server More...
 
virtual bool isActive ()
 This function returns true if the nServerService is still active. More...
 
void modACLEntries (nACL entry)
 Modifies the acl entries for the service nodes ACL More...
 
void modACLEntry (nACLEntry entry)
 Modifies the acl entry for the service nodes ACL More...
 
void removeACLEntries (nACL entries)
 Removes the acl entries from the service nodes ACL More...
 
void removeACLEntry (nACLEntry entry)
 Removes the acl entry from the service nodes ACL More...
 
virtual void setACLs (nACL acl)
 Sets the acl on the service with the nACL list passed in More...
 
- Public Member Functions inherited from com.pcbsys.nirvana.nAdminAPI.nNode
bool Equals (long aLong)
 Needed as part of the SortedObject interface. More...
 
override bool Equals (object item)
 Compares this object with the passed object More...
 
virtual string getAbsolutePath ()
 This function walks the tree to the root to generate a fully qualified name for this node More...
 
virtual nNode getParent ()
 Returns this nodes parent node. More...
 
virtual string getRelativePath (nNode top)
 This method returns the relative path from this node to the nNode passed. More...
 
virtual bool lessThan (long aLong)
 Needed as part of the SortedObject interface. More...
 
virtual bool lessThan (object item)
 Compares this object with the passed object. More...
 
- Public Member Functions inherited from com.pcbsys.nirvana.client.Observable
void addObserver (IObserver o)
 Adds an observer to the set of observers for this object, provided that it is not the same as some observer already in the set. More...
 
int countObservers ()
 Returns the number of observers of this Observable object. More...
 
void deleteObserver (IObserver o)
 Deletes an observer from the set of observers of this object. More...
 
void deleteObservers ()
 Clears the observer list so that this object no longer has any observers. More...
 
bool hasChanged ()
 Tests if this object has changed. More...
 
void notifyObservers ()
 If this object has changed, as indicated by the hasChanged method, then notify all of its observers and then call the clearChanged method to indicate that this object has no longer changed. More...
 
void notifyObservers (Object arg)
 If this object has changed, as indicated by the More...
 
 Observable ()
 Construct an Observable with zero Observers. More...
 

Properties

override string Name [get]
 Returns the name of the service. More...
 
- Properties inherited from com.pcbsys.nirvana.nAdminAPI.nNode
virtual string Name [get]
 Returns the generic name of this node within the namespace More...
 

Additional Inherited Members

- Protected Member Functions inherited from com.pcbsys.nirvana.client.Observable
void clearChanged ()
 Indicates that this object has no longer changed, or that it has already notified all of its observers of its most recent change, so that the hasChanged method will now return false. More...
 
void setChanged ()
 Marks this Observable object as having been changed; the hasChanged method will now return true. More...
 

Detailed Description

This class provides a mechanism to get information about P2P services on a particular realm.

Member Function Documentation

void com.pcbsys.nirvana.nAdminAPI.nServiceNode.addACLEntries ( nACL  entries)

Adds a list of acl entries to the service nodes acl

Parameters
entriesan nACL object containing the list of nACLEntries to add to the existing ACL for this service node
Exceptions
nInsufficientPrivilegesExceptionIf the user is not permissioned to perform this operation
nNodeExceptionif the ACLs being set are invalid
nBaseAdminExceptionif unable to perform the operation, check the message for further information
void com.pcbsys.nirvana.nAdminAPI.nServiceNode.addACLEntry ( nACLEntry  entry)

Adds an nACLEntry to this service nodes acl

Parameters
entryan nACL object containing the list of nACLEntries to add to the existing ACL for this service node
Exceptions
nInsufficientPrivilegesExceptionIf the user is not permissioned to perform this operation
nNodeExceptionif the ACLs being set are invalid
nBaseAdminExceptionif unable to perform the operation, check the message for further information
virtual void com.pcbsys.nirvana.nAdminAPI.nServiceNode.addListener ( nConnectionListener  listener)
virtual

Adds a listener to this service.

When connections to the service are added or removed the listener will be notified asynchronously

Parameters
listenernConnectionListener to use

nConnectionListener

virtual void com.pcbsys.nirvana.nAdminAPI.nServiceNode.closed ( nRealmNode  node)
virtual

Called when the nRealmNode is closed, for internal use only.

Parameters
nodeThe nRealmNode which has been closed
virtual void com.pcbsys.nirvana.nAdminAPI.nServiceNode.delListener ( )
virtual

Removes the registered listener for this service.

This will stop the listener getting informed of new connections to this service

virtual nACL com.pcbsys.nirvana.nAdminAPI.nServiceNode.getACLs ( )
virtual

Returns a nACL object containing a list of nServiceACLEntry

Returns
nACL
Exceptions
nBaseAdminExceptionIf unable to complete the function

nServiceACLEntry nACL

virtual float com.pcbsys.nirvana.nAdminAPI.nServiceNode.getConnectionRate ( )
virtual

The number of subscriptions made to this store per second

Returns
float value
virtual float com.pcbsys.nirvana.nAdminAPI.nServiceNode.getConsumedRate ( )
virtual

The number of events published per second

Returns
float value
virtual int com.pcbsys.nirvana.nAdminAPI.nServiceNode.getCurrentNoOfConnections ( )
virtual

Returns the number of current connections this service is handling

Returns
int number of connections
virtual long com.pcbsys.nirvana.nAdminAPI.nServiceNode.getCurrentNumberOfEvents ( )
virtual

Returns the number of events within the channel/queue

Returns
long value
virtual nServiceInfo com.pcbsys.nirvana.nAdminAPI.nServiceNode.getInformation ( )
virtual

Returns a nServiceInfo containing information about the service

Returns
nServiceInfo

nServiceInfo

virtual string com.pcbsys.nirvana.nAdminAPI.nServiceNode.getLocalName ( )
virtual

Returns the local name without folder information for this service.

Returns
String name
virtual float com.pcbsys.nirvana.nAdminAPI.nServiceNode.getPublishRate ( )
virtual

The number of events published per second

Returns
int value
virtual nRealmNode com.pcbsys.nirvana.nAdminAPI.nServiceNode.getRealm ( )
virtual

Returns the Realm Node this leaf node is associated with.

Please note this might not be the root of the namespace but a federated realm.

Returns
nRealmNode value
virtual long com.pcbsys.nirvana.nAdminAPI.nServiceNode.getTotalConsumed ( )
virtual

Returns the total number of events that this channel has delivered to subscribers

Returns
long value
virtual long com.pcbsys.nirvana.nAdminAPI.nServiceNode.getTotalNoOfConnections ( )
virtual

Returns the total number of connections that this channel has had since the realm started

Returns
long value
virtual long com.pcbsys.nirvana.nAdminAPI.nServiceNode.getTotalPublished ( )
virtual

Returns the total number of events published/pushed to this channel/queue since the realm has started

Returns
long value
virtual long com.pcbsys.nirvana.nAdminAPI.nServiceNode.getUsedSpace ( )
virtual

Returns the number of bytes that this channel/queue consumes on the server

Returns
long value
virtual bool com.pcbsys.nirvana.nAdminAPI.nServiceNode.isActive ( )
virtual

This function returns true if the nServerService is still active.

If the nServerService is shutdown then this method will return false

Returns
boolean value representing the current state
void com.pcbsys.nirvana.nAdminAPI.nServiceNode.modACLEntries ( nACL  entry)

Modifies the acl entries for the service nodes ACL

Parameters
entryan nACL object containing the list of nACLEntries to remove from the existing ACL for this service node
Exceptions
nInsufficientPrivilegesExceptionIf the user is not permissioned to perform this operation
nNodeExceptionif the ACLs being set are invalid
nBaseAdminExceptionif unable to perform the operation, check the message for further information
void com.pcbsys.nirvana.nAdminAPI.nServiceNode.modACLEntry ( nACLEntry  entry)

Modifies the acl entry for the service nodes ACL

Parameters
entryan nACL object containing the list of nACLEntries to remove from the existing ACL for this service node
Exceptions
nInsufficientPrivilegesExceptionIf the user is not permissioned to perform this operation
nNodeExceptionif the ACLs being set are invalid
nBaseAdminExceptionif unable to perform the operation, check the message for further information
void com.pcbsys.nirvana.nAdminAPI.nServiceNode.removeACLEntries ( nACL  entries)

Removes the acl entries from the service nodes ACL

Parameters
entriesan nACL object containing the list of nACLEntries to remove from the existing ACL for this service node
Exceptions
nInsufficientPrivilegesExceptionIf the user is not permissioned to perform this operation
nNodeExceptionif the ACLs being set are invalid
nBaseAdminExceptionif unable to perform the operation, check the message for further information
void com.pcbsys.nirvana.nAdminAPI.nServiceNode.removeACLEntry ( nACLEntry  entry)

Removes the acl entry from the service nodes ACL

Parameters
entryan nACL object containing the list of nACLEntries to remove from the existing ACL for this leaf node
Exceptions
nInsufficientPrivilegesExceptionIf the user is not permissioned to perform this operation
nNodeExceptionif the ACLs being set are invalid
nBaseAdminExceptionif unable to perform the operation, check the message for further information
virtual void com.pcbsys.nirvana.nAdminAPI.nServiceNode.setACLs ( nACL  acl)
virtual

Sets the acl on the service with the nACL list passed in

Parameters
aclNew set of ACL Entry objects to use
Exceptions
nBaseAdminExceptionIf unable to complete the function
nInsufficientPrivilegesExceptionIf the user has no privilege to set the acl

nServiceACLEntry nACL

Property Documentation

override string com.pcbsys.nirvana.nAdminAPI.nServiceNode.Name
get

Returns the name of the service.

Returns
String name