org.w3c.dom: public interface: UserDataHandler

org.w3c.dom
public interface: UserDataHandler [javadoc | source] When associating an object to a key on a node using Node.setUserData() the application can provide a handler that gets called when the node the object is associated to is being cloned, imported, or renamed. This can be used by the application to implement various behaviors regarding the data it associates to the DOM nodes. This interface defines that handler.

since: DOM - Level 3

Field Summary
public static final short	NODE_CLONED	The node is cloned, using `Node.cloneNode()`.
public static final short	NODE_IMPORTED	The node is imported, using `Document.importNode()`.
public static final short	NODE_DELETED	The node is deleted. Note: This may not be supported or may not be reliable in certain environments, such as Java, where the implementation has no real control over when objects are actually deleted.
public static final short	NODE_RENAMED	The node is renamed, using `Document.renameNode()`.
public static final short	NODE_ADOPTED	The node is adopted, using `Document.adoptNode()`.

Method from org.w3c.dom.UserDataHandler Summary:
handle

Method from org.w3c.dom.UserDataHandler Detail:
public void handle(short operation, String key, Object data, Node src, Node dst) This method is called whenever the node for which this handler is registered is imported or cloned. DOM applications must not raise exceptions in a `UserDataHandler`. The effect of throwing exceptions from the handler is DOM implementation dependent.

Method from org.w3c.dom.UserDataHandler Detail:

 public  void handle(short operation,
    String key,
    Object data,
    Node src,
    Node dst)This method is called whenever the node for which this handler is
registered is imported or cloned.

 DOM applications must not raise exceptions in a
UserDataHandler. The effect of throwing exceptions from
the handler is DOM implementation dependent.