DeferredEntityImpl

Class Overview

Entity nodes hold the reference data for an XML Entity -- either parsed or unparsed. The nodeName (inherited from Node) will contain the name (if any) of the Entity. Its data will be contained in the Entity's children, in exactly the structure which an EntityReference to this name will present within the document's body.

Note that this object models the actual entity, _not_ the entity declaration or the entity reference.

An XML processor may choose to completely expand entities before the structure model is passed to the DOM; in this case, there will be no EntityReferences in the DOM tree.

Quoting the 10/01 DOM Proposal,

"The DOM Level 1 does not support editing Entity nodes; if a user wants to make changes to the contents of an Entity, every related EntityReference node has to be replaced in the structure model by a clone of the Entity's contents, and then the desired changes must be made to each of those clones instead. All the descendants of an Entity node are readonly."

I'm interpreting this as: It is the parser's responsibilty to call the non-DOM operation setReadOnly(true,true) after it constructs the Entity. Since the DOM explicitly decided not to deal with this, _any_ answer will involve a non-DOM operation, and this is the simplest solution.@xerces.internal

Summary

[Expand] Inherited Constants
From class org.apache.xerces.dom.NodeImpl short DOCUMENT_POSITION_CONTAINS short DOCUMENT_POSITION_DISCONNECTED short DOCUMENT_POSITION_FOLLOWING short DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC short DOCUMENT_POSITION_IS_CONTAINED short DOCUMENT_POSITION_PRECEDING short ELEMENT_DEFINITION_NODE Element definition node type. short FIRSTCHILD short HASSTRING short ID short IGNORABLEWS short NORMALIZED short OWNED short READONLY short SPECIFIED short SYNCCHILDREN short SYNCDATA short TREE_POSITION_ANCESTOR The node is an ancestor of the reference node. short TREE_POSITION_DESCENDANT The node is a descendant of the reference node. short TREE_POSITION_DISCONNECTED The two nodes are disconnected, they do not have any common ancestor. short TREE_POSITION_EQUIVALENT The two nodes have an equivalent position. short TREE_POSITION_FOLLOWING The node follows the reference node. short TREE_POSITION_PRECEDING The node precedes the reference node. short TREE_POSITION_SAME_NODE The two nodes are the same.
From interface org.apache.xerces.dom.DeferredNode short TYPE_NODE
From interface org.w3c.dom.Node short ATTRIBUTE_NODE short CDATA_SECTION_NODE short COMMENT_NODE short DOCUMENT_FRAGMENT_NODE short DOCUMENT_NODE short DOCUMENT_POSITION_CONTAINED_BY short DOCUMENT_POSITION_CONTAINS short DOCUMENT_POSITION_DISCONNECTED short DOCUMENT_POSITION_FOLLOWING short DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC short DOCUMENT_POSITION_PRECEDING short DOCUMENT_TYPE_NODE short ELEMENT_NODE short ENTITY_NODE short ENTITY_REFERENCE_NODE short NOTATION_NODE short PROCESSING_INSTRUCTION_NODE short TEXT_NODE

Fields
protected int	fNodeIndex	Node index.

[Expand] Inherited Fields
From class org.apache.xerces.dom.EntityImpl protected String baseURI base uri protected String encoding Encoding protected String inputEncoding Input Encoding protected String name Entity name. protected String notationName Notation name. protected String publicId Public identifier. protected String systemId System identifier. protected String version Version
From class org.apache.xerces.dom.ParentNode protected NodeListCache fNodeListCache NodeList cache protected ChildNode firstChild First child. protected CoreDocumentImpl ownerDocument Owner document.
From class org.apache.xerces.dom.ChildNode protected ChildNode nextSibling Next sibling. protected ChildNode previousSibling Previous sibling.
From class org.apache.xerces.dom.NodeImpl protected short flags protected NodeImpl ownerNode

Public Methods
int	getNodeIndex() Returns the node index.

Protected Methods
void	synchronizeChildren() Synchronize the children.
void	synchronizeData() Synchronize the entity data.

[Expand] Inherited Methods
From class org.apache.xerces.dom.EntityImpl Node cloneNode(boolean deep) Clone node. String getBaseURI() Returns the absolute base URI of this node or null if the implementation wasn't able to obtain an absolute URI. String getInputEncoding() An attribute specifying the encoding used for this entity at the tiome of parsing, when it is an external parsed entity. String getNodeName() Returns the entity name short getNodeType() A short integer indicating what type of node this is. String getNotationName() Unparsed entities -- which contain non-XML data -- have a "notation name" which tells applications how to deal with them. String getPublicId() The public identifier associated with the entity. String getSystemId() The system identifier associated with the entity. String getXmlEncoding() DOM Level 3 WD - experimental the encoding of this entity, when it is an external parsed entity. String getXmlVersion() DOM Level 3 WD - experimental the version number of this entity, when it is an external parsed entity. void setBaseURI(String uri) NON-DOM: set base uri void setInputEncoding(String inputEncoding) NON-DOM, used to set the input encoding. void setNotationName(String name) DOM Level 2: Unparsed entities -- which contain non-XML data -- have a "notation name" which tells applications how to deal with them. void setPublicId(String id) DOM Level 2: The public identifier associated with the entity. void setSystemId(String id) DOM Level 2: The system identifier associated with the entity. void setXmlEncoding(String value) NON-DOM encoding - An attribute specifying, as part of the text declaration, the encoding of this entity, when it is an external parsed entity. void setXmlVersion(String value) NON-DOM version - An attribute specifying, as part of the text declaration, the version number of this entity, when it is an external parsed entity.
From class org.apache.xerces.dom.ParentNode Node cloneNode(boolean deep) Returns a duplicate of a given node. NodeList getChildNodes() Obtain a NodeList enumerating all children of this node. final NodeList getChildNodesUnoptimized() Create a NodeList to access children that is use by subclass elements that have methods named getLength() or item(int). Node getFirstChild() The first child of this Node, or null if none. Node getLastChild() The last child of this Node, or null if none. int getLength() NodeList method: Count the immediate children of this node Document getOwnerDocument() Find the Document that this Node belongs to (the document in whose context the Node was created). String getTextContent() This attribute returns the text content of this node and its descendants. boolean hasChildNodes() Test whether this node has any children. Node insertBefore(Node newChild, Node refChild) Move one or more node(s) to our list of children. boolean isEqualNode(Node arg) DOM Level 3 WD- Experimental. Node item(int index) NodeList method: Return the Nth immediate child of this node, or null if the index is out of bounds. void normalize() Override default behavior to call normalize() on this Node's children. Node removeChild(Node oldChild) Remove a child from this Node. Node replaceChild(Node newChild, Node oldChild) Make newChild occupy the location that oldChild used to have. void setOwnerDocument(CoreDocumentImpl doc) NON-DOM set the ownerDocument of this node and its children void setReadOnly(boolean readOnly, boolean deep) Override default behavior so that if deep is true, children are also toggled. void setTextContent(String textContent) This attribute returns the text content of this node and its descendants. void synchronizeChildren() Override this method in subclass to hook in efficient internal data structure.
From class org.apache.xerces.dom.ChildNode Node cloneNode(boolean deep) Returns a duplicate of a given node. Node getNextSibling() The next child of this node's parent, or null if none Node getParentNode() Returns the parent node of this node Node getPreviousSibling() The previous child of this node's parent, or null if none
From class org.apache.xerces.dom.NodeImpl void addEventListener(String type, EventListener listener, boolean useCapture) Node appendChild(Node newChild) Adds a child node to the end of the list of children for this node. void changed() Denotes that this node has changed. int changes() Returns the number of changes to this node. Node cloneNode(boolean deep) Returns a duplicate of a given node. short compareDocumentPosition(Node other) Compares a node with this node with regard to their position in the document. short compareTreePosition(Node other) This method is deprecated. No replacement. boolean dispatchEvent(Event event) NamedNodeMap getAttributes() Return the collection of attributes associated with this node, or null if none. String getBaseURI() The absolute base URI of this node or null if undefined. NodeList getChildNodes() Obtain a NodeList enumerating all children of this node. Node getContainer() For non-child nodes, the node which "points" to this node. Object getFeature(String feature, String version) Node getFirstChild() The first child of this Node, or null if none. Node getLastChild() The first child of this Node, or null if none. int getLength() NodeList method: Count the immediate children of this node By default we do not have any children, ParentNode overrides this. String getLocalName() Introduced in DOM Level 2. String getNamespaceURI() Introduced in DOM Level 2. Node getNextSibling() The next child of this node's parent, or null if none abstract String getNodeName() the name of this node. int getNodeNumber() Returns the node number abstract short getNodeType() A short integer indicating what type of node this is. String getNodeValue() Returns the node value. Document getOwnerDocument() Find the Document that this Node belongs to (the document in whose context the Node was created). Node getParentNode() Obtain the DOM-tree parent of this node, or null if it is not currently active in the DOM tree (perhaps because it has just been created or removed). String getPrefix() Introduced in DOM Level 2. Node getPreviousSibling() The previous child of this node's parent, or null if none boolean getReadOnly() NON-DOM: Returns true if this node is read-only. String getTextContent() This attribute returns the text content of this node and its descendants. Object getUserData() NON-DOM: Returns the user data associated to this node. Object getUserData(String key) Retrieves the object associated to a key on a this node. Hashtable getUserDataRecord() boolean hasAttributes() Returns whether this node (if it is an element) has any attributes. boolean hasChildNodes() Test whether this node has any children. Node insertBefore(Node newChild, Node refChild) Move one or more node(s) to our list of children. boolean isDefaultNamespace(String namespaceURI) DOM Level 3: Experimental This method checks if the specified namespaceURI is the default namespace or not. boolean isEqualNode(Node arg) Tests whether two nodes are equal. boolean isSameNode(Node other) Returns whether this node is the same node as the given one. boolean isSupported(String feature, String version) Introduced in DOM Level 2. Node item(int index) NodeList method: Return the Nth immediate child of this node, or null if the index is out of bounds. String lookupNamespaceURI(String specifiedPrefix) DOM Level 3 - Experimental: Look up the namespace URI associated to the given prefix, starting from this node. String lookupPrefix(String namespaceURI) DOM Level 3 - Experimental: Look up the prefix associated to the given namespace URI, starting from this node. final void needsSyncChildren(boolean value) void normalize() Puts all Text nodes in the full depth of the sub-tree underneath this Node, including attribute nodes, into a "normal" form where only markup (e.g., tags, comments, processing instructions, CDATA sections, and entity references) separates Text nodes, i.e., there are no adjacent Text nodes. Node removeChild(Node oldChild) Remove a child from this Node. void removeEventListener(String type, EventListener listener, boolean useCapture) Node replaceChild(Node newChild, Node oldChild) Make newChild occupy the location that oldChild used to have. void setNodeValue(String x) Sets the node value. void setOwnerDocument(CoreDocumentImpl doc) NON-DOM set the ownerDocument of this node void setPrefix(String prefix) Introduced in DOM Level 2. void setReadOnly(boolean readOnly, boolean deep) NON-DOM: PR-DOM-Level-1-19980818 mentions readonly nodes in conjunction with Entities, but provides no API to support this. void setTextContent(String textContent) This attribute returns the text content of this node and its descendants. Object setUserData(String key, Object data, UserDataHandler handler) Associate an object to a key on this node. void setUserData(Object data) NON-DOM: As an alternative to subclassing the DOM, this implementation has been extended with the ability to attach an object to each node. void synchronizeData() Override this method in subclass to hook in efficient internal data structure. String toString() NON-DOM method for debugging convenience.
From class java.lang.Object Object clone() boolean equals(Object arg0) void finalize() final Class<?> getClass() int hashCode() final void notify() final void notifyAll() String toString() final void wait() final void wait(long arg0, int arg1) final void wait(long arg0)
From interface org.apache.xerces.dom.DeferredNode abstract int getNodeIndex() Returns the node index.
From interface org.w3c.dom.Entity abstract String getInputEncoding() abstract String getNotationName() abstract String getPublicId() abstract String getSystemId() abstract String getXmlEncoding() abstract String getXmlVersion()
From interface org.w3c.dom.Node abstract Node appendChild(Node arg0) abstract Node cloneNode(boolean arg0) abstract short compareDocumentPosition(Node arg0) abstract NamedNodeMap getAttributes() abstract String getBaseURI() abstract NodeList getChildNodes() abstract Object getFeature(String arg0, String arg1) abstract Node getFirstChild() abstract Node getLastChild() abstract String getLocalName() abstract String getNamespaceURI() abstract Node getNextSibling() abstract String getNodeName() abstract short getNodeType() abstract String getNodeValue() abstract Document getOwnerDocument() abstract Node getParentNode() abstract String getPrefix() abstract Node getPreviousSibling() abstract String getTextContent() abstract Object getUserData(String arg0) abstract boolean hasAttributes() abstract boolean hasChildNodes() abstract Node insertBefore(Node arg0, Node arg1) abstract boolean isDefaultNamespace(String arg0) abstract boolean isEqualNode(Node arg0) abstract boolean isSameNode(Node arg0) abstract boolean isSupported(String arg0, String arg1) abstract String lookupNamespaceURI(String arg0) abstract String lookupPrefix(String arg0) abstract void normalize() abstract Node removeChild(Node arg0) abstract Node replaceChild(Node arg0, Node arg1) abstract void setNodeValue(String arg0) abstract void setPrefix(String arg0) abstract void setTextContent(String arg0) abstract Object setUserData(String arg0, Object arg1, UserDataHandler arg2)
From interface org.w3c.dom.NodeList abstract int getLength() abstract Node item(int arg0)
From interface org.w3c.dom.events.EventTarget abstract void addEventListener(String arg0, EventListener arg1, boolean arg2) abstract boolean dispatchEvent(Event arg0) abstract void removeEventListener(String arg0, EventListener arg1, boolean arg2)