com.ibm.as400.registry
Class RegistryNode

java.lang.Object
  |
  +--com.ibm.as400.registry.RegistryNode

public abstract class RegistryNode
extends java.lang.Object

The representation of a node in a hierarchical collection of configuration information. RegistryNode provides methods that let applications store and retrieve configuration data. The data is stored persistently in an implementation-dependent backing store. Applications need not concern themselves with the type of backing store being used.

Methods that modify registry data operate asynchronously, i.e. changes need not be immediately propagated to the backing store. The method flush may be used to force updates to the backing store.

Within a single process, there is at most one RegistryNode which represents a particular node in the registry hierarchy. It follows that if n1 and n2 are references to RegistryNode objects representing the same location in the hierarchy, then n1 == n2.

Example Usage

 import com.ibm.as400.registry.*;
 ...
 try
 {
   // Get the application registry
   ApplicationRegistry reg = (ApplicationRegistry)Registry.getInstance();

   // Get the user namespace root for the current user
   RegistryNode root = reg.getRoot(Registry.USER_ROOT);

   // Get the "preferences" node for this user, creating it if necessary
   RegistryNode prefs = root.createNode("preferences");

   // Store some preferences
   prefs.putValue("Favorite Ice Cream", "vanilla");
   prefs.putValue("Favorite Music", "Steely Dan");

   // Commit changes to the backing store
   prefs.flush();
 }
 catch (RegistryException e)
 { e.printStackTrace(); }
 

Since:
v5r1m0
See Also:
Registry, WindowsRegistry, ApplicationRegistry, LDAPRegistry

Method Summary
 void addNodeChangeListener(NodeChangeListener ncl)
          Adds the specified listener to receive NodeChangeEvents for this RegistryNode.
 void addPropertyChangeListener(java.beans.PropertyChangeListener pcl)
          Adds the specified listener to receive PropertyChangeEvents for this RegistryNode.
 void clear()
          Removes all attribute-value pairs from this node.
 RegistryNode createNode(java.lang.String path)
          Returns the specified RegistryNode, creating it and any of its ancestors if they do not already exist.
 void flush()
          Forces any changes to the contents of this RegistryNode and its descendants to the persistent store.
 java.lang.String[] getAttributes()
          Returns all of the attributes that have an associated value in this RegistryNode.
 boolean getBooleanValue(java.lang.String attribute, boolean defaultValue)
          Returns the boolean value associated with the specified attribute in this RegistryNode.
 byte[] getByteValue(java.lang.String attribute, byte[] defaultValue)
          Returns the byte array value associated with the specified attribute in this RegistryNode.
 RegistryNode[] getChildren()
          Returns the children of this RegistryNode.
 java.lang.String getFullName()
          Returns this RegistryNode's absolute path name within the current namespace.
 int getIntValue(java.lang.String attribute, int defaultValue)
          Returns the integer value associated with the specified attribute in this RegistryNode.
 java.lang.String getName()
          Returns this RegistryNode's name, relative to its parent.
 java.lang.String getNamespace()
          Returns an indicator identifying which namespace this RegistryNode belongs to.
 RegistryNode getNode(java.lang.String path)
          Returns the specified RegistryNode.
 java.lang.Object getObjectValue(java.lang.String attribute, java.lang.Object defaultValue)
          Returns the Object associated with the specified attribute in this RegistryNode.
 RegistryNode getParent()
          Returns the parent of this RegistryNode, or null if this is a namespace root.
 long getUnsignedIntValue(java.lang.String attribute, long defaultValue)
          Returns the unsigned integer value associated with the specified attribute in this RegistryNode.
 java.lang.String getValue()
          Returns the default value for this RegistryNode.
 java.lang.String getValue(java.lang.String attribute)
          Returns the value associated with the specified attribute in this RegistryNode.
 boolean isBoolean(java.lang.String attribute)
          Indicates whether the value associated with the specified attribute is a boolean.
 boolean isByteArray(java.lang.String attribute)
          Indicates whether the value associated with the specified attribute is a byte array.
 boolean isInteger(java.lang.String attribute)
          Indicates whether the value associated with the specified attribute is an integer.
 boolean isModified()
          Indicates whether this object has been modified.
 boolean isObject(java.lang.String attribute)
          Indicates whether the value associated with the specified attribute is an Object.
 boolean isString(java.lang.String attribute)
          Indicates whether the value associated with the specified attribute is a String.
 boolean isUnsignedInteger(java.lang.String attribute)
          Indicates whether the value associated with the specified attribute is an unsigned integer.
 boolean nodeExists(java.lang.String path)
          Determines whether the specified RegistryNode exists.
 void putBooleanValue(java.lang.String attribute, boolean value)
          Associates a boolean value with the specified attribute in this RegistryNode.
 void putByteValue(java.lang.String attribute, byte[] value)
          Associates a byte array value with the specified attribute in this RegistryNode.
 void putIntValue(java.lang.String attribute, int value)
          Associates an integer value with the specified attribute in this RegistryNode.
 void putObjectValue(java.lang.String attribute, java.lang.Object value)
          Associates an object with the specified attribute in this RegistryNode.
 void putUnsignedIntValue(java.lang.String attribute, long value)
          Associates an unsigned integer value with the specified attribute in this RegistryNode.
 void putValue(java.lang.String value)
          Assigns the specified default value to this RegistryNode.
 void putValue(java.lang.String attribute, java.lang.String value)
          Associates the specified string value with the designated attribute in this RegistryNode.
 java.lang.String remove(java.lang.String attribute)
          Removes the value associated with the specified attribute in this RegistryNode.
 boolean removeNode(java.lang.String path)
          Removes the specified RegistryNode and all of its descendants.
 void removeNodeChangeListener(NodeChangeListener ncl)
          Removes the specified listener so it no longer receives NodeChangeEvents for this RegistryNode.
 void removePropertyChangeListener(java.beans.PropertyChangeListener pcl)
          Removes the specified listener so it no longer receives PropertyChangeEvents for this RegistryNode.
 java.lang.String toString()
          Returns a string representation of this RegistryNode.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Method Detail

flush

public void flush()
           throws RegistryException
Forces any changes to the contents of this RegistryNode and its descendants to the persistent store. If this RegistryNode has been created since the last call to flush, it and all of its descendants are made permanent by this operation.

Pending modifications to the registry hierarchy are not automatically flushed on process termination. This is so that applications can abandon pending changes if desired.

Throws:
RegistryException - If the changes cannot be flushed.
java.lang.IllegalStateException - If this node has been removed from the registry hierarchy.
Since:
v5r1m0

createNode

public RegistryNode createNode(java.lang.String path)
                        throws RegistryException
Returns the specified RegistryNode, creating it and any of its ancestors if they do not already exist. Accepts either a relative or absolute path name. Absolute path names begin with '/' and are interpreted relative to the root of the current namespace. Relative path names begin with any character other than a slash and are interpreted relative to this RegistryNode. The path name "" is valid and refers to this RegistryNode.

Path names cannot contain any of the characters \ : ? " < > |.

If this call causes nodes to be created, the nodes are not guaranteed to be persistent until the flush method is called on this node or on one of its ancestors.

Parameters:
path - The path name of the RegistryNode to return. Elements of the path should be separated with a slash character '/'.
Returns:
The specified RegistryNode.
Throws:
NullPointerException - If path is null.
java.lang.IllegalArgumentException - If the path name contains invalid characters.
java.lang.IllegalStateException - If this node has been removed from the registry hierarchy.
RegistryException - If the backing store cannot be accessed.
Since:
v5r1m0
See Also:
flush()

getNode

public RegistryNode getNode(java.lang.String path)
                     throws NodeNotFoundException,
                            RegistryException
Returns the specified RegistryNode. It is assumed that the node already exists in the registry hierarchy. If it does not, a NodeNotFoundException will be thrown.

Accepts either a relative or absolute path name. Absolute path names begin with '/' and are interpreted relative to the root of the current namespace. Relative path names begin with any character other than a slash and are interpreted relative to this RegistryNode. The path name "" is valid and refers to this RegistryNode.

Path names cannot contain any of the characters \ : ? " < > |.

Parameters:
path - The path name of the RegistryNode to return. Elements of the path should be separated with a slash character '/'.
Returns:
The specified RegistryNode.
Throws:
NullPointerException - If path is null.
java.lang.IllegalArgumentException - If the path name contains invalid characters.
java.lang.IllegalStateException - If this node has been removed from the registry hierarchy.
NodeNotFoundException - If the specified node does not exist.
RegistryException - If the backing store cannot be accessed.
Since:
v5r1m0
See Also:
createNode(java.lang.String)

nodeExists

public boolean nodeExists(java.lang.String path)
Determines whether the specified RegistryNode exists. Accepts either a relative or absolute path name. Absolute path names begin with '/' and are interpreted relative to the root of the current namespace. Relative path names begin with any character other than a slash and are interpreted relative to this RegistryNode. The path name "" is valid and refers to this RegistryNode.

Path names cannot contain any of the characters \ : ? " < > |.

Parameters:
path - The path name of the RegistryNode whose existence is to be checked. Elements of the path should be separated with a slash character '/'.
Returns:
true if the specified node exists; false otherwise.
Throws:
NullPointerException - If path is null.
java.lang.IllegalArgumentException - If the path name contains invalid characters.
Since:
v5r1m0

removeNode

public boolean removeNode(java.lang.String path)
Removes the specified RegistryNode and all of its descendants. Accepts either a relative or absolute path name. Absolute path names begin with '/' and are interpreted relative to the root of the current namespace. Relative path names begin with any character other than a slash and are interpreted relative to this RegistryNode. The path name "" is valid and refers to this RegistryNode.

Path names cannot contain any of the characters \ : ? " < > |.

The removal of a node is not guaranteed to be permanent until the flush method is called on an ancestor of the specified node.

Once a RegistryNode has been removed, attempting any operation on the node other than getNamespace, getFullName, getName or nodeExists will result in an IllegalStateException.

Returns:
true if the node was successfully removed; falseif the node does not exist.
Since:
v5r1m0

getChildren

public RegistryNode[] getChildren()
Returns the children of this RegistryNode. The returned array will be of size zero if this node has no children. The order of the children in the array is undefined.

Returns:
The children of this preference node.
Throws:
java.lang.IllegalStateException - If this node has been removed from the registry hierarchy.
Since:
v5r1m0

getParent

public RegistryNode getParent()
Returns the parent of this RegistryNode, or null if this is a namespace root.

Returns:
The parent of this node.
Throws:
java.lang.IllegalStateException - If this node has been removed from the registry hierarchy.
Since:
v5r1m0

getFullName

public java.lang.String getFullName()
Returns this RegistryNode's absolute path name within the current namespace.

Returns:
The full name of this node as a string.
Since:
v5r1m0

getName

public java.lang.String getName()
Returns this RegistryNode's name, relative to its parent. Returns "/" if this is a namespace root.

Returns:
The relative name of this node as a string.
Since:
v5r1m0

getNamespace

public java.lang.String getNamespace()
Returns an indicator identifying which namespace this RegistryNode belongs to. The indicators are defined on the Registry class.

Returns:
A namespace constant identifying this node's namespace.
Since:
v5r1m0
See Also:
Registry

clear

public void clear()
Removes all attribute-value pairs from this node.

Throws:
java.lang.IllegalStateException - If this node has been removed from the registry hierarchy.
Since:
v5r1m0

remove

public java.lang.String remove(java.lang.String attribute)
Removes the value associated with the specified attribute in this RegistryNode. Returns the value previously associated with the attribute, or null if there was no value associated with the attribute.

Parameters:
attribute - The attribute whose mapping is to be removed from this node. If null the default value will be removed.
Returns:
The value to which the attribute had been mapped in this RegistryNode, or null if the attribute did not have a mapping.
Throws:
java.lang.IllegalStateException - If this node has been removed from the registry hierarchy.
Since:
v5r1m0

getAttributes

public java.lang.String[] getAttributes()
Returns all of the attributes that have an associated value in this RegistryNode. Note that the attribute associated with the default value for a node has no string representation and will not be included in the returned array.

Returns:
An array of the attributes in this node.
Throws:
java.lang.IllegalStateException - If this node has been removed from the registry hierarchy.
Since:
v5r1m0

getValue

public java.lang.String getValue()
Returns the default value for this RegistryNode. Equivalent to getValue(null). If no default value has been assigned getValue will return null.

Returns:
The default value for this node, as a String.
Throws:
java.lang.IllegalStateException - If this node has been removed from the registry hierarchy.
Since:
v5r1m0

getValue

public java.lang.String getValue(java.lang.String attribute)
Returns the value associated with the specified attribute in this RegistryNode. If the value was not stored as a string, it will be converted to a string using the appropriate data conversion. If no value has been assigned to the attribute getValue will return null.

Parameters:
attribute - The attribute whose value is to be returned. If null the default value for this node will be returned.
Returns:
The value associated with attribute, in the form of a String.
Throws:
java.lang.IllegalStateException - If this node has been removed from the registry hierarchy.
Since:
v5r1m0

getIntValue

public int getIntValue(java.lang.String attribute,
                       int defaultValue)
Returns the integer value associated with the specified attribute in this RegistryNode. If no value has been assigned to the attribute or the value cannot be represented as an integer, getIntValue will return the specified default value.

Parameters:
attribute - The attribute whose value is to be returned. If null the default value for this node will be returned.
defaultValue - The value to be returned if no value is assigned to the attribute or the value is not an integer.
Returns:
The value associated with attribute.
Throws:
java.lang.IllegalStateException - If this node has been removed from the registry hierarchy.
Since:
v5r1m0
See Also:
putIntValue(java.lang.String, int)

getUnsignedIntValue

public long getUnsignedIntValue(java.lang.String attribute,
                                long defaultValue)
Returns the unsigned integer value associated with the specified attribute in this RegistryNode. The value is represented in Java as a long.

If no value has been assigned to the attribute or the value cannot be represented as an unsigned integer, getUnsignedIntValue will return the specified default value.

Parameters:
attribute - The attribute whose value is to be returned. If null the default value for this node will be returned.
defaultValue - The value to be returned if no value is assigned to the attribute or the value is not an unsigned integer.
Returns:
The value associated with attribute.
Throws:
java.lang.IllegalStateException - If this node has been removed from the registry hierarchy.
Since:
v5r1m0
See Also:
putUnsignedIntValue(java.lang.String, long)

getBooleanValue

public boolean getBooleanValue(java.lang.String attribute,
                               boolean defaultValue)
Returns the boolean value associated with the specified attribute in this RegistryNode. If no value has been assigned to the attribute or the value cannot be represented as a boolean, getBooleanValue will return the specified default value.

Parameters:
attribute - The attribute whose value is to be returned. If null the default value for this node will be returned.
defaultValue - The value to be returned if no value is assigned to the attribute or the value is not a boolean.
Returns:
The value associated with attribute.
Throws:
java.lang.IllegalStateException - If this node has been removed from the registry hierarchy.
Since:
v5r1m0
See Also:
putBooleanValue(java.lang.String, boolean)

getByteValue

public byte[] getByteValue(java.lang.String attribute,
                           byte[] defaultValue)
Returns the byte array value associated with the specified attribute in this RegistryNode. If no value has been assigned to the attribute or the value cannot be represented as a byte array, getByteValue will return the specified default value.

Parameters:
attribute - The attribute whose value is to be returned. If null the default value for this node will be returned.
defaultValue - The value to be returned if no value is assigned to the attribute or the value is not a byte array.
Returns:
The value associated with attribute.
Throws:
java.lang.IllegalStateException - If this node has been removed from the registry hierarchy.
Since:
v5r1m0
See Also:
putByteValue(java.lang.String, byte[])

getObjectValue

public java.lang.Object getObjectValue(java.lang.String attribute,
                                       java.lang.Object defaultValue)
Returns the Object associated with the specified attribute in this RegistryNode. If no value has been assigned to the attribute, getObjectValue will return the specified default value.

This method will attempt to return a clone of the object in the registry by calling its public clone method. No exception is thrown if the object's class does not implement clone. However, since the registry cache will contain a direct reference to the returned object, subsequent changes to the object's state will be immediately reflected in the registry. If this is not the desired behavior, the object's class should implement the Cloneable interface and a public clone method. Note that for the clone method to be accessible the application class must be a public class.

Parameters:
attribute - The attribute whose value is to be returned. If null the default value for this node will be returned.
defaultValue - The Object to be returned if no value is assigned to the attribute or the value is not an Object.
Returns:
The value (or a clone of the value) associated with attribute.
Throws:
java.lang.IllegalStateException - If this node has been removed from the registry hierarchy.
Since:
v5r1m0
See Also:
putObjectValue(java.lang.String, java.lang.Object)

putValue

public void putValue(java.lang.String value)
Assigns the specified default value to this RegistryNode. Equivalent to putValue(null, value).

Parameters:
value - The default value to be associated with this node.
Throws:
NullPointerException - If value is null.
java.lang.IllegalStateException - If this node has been removed from the registry hierarchy.
Since:
v5r1m0

putValue

public void putValue(java.lang.String attribute,
                     java.lang.String value)
Associates the specified string value with the designated attribute in this RegistryNode.

Parameters:
attribute - The attribute with which the specified value is to be associated. If null, the value will be treated as the default value for this node.
value - The string value to be associated with attribute.
Throws:
NullPointerException - If value is null.
java.lang.IllegalStateException - If this node has been removed from the registry hierarchy.
Since:
v5r1m0

putIntValue

public void putIntValue(java.lang.String attribute,
                        int value)
Associates an integer value with the specified attribute in this RegistryNode. The value may later be retrieved using either getIntValue or getValue.

Parameters:
attribute - The attribute with which the specified value is to be associated. If null, the value will be treated as the default value for this node.
value - The integer value to be associated with attribute.
Throws:
NullPointerException - If attribute is null.
java.lang.IllegalStateException - If this node has been removed from the registry hierarchy.
Since:
v5r1m0
See Also:
getValue(), getIntValue(java.lang.String, int)

putUnsignedIntValue

public void putUnsignedIntValue(java.lang.String attribute,
                                long value)
Associates an unsigned integer value with the specified attribute in this RegistryNode. The value is represented in Java as a long.

The value may later be retrieved using either getUnsignedIntValue or getValue.

Parameters:
attribute - The attribute with which the specified value is to be associated. If null, the value will be treated as the default value for this node.
value - The unsigned integer value to be associated with attribute.
Throws:
NullPointerException - If attribute is null.
java.lang.IllegalArgumentException - If the value is not in the range 0-0xffffffff.
java.lang.IllegalStateException - If this node has been removed from the registry hierarchy.
Since:
v5r1m0
See Also:
getValue(), getUnsignedIntValue(java.lang.String, long)

putBooleanValue

public void putBooleanValue(java.lang.String attribute,
                            boolean value)
Associates a boolean value with the specified attribute in this RegistryNode. The value may later be retrieved using either getBooleanValue or getValue.

Parameters:
attribute - The attribute with which the specified value is to be associated. If null, the value will be treated as the default value for this node.
value - The value to be associated with attribute.
Throws:
NullPointerException - If attribute is null.
java.lang.IllegalStateException - If this node has been removed from the registry hierarchy.
Since:
v5r1m0
See Also:
getValue(), getBooleanValue(java.lang.String, boolean)

putByteValue

public void putByteValue(java.lang.String attribute,
                         byte[] value)
Associates a byte array value with the specified attribute in this RegistryNode. The value may later be retrieved using either getByteValue or getValue.

Parameters:
attribute - The attribute with which the specified value is to be associated. If null, the value will be treated as the default value for this node.
value - The value to be associated with attribute.
Throws:
NullPointerException - If attribute is null.
java.lang.IllegalStateException - If this node has been removed from the registry hierarchy.
Since:
v5r1m0
See Also:
getValue(), getByteValue(java.lang.String, byte[])

putObjectValue

public void putObjectValue(java.lang.String attribute,
                           java.lang.Object value)
Associates an object with the specified attribute in this RegistryNode. The value may later be retrieved using either getObjectValue or getValue.

The object's class must implement the java.io.Serializable interface. In addition, if objects to which the designated object refers do not also implement Serializable, a java.io.NotSerializableException will occur when flush is called. The application is therefore responsible for ensuring that the entire object graph is serializable.

This method will attempt to store a clone of the specified object by calling its public clone method. No exception is thrown if the object's class does not implement clone. However, since the registry cache will contain a direct reference to the application object, subsequent changes to the object's state will be immediately reflected in the registry. If this is not the desired behavior, the object's class should implement the Cloneable interface and a public clone method. Note that for the clone method to be accessible the application class must be a public class.

Parameters:
attribute - The attribute with which the specified value is to be associated. If null, the value will be treated as the default value for this node.
value - The object to be associated with attribute.
Throws:
java.lang.IllegalArgumentException - If the object does not implement Serializable.
NullPointerException - If attribute is null.
java.lang.IllegalStateException - If this node has been removed from the registry hierarchy.
Since:
v5r1m0
See Also:
getValue(), getObjectValue(java.lang.String, java.lang.Object)

isString

public boolean isString(java.lang.String attribute)
Indicates whether the value associated with the specified attribute is a String. If no value has been assigned to the attribute isString will return false.

Parameters:
attribute - The attribute with which the specified value is associated. If null, the value will be treated as the default value for this node.
Returns:
true if the value is a string; false otherwise.
Throws:
java.lang.IllegalStateException - If this node has been removed from the registry hierarchy.
Since:
v5r1m0

isInteger

public boolean isInteger(java.lang.String attribute)
Indicates whether the value associated with the specified attribute is an integer. If no value has been assigned to the attribute isInteger will return false.

Parameters:
attribute - The attribute with which the specified value is associated. If null, the value will be treated as the default value for this node.
Returns:
true if the value is an integer; false otherwise.
Throws:
java.lang.IllegalStateException - If this node has been removed from the registry hierarchy.
Since:
v5r1m0

isUnsignedInteger

public boolean isUnsignedInteger(java.lang.String attribute)
Indicates whether the value associated with the specified attribute is an unsigned integer. If no value has been assigned to the attribute isUnsignedInteger will return false.

Parameters:
attribute - The attribute with which the specified value is associated. If null, the value will be treated as the default value for this node.
Returns:
true if the value is an unsigned integer; false otherwise.
Throws:
java.lang.IllegalStateException - If this node has been removed from the registry hierarchy.
Since:
v5r1m0

isBoolean

public boolean isBoolean(java.lang.String attribute)
Indicates whether the value associated with the specified attribute is a boolean. If no value has been assigned to the attribute isBoolean will return false.

Parameters:
attribute - The attribute with which the specified value is associated. If null, the value will be treated as the default value for this node.
Returns:
true if the value is a boolean; false otherwise.
Throws:
java.lang.IllegalStateException - If this node has been removed from the registry hierarchy.
Since:
v5r1m0

isByteArray

public boolean isByteArray(java.lang.String attribute)
Indicates whether the value associated with the specified attribute is a byte array. If no value has been assigned to the attribute isByteArray will return false.

Parameters:
attribute - The attribute with which the specified value is associated. If null, the value will be treated as the default value for this node.
Returns:
true if the value is a byte array; false otherwise.
Throws:
java.lang.IllegalStateException - If this node has been removed from the registry hierarchy.
Since:
v5r1m0

isObject

public boolean isObject(java.lang.String attribute)
Indicates whether the value associated with the specified attribute is an Object. If no value has been assigned to the attribute isObject will return false.

isObject returns true except when the value is stored as an integer, boolean, or byte array.

Parameters:
attribute - The attribute with which the specified value is associated. If null, the value will be treated as the default value for this node.
Returns:
true if the value is an Object; false otherwise.
Throws:
java.lang.IllegalStateException - If this node has been removed from the registry hierarchy.
Since:
v5r1m0

isModified

public boolean isModified()
Indicates whether this object has been modified. A node is modified if it has just been created, or if its attributes have been changed. The changes to this RegistryNode are not guaranteed to be persistent until the flush method is called on this node or on one of its ancestors.

Returns:
true if the node has been modified; false otherwise.
Since:
v5r1m0

addPropertyChangeListener

public final void addPropertyChangeListener(java.beans.PropertyChangeListener pcl)
Adds the specified listener to receive PropertyChangeEvents for this RegistryNode. A PropertyChangeEvent is generated whenever an attribute is added to this node, removed from this node, or when the attribute value is changed. The property name is the attribute being added, removed or modified (will be null if the default value is being modified). An old value of null indicates the preference was added; a new value of null indicates the preference was removed.

Parameters:
pcl - The PropertyChangeListener to be added.
Throws:
NullPointerException - If pcl is null.
Since:
v5r1m0

removePropertyChangeListener

public final void removePropertyChangeListener(java.beans.PropertyChangeListener pcl)
Removes the specified listener so it no longer receives PropertyChangeEvents for this RegistryNode.

Parameters:
pcl - The PropertyChangeListener to be removed.
Throws:
NullPointerException - If pcl is null.
Since:
v5r1m0

addNodeChangeListener

public final void addNodeChangeListener(NodeChangeListener ncl)
Adds the specified listener to receive NodeChangeEvents for this RegistryNode. A NodeChangeEvent is generated whenever a child node is added to or removed from this node.

Parameters:
ncl - The NodeChangeListener to be added.
Throws:
NullPointerException - If ncl is null.
Since:
v5r1m0
See Also:
NodeChangeListener, NodeChangeEvent

removeNodeChangeListener

public final void removeNodeChangeListener(NodeChangeListener ncl)
Removes the specified listener so it no longer receives NodeChangeEvents for this RegistryNode.

Parameters:
ncl - The NodeChangeListener to be removed.
Throws:
NullPointerException - If ncl is null.
Since:
v5r1m0
See Also:
NodeChangeListener, NodeChangeEvent

toString

public java.lang.String toString()
Returns a string representation of this RegistryNode.

Overrides:
toString in class java.lang.Object
Returns:
A string representation of this object.
Since:
v5r1m0
See Also:
getFullName()