org.apache.xerces.dom
Class ProcessingInstructionImpl

java.lang.Object
  |
  +--org.apache.xerces.dom.NodeImpl
        |
        +--org.apache.xerces.dom.ProcessingInstructionImpl
Direct Known Subclasses:
DeferredProcessingInstructionImpl

public class ProcessingInstructionImpl
extends NodeImpl
implements ProcessingInstruction

Processing Instructions (PIs) permit documents to carry processor-specific information alongside their actual content. PIs are most common in XML, but they are supported in HTML as well.

Since:
PR-DOM-Level-1-19980818.
Version:
 
See Also:
Serialized Form

Fields inherited from class org.apache.xerces.dom.NodeImpl
ELEMENT_DEFINITION_NODE, fInternalSetNodeValue, MUTATION_AGGREGATE, MUTATION_ALL, MUTATION_LOCAL, MUTATION_NONE, MUTATIONEVENTS, name, nextSibling, ownerDocument, parentNode, previousSibling, readOnly, syncData, userData, value
 
Fields inherited from interface org.w3c.dom.Node
ATTRIBUTE_NODE, CDATA_SECTION_NODE, COMMENT_NODE, DOCUMENT_FRAGMENT_NODE, DOCUMENT_NODE, DOCUMENT_TYPE_NODE, ELEMENT_NODE, ENTITY_NODE, ENTITY_REFERENCE_NODE, NOTATION_NODE, PROCESSING_INSTRUCTION_NODE, TEXT_NODE
 
Constructor Summary
ProcessingInstructionImpl(DocumentImpl ownerDoc, java.lang.String target, java.lang.String data)
          Factory constructor.
 
Method Summary
 Node cloneNode(boolean deep)
          Clones this node.
 java.lang.String getData()
          A PI's data content tells the processor what we actually want it to do.
 short getNodeType()
          A short integer indicating what type of node this is.
 java.lang.String getTarget()
          A PI's "target" states what processor channel the PI's data should be directed to.
 void setData(java.lang.String data)
          Change the data content of this PI.
 
Methods inherited from class org.apache.xerces.dom.NodeImpl
addEventListener, appendChild, changed, dispatchEvent, finalize, getAttributes, getChildNodes, getFirstChild, getLastChild, getLength, getLocalName, getNamespaceURI, getNextSibling, getNodeName, getNodeValue, getOwnerDocument, getParentNode, getPrefix, getPreviousSibling, getReadOnly, getUserData, hasChildNodes, insertBefore, item, normalize, removeChild, removeEventListener, replaceChild, setNodeValue, setPrefix, setReadOnly, setUserData, supports, synchronizeData, toString
 
Methods inherited from class java.lang.Object
clone, equals, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Constructor Detail

ProcessingInstructionImpl

public ProcessingInstructionImpl(DocumentImpl ownerDoc,
                                 java.lang.String target,
                                 java.lang.String data)
Factory constructor.
Method Detail

getNodeType

public short getNodeType()
A short integer indicating what type of node this is. The named constants for this value are defined in the org.w3c.dom.Node interface.
Overrides:
getNodeType in class NodeImpl

cloneNode

public Node cloneNode(boolean deep)
Clones this node.
Overrides:
cloneNode in class NodeImpl
Tags copied from interface: Node
Parameters:
deep - If true , recursively clone the subtree under the specified node; if false , clone only the node itself (and its attributes, if it is an Element ).
Returns:
The duplicate node.

getTarget

public java.lang.String getTarget()
A PI's "target" states what processor channel the PI's data should be directed to. It is defined differently in HTML and XML.

In XML, a PI's "target" is the first (whitespace-delimited) token following the " In HTML, target is always null.

Note that getNodeName is aliased to getTarget.

Specified by:
getTarget in interface ProcessingInstruction

getData

public java.lang.String getData()
A PI's data content tells the processor what we actually want it to do. It is defined slightly differently in HTML and XML.

In XML, the data begins with the non-whitespace character immediately after the target -- @see getTarget().

In HTML, the data begins with the character immediately after the "<?" token that begins the PI.

Note that getNodeValue is aliased to getData

Specified by:
getData in interface ProcessingInstruction
Tags copied from interface: ProcessingInstruction
Throws:
DOMException - NO_MODIFICATION_ALLOWED_ERR: Raised when the node is readonly.

setData

public void setData(java.lang.String data)
Change the data content of this PI. Note that setData is aliased to setNodeValue.
Specified by:
setData in interface ProcessingInstruction
Throws:
DOMException(NO_MODIFICATION_ALLOWED_ERR) - if node is read-only.
See Also:
getData().


Copyright © 1999 Apache XML Project. All Rights Reserved.