oracle.xml.parser.v2

Class XMLDeclPI

java.lang.Object

oracle.xml.parser.v2.XMLNode

oracle.xml.parser.v2.XMLPI

oracle.xml.parser.v2.XMLDeclPI

All Implemented Interfaces:

java.io.Externalizable, java.io.Serializable, java.lang.Cloneable, CharacterData, EventTarget, Node, ProcessingInstruction, CharacterDataEditVAL, NodeEditVAL

public class XMLDeclPI
extends XMLPI
implements java.io.Externalizable

This class implements the XML Decl Processing Instruction.

See Also:

"ProcessingInstruction", Serialized Form

Field Summary

Fields inherited from class oracle.xml.parser.v2.XMLNode

ATTRDECL, Auto_Events, capturing, DOMAttrModified, DOMCharacterDataModified, DOMNodeInserted, DOMNodeInsertedIntoDocument, DOMNodeRemoved, DOMNodeRemovedFromDocument, DOMSubtreeModified, ELEMENTDECL, KEPT_NODE, NAMESPACE_NODE, noncapturing, RANGE_DELETE_EVENT, RANGE_DELETETEXT_EVENT, RANGE_INSERT_EVENT, RANGE_INSERTTEXT_EVENT, RANGE_REPLACE_EVENT, RANGE_SETTEXT_EVENT, TRAVERSAL_DELETE_EVENT, TRAVERSAL_REPLACE_EVENT, XMLDECL_NODE

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

Fields inherited from interface org.w3c.dom.validation.NodeEditVAL

VAL_FALSE, VAL_INCOMPLETE, VAL_NS_WF, VAL_SCHEMA, VAL_TRUE, VAL_UNKNOWN, VAL_WF

Constructor Summary

Constructors

Constructor and Description
XMLDeclPI() Construct a default XMLDecl
XMLDeclPI(java.lang.String version, java.lang.String encoding, java.lang.String standalone, boolean textDecl) Construct a XML Decl using the parameters

Method Summary

Modifier and Type	Method and Description
void	appendData(java.lang.String arg) Append the string to the end of the character data of the node.
short	canAppendData(java.lang.String arg) Determines if data can be appended.
short	canDeleteData(int offset, int count) Determines if data can be deleted.
short	canInsertData(int offset, java.lang.String arg) Determines if data can be inserted.
short	canReplaceData(int offset, int count, java.lang.String arg) Determines if data can be replaced.
short	canSetData(java.lang.String arg) Determines if data can be set.
void	deleteData(int offset, int count) Remove a range of characters from the node.
java.lang.String	getData() Returns the fully constructed string 'version=1.0 ....'
java.lang.String	getEncoding() Retrieves the character encoding information.
int	getLength() The number of characters that are available through data and the substringData method below.
java.lang.String	getNodeValue() Gets the value of this node
java.lang.String	getStandalone() Retrieves the standalone information.
java.lang.String	getVersion() Retrieves the version information.
void	insertData(int offset, java.lang.String arg) Insert a string at the specified character offset.
short	isWhitespaceOnly() Determines if data is only whitespace.
short	nodeValidity(boolean deep, short wFValidityCheckLevel) Determines if the node is valid relative to the validation type specified in valType.
void	replaceData(int offset, int count, java.lang.String arg) Replace the characters starting at the specified character offset with the specified string.
void	setData(java.lang.String data) Set the character data of this node
void	setEncoding(java.lang.String encoding) Sets the character encoding for output.
void	setNodeValue(java.lang.String nodeValue) The value of this node, depending on its type overrides method in XMLNode.
boolean	setStandalone(java.lang.String value) Sets the standalone information stored in the <?
void	setVersion(java.lang.String version) Sets the version number stored in the <?
java.lang.String	substringData(int offset, int count) Extracts a range of data from the node.

Methods inherited from class oracle.xml.parser.v2.XMLPI

addText, getNodeName, getNodeType, getTarget, reportSAXEvents

Methods inherited from class oracle.xml.parser.v2.XMLNode

addEventListener, addText, appendChild, canAppendChild, canInsertBefore, canRemoveChild, canReplaceChild, cloneNode, dispatchEvent, equals, getAttributes, getChildNodes, getColumnNumber, getDebugMode, getDefaultValue, getEnumeratedValues, getFirstChild, getFirstChildAsOffset, getLastChild, getLineNumber, getLocalName, getNamespaceURI, getNextSibling, getNextSiblingAsOffset, getNodeValueAsBinaryStream, getNodeValueAsBinaryStream, getNodeValueAsCharacterStream, getNodeValueAsCharacterStream, getOwnerDocument, getParentNode, getPrefix, getPreviousSibling, getPrimitiveTypeId, getProperty, getSystemId, getText, getXMLError, hasAttributes, hasChildNodes, hashCode, insertBefore, isDocumentFlag, isNodeFlag, isSupported, nodeValidity, normalize, print, print, print, print, readExternal, removeChild, removeEventListener, replaceChild, resetNodeFlag, selectNodes, selectNodes, selectSingleNode, selectSingleNode, setDebugInfo, setNodeFlag, setNodeFlag, setNodeFlag, setNodeValueAsBinaryStream, setNodeValueAsBinaryStream, setNodeValueAsCharacterStream, setNodeValueAsCharacterStream, setPrefix, setProperty, transformNode, valueOf, valueOf, writeExternal, xdbGetNodeId

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface java.io.Externalizable

readExternal, writeExternal

Methods inherited from interface org.w3c.dom.ProcessingInstruction

setData

Methods inherited from interface org.w3c.dom.Node

appendChild, cloneNode, getAttributes, getChildNodes, getFirstChild, getLastChild, getLocalName, getNamespaceURI, getNextSibling, getOwnerDocument, getParentNode, getPrefix, getPreviousSibling, hasAttributes, hasChildNodes, insertBefore, isSupported, normalize, removeChild, replaceChild, setNodeValue, setPrefix

Methods inherited from interface org.w3c.dom.validation.NodeEditVAL

canAppendChild, canInsertBefore, canRemoveChild, canReplaceChild, getDefaultValue, getEnumeratedValues, nodeValidity

Constructor Detail

XMLDeclPI

public XMLDeclPI()

Construct a default XMLDecl

XMLDeclPI

public XMLDeclPI(java.lang.String version,
                 java.lang.String encoding,
                 java.lang.String standalone,
                 boolean textDecl)

Construct a XML Decl using the parameters

Parameters:

version - - version of the XML

encoding - - encoding used in the xml declaration

standalone - - standalone value used in the declaration

textDecl - - true => TextDecl, false => XML Decl

Method Detail

getData

public java.lang.String getData()
                         throws DOMException

Returns the fully constructed string 'version=1.0 ....'

Specified by:

getData in interface CharacterData

Specified by:

getData in interface ProcessingInstruction

Overrides:

getData in class XMLPI

Returns:

the nodevalue

Throws:

DOMException - DOMSTRING_SIZE_ERR: Raised when it would return more characters than fit in a DOMString variable on the implementation platform.

getNodeValue

public java.lang.String getNodeValue()
                              throws DOMException

Gets the value of this node

Specified by:

getNodeValue in interface Node

Returns:

the nodevalue

Throws:

DOMException - DOMSTRING_SIZE_ERR: Raised when it would return more characters than fit in a DOMString variable on the implementation

getVersion

public final java.lang.String getVersion()

Retrieves the version information.

Returns:

the version number stored in the <?xml ...?> tag.

setVersion

public final void setVersion(java.lang.String version)

Sets the version number stored in the <?xml ...?> tag.

Parameters:

version - The version information to set.

getEncoding

public final java.lang.String getEncoding()

Retrieves the character encoding information.

Returns:

the encoding information stored in the <?xml ...?> tag or the user-defined output encoding if it has been more recently set.

setEncoding

public final void setEncoding(java.lang.String encoding)

Sets the character encoding for output. Eventually it sets the ENCODING stored in the <?xml ...?> tag, but not until the document is saved. You should not call this method until the Document has been loaded.

Parameters:

encoding - The character encoding to set

getStandalone

public final java.lang.String getStandalone()

Retrieves the standalone information.

Returns:

the standalone attribute stored in the <?xml ...?> tag.

setStandalone

public final boolean setStandalone(java.lang.String value)

Sets the standalone information stored in the <?xml ...?> tag.

Parameters:

value - The attribute value ('yes' or 'no').

setData

public void setData(java.lang.String data)
             throws DOMException

Set the character data of this node

Specified by:

setData in interface CharacterData

Parameters:

data - the character data to be set

Throws:

DOMException - NO_MODIFICATION_ALLOWED_ERR: Raised when the node is readonly.

DOMException - DOMSTRING_SIZE_ERR: Raised when it would return more characters than fit in a DOMString variable on the implementation platform.

setNodeValue

public void setNodeValue(java.lang.String nodeValue)
                  throws DOMException

The value of this node, depending on its type overrides method in XMLNode.

Specified by:

setNodeValue in interface Node

Overrides:

setNodeValue in class XMLNode

Throws:

DOMException - NO_MODIFICATION_ALLOWED_ERR: Raised when the node is readonly.

DOMException - DOMSTRING_SIZE_ERR: Raised when it would return more characters than fit in a DOMString variable on the implementation platform.

getLength

public int getLength()

The number of characters that are available through data and the substringData method below. This may have the value zero, i.e., CharacterData nodes may be empty.

Specified by:

getLength in interface CharacterData

substringData

public java.lang.String substringData(int offset,
                                      int count)
                               throws DOMException

Extracts a range of data from the node.

Specified by:

substringData in interface CharacterData

Parameters:

offset - Start offset of substring to extract.

count - The number of characters to extract.

Returns:

The specified substring. If the sum of offset and count exceeds the length, then all characters to the end of the data are returned.

Throws:

DOMException - INDEX_SIZE_ERR: Raised if the specified offset is negative or greater than the number of characters in data, or if the specified count is negative.
DOMSTRING_SIZE_ERR: Raised if the specified range of text does not fit into a DOMString.

appendData

public void appendData(java.lang.String arg)
                throws DOMException

Append the string to the end of the character data of the node. Upon success, data provides access to the concatenation of data and the DOMString specified.

Specified by:

appendData in interface CharacterData

Parameters:

arg - The DOMString to append.

Throws:

DOMException - NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly.

insertData

public void insertData(int offset,
                       java.lang.String arg)
                throws DOMException

Insert a string at the specified character offset.

Specified by:

insertData in interface CharacterData

Parameters:

offset - The character offset at which to insert.

arg - The DOMString to insert.

Throws:

DOMException - INDEX_SIZE_ERR: Raised if the specified offset is negative or greater than the number of characters in data.
NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly.

deleteData

public void deleteData(int offset,
                       int count)
                throws DOMException

Remove a range of characters from the node. Upon success, data and length reflect the change.

Specified by:

deleteData in interface CharacterData

Parameters:

offset - The offset from which to remove characters.

count - The number of characters to delete. If the sum of offset and count exceeds length then all characters from offset to the end of the data are deleted.

Throws:

DOMException - INDEX_SIZE_ERR: Raised if the specified offset is negative or greater than the number of characters in data, or if the specified count is negative.
NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly.

replaceData

public void replaceData(int offset,
                        int count,
                        java.lang.String arg)
                 throws DOMException

Replace the characters starting at the specified character offset with the specified string.

Specified by:

replaceData in interface CharacterData

Parameters:

offset - The offset from which to start replacing.

count - The number of characters to replace. If the sum of offset and count exceeds length , then all characters to the end of the data are replaced (i.e., the effect is the same as a remove method call with the same range, followed by an append method invocation).

arg - The DOMString with which the range must be replaced.

Throws:

DOMException - INDEX_SIZE_ERR: Raised if the specified offset is negative or greater than the number of characters in data, or if the specified count is negative.
NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly.

isWhitespaceOnly

public short isWhitespaceOnly()

Determines if data is only whitespace.

Specified by:

isWhitespaceOnly in interface CharacterDataEditVAL

Returns:

A validation state constant.

canSetData

public short canSetData(java.lang.String arg)

Determines if data can be set.

Specified by:

canSetData in interface CharacterDataEditVAL

Parameters:

arg - Argument to be set.

Returns:

A validation state constant.

canAppendData

public short canAppendData(java.lang.String arg)

Determines if data can be appended.

Specified by:

canAppendData in interface CharacterDataEditVAL

Parameters:

arg - Data to be appended.

Returns:

A validation state constant.

canReplaceData

public short canReplaceData(int offset,
                            int count,
                            java.lang.String arg)
                     throws DOMException

Determines if data can be replaced.

Specified by:

canReplaceData in interface CharacterDataEditVAL

Parameters:

offset - Offset.

count - Replacement.

arg - Argument to be set.

Returns:

A validation state constant.

Throws:

DOMException - INDEX_SIZE_ERR: Raised if the specified offset is negative or greater than the number of 16-bit units in data, or if the specified count is negative.

canInsertData

public short canInsertData(int offset,
                           java.lang.String arg)
                    throws DOMException

Determines if data can be inserted.

Specified by:

canInsertData in interface CharacterDataEditVAL

Parameters:

offset - Offset.

arg - Argument to be set.

Returns:

A validation state constant.

Throws:

DOMException - INDEX_SIZE_ERR: Raised if the specified offset is negative or greater than the number of 16-bit units in data.

canDeleteData

public short canDeleteData(int offset,
                           int count)
                    throws DOMException

Determines if data can be deleted.

Specified by:

canDeleteData in interface CharacterDataEditVAL

Parameters:

offset - Offset.

count - Number of 16-bit units to delete.

Returns:

A validation state constant.

Throws:

DOMException - INDEX_SIZE_ERR: Raised if the specified offset is negative or greater than the number of 16-bit units in data, or if the specified count is negative.

nodeValidity

public short nodeValidity(boolean deep,
                          short wFValidityCheckLevel)

Determines if the node is valid relative to the validation type specified in valType. This operation doesn't normalize before checking if it is valid. To do so, one would need to explicitly call a normalize method. The difference between this method and the validateDocument method on the DocumentVAL interface is that validateDocument only checks to determine whether the entire document is valid.

Parameters:

wFValidityCheckLevel - Flag to tell at what level validity and well-formedness checking is done.

Returns:

A validation state constant.