Class DanglingReferenceException

  extended by java.lang.Throwable
      extended by java.lang.Exception
          extended by java.lang.RuntimeException
              extended by
All Implemented Interfaces:

public class DanglingReferenceException
extends java.lang.RuntimeException

During a cloneTree call an updated reference was requested for a node that did not get cloned. This happens when a sub-graph is duplicated via cloneTree and has at least one Leaf node that contains a reference to a Node that has no corresponding node in the cloned sub-graph. This results in two Leaf nodes wanting to share access to the same Node.

If dangling references are to be allowed during the cloneTree call, cloneTree should be called with the allowDanglingReferences parameter set to true.

See Also:
Node.cloneTree(), Serialized Form

Constructor Summary
          Create the exception object with default values.
DanglingReferenceException(java.lang.String str)
          Create the exception object that outputs message.
Method Summary
Methods inherited from class java.lang.Throwable
fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail


public DanglingReferenceException()
Create the exception object with default values.


public DanglingReferenceException(java.lang.String str)
Create the exception object that outputs message.

str - the message string to be output.