org.w3c.dom
Interface ProcessingInstruction

All Known Implementing Classes:
DTMNodeProxy

public interface ProcessingInstruction
extends Node

The ProcessingInstruction interface represents a "processing instruction", used in XML as a way to keep processor-specific information in the text of the document.

No lexical check is done on the content of a processing instruction and it is therefore possible to have the character sequence "?>" in the content, which is illegal a processing instruction per section 2.6 of [XML 1.0]. The presence of this character sequence must generate a fatal error during serialization.

See also the Document Object Model (DOM) Level 3 Core Specification.


Fields inherited from class org.w3c.dom.Node
ATTRIBUTE_NODE, CDATA_SECTION_NODE, COMMENT_NODE, DOCUMENT_FRAGMENT_NODE, DOCUMENT_NODE, DOCUMENT_POSITION_CONTAINED_BY, DOCUMENT_POSITION_CONTAINS, DOCUMENT_POSITION_DISCONNECTED, DOCUMENT_POSITION_FOLLOWING, DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC, DOCUMENT_POSITION_PRECEDING, DOCUMENT_TYPE_NODE, ELEMENT_NODE, ENTITY_NODE, ENTITY_REFERENCE_NODE, NOTATION_NODE, PROCESSING_INSTRUCTION_NODE, TEXT_NODE
 
Method Summary
 java.lang.String getData()
          The content of this processing instruction.
 java.lang.String getTarget()
          The target of this processing instruction.
 void setData(java.lang.String data)
          The content of this processing instruction.
 
Methods inherited from interface org.w3c.dom.Node
appendChild, cloneNode, compareDocumentPosition, getAttributes, getBaseURI, getChildNodes, getFeature, getFirstChild, getLastChild, getLocalName, getNamespaceURI, getNextSibling, getNodeName, getNodeType, getNodeValue, getOwnerDocument, getParentNode, getPrefix, getPreviousSibling, getTextContent, getUserData, hasAttributes, hasChildNodes, insertBefore, isDefaultNamespace, isEqualNode, isSameNode, isSupported, lookupNamespaceURI, lookupPrefix, normalize, removeChild, replaceChild, setNodeValue, setPrefix, setTextContent, setUserData
 

Method Detail

getTarget

public java.lang.String getTarget()
The target of this processing instruction. XML defines this as being the first token following the markup that begins the processing instruction.

getData

public java.lang.String getData()
The content of this processing instruction. This is from the first non white space character after the target to the character immediately preceding the ?>.

setData

public void setData(java.lang.String data)
             throws DOMException
The content of this processing instruction. This is from the first non white space character after the target to the character immediately preceding the ?>.
Throws:
DOMException - NO_MODIFICATION_ALLOWED_ERR: Raised when the node is readonly.


Copyright 2006 Apache XML Project. All Rights Reserved.