com.pcbsys.nirvana.nAdminAPI.nLinkNode Class Reference

Since the Nirvana namespace can contain multiple links to Nirvan Realm servers at different parts of the namespace, including namespace loops, this node represents a RealmServer which has been mounted elseware in the namespace. More...

Inheritance diagram for com.pcbsys.nirvana.nAdminAPI.nLinkNode:
com.pcbsys.nirvana.nAdminAPI.nContainer com.pcbsys.nirvana.nAdminAPI.nRemovable com.pcbsys.nirvana.nAdminAPI.nNode com.pcbsys.nirvana.client.Observable

Public Member Functions

override void closed (nRealmNode node)
 Called when the nRealmNode is closed, for internal use only. More...
 
virtual nRealmNode getRealmNode ()
 Returns the actual nRealmNode to the application More...
 
virtual void remove (bool removeChildren)
 This method enables the removal of the object from the namespace, in this case a RealmNode from the namespace. More...
 
- Public Member Functions inherited from com.pcbsys.nirvana.nAdminAPI.nContainer
void addACLEntries (nACL acl)
 Adds a list of acl entry to all known nodes within the nContainer node. More...
 
void addACLEntries (nACL acl, nNode[] nodes)
 Adds a list acl entry to all nodes contained with in the array of nNodes More...
 
virtual void addACLEntry (nACLEntry entry)
 Adds a specific acl entry to all known nodes within the nContainer node. More...
 
virtual void addACLEntry (nACLEntry entry, bool allChannels, bool allQueues, bool allServices)
 Adds a specific acl entry to all known nodes within the nContainer node. More...
 
virtual nNode findNode (string name)
 Given a name of the form /container/container/name this function will locate the name object and return it, or null if that object can not be found. More...
 
virtual nNode findNode (nNode node)
 Given a name of the form /container/container/name this function will locate the nNode object and return it, or null if that can not be found. More...
 
virtual nNode findNode (nNode node, bool searchChildren)
 Given a name of the form /container/container/name this function will locate the name object and return it, or null if that can not be found. More...
 
nNode getNextSibling ()
 Method to return the next sibling from this node's parent More...
 
virtual nNode getNextSibling (int idx)
 Returns the sibling at position idx from this nodes parent. More...
 
virtual
System.Collections.IEnumerator 
getNodes ()
 Returns an IEnumerator of all the nodes under this container. More...
 
virtual nRealmNode getRealmAt (string name)
 Given a mount point this function will return a realm if one exists at the specified mount point More...
 
nRealmNode getRealmNode ()
 Get method for the realm node which acts as a container for this object More...
 
virtual int getSize ()
 Returns the number of nodes under this container. More...
 
virtual int getTotalNodes ()
 Returns the total number of nodes within this container and all subsequent children by traversing the entire structure beneath this container node More...
 
virtual bool hasRealmAt (string name)
 Given a mount point this function will determine if this container contains a mounted realm at the specified mount point More...
 
void modACLEntries (nACL acl)
 Modifies a list of acl entry to all known nodes within the nContainer node. More...
 
void modACLEntries (nACL acl, nNode[] nodes)
 Modifies a list of acl entry to all nodes contained with in the array of nNodes More...
 
virtual void modACLEntry (nACLEntry entry)
 modifies a specific acl entry's permissions for all known nodes within the nContainer node. More...
 
virtual void modACLEntry (nACLEntry entry, bool allChannels, bool allQueues, bool allServices)
 modifies a specific acl entry's permissions for all known nodes within the nContainer node. More...
 
void removeACLEntries (nACL acl)
 Removes a list of acl entries from all known nodes within the nContainer node. More...
 
void removeACLEntries (nACL acl, nNode[] nodes)
 Removes a list of acl entries from all nodes contained with in the array of nNodes More...
 
virtual void removeACLEntry (nACLEntry entry)
 removes a specific acl entry from all known nodes within the nContainer node. More...
 
virtual void removeACLEntry (nACLEntry entry, bool allChannels, bool allQueues, bool allServices)
 removes a specific acl entry from all known nodes within the nContainer node. More...
 
virtual void setACL (nACL acl)
 Replaces the existing ACL with the nACL supplied to all known nodes within the nContainer node. More...
 
virtual void setACL (nACL acl, bool allChannels, bool allQueues, bool allServices)
 Replaces the existing ACL with the nACL supplied to all known nodes within the nContainer node. 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...
 

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...
 
- Properties inherited from com.pcbsys.nirvana.nAdminAPI.nNode
virtual string Name [get]
 Returns the generic name of this node within the namespace More...
 

Detailed Description

Since the Nirvana namespace can contain multiple links to Nirvan Realm servers at different parts of the namespace, including namespace loops, this node represents a RealmServer which has been mounted elseware in the namespace.

It is basically a placeholder within the namespace and can be used by the application to stop looping through the namespace and to render the node differently or perhaps display a link between this node and the other nRealmNode.

nRealmNode

Member Function Documentation

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

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

Parameters
nodeThe nRealmNode which has been closed

Reimplemented from com.pcbsys.nirvana.nAdminAPI.nContainer.

virtual nRealmNode com.pcbsys.nirvana.nAdminAPI.nLinkNode.getRealmNode ( )
virtual

Returns the actual nRealmNode to the application

nRealmNode

Returns
nRealmNode object of the real Realm Server
virtual void com.pcbsys.nirvana.nAdminAPI.nLinkNode.remove ( bool  removeChildren)
virtual

This method enables the removal of the object from the namespace, in this case a RealmNode from the namespace.

If you specify true, all child nodes, including channels, queues and services will also be removed from the realm before removing it from its parent

Parameters
removeChildrena boolean specifying whether siblings should be removed too
Exceptions
nUnsupportedRemoveExceptionthrown if remove is not supported (e.g. on the namespace root Realm)
nNodeExceptionis thrown if an error occurs in the remove operation

nLeafNode nRealmNode

Implements com.pcbsys.nirvana.nAdminAPI.nRemovable.