com.hp.hpl.sparta

类 Node

java.lang.Object

com.hp.hpl.sparta.Node

直接已知子类:

Document, Element, Text

public abstract class Node
extends Object

An XML node.

Copyright (C) 2002 Hewlett-Packard Company. This file is part of Sparta, an XML Parser, DOM, and XPath library. This library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 2.1 of the License, or (at your option) any later version. This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

版本:

$Date: 2003/07/28 04:30:56 $ $Revision: 1.10 $

作者:

Eamonn O'Brien-Strain

另请参阅:

GNU Lesser General Public License

构造器概要

构造器

构造器和说明
Node()

方法概要

方法

限定符和类型	方法和说明
abstract Object	clone()
protected abstract int	computeHashCode() Called whenever cached version of hashCode needs to be regenerated.
Object	getAnnotation()
Node	getNextSibling() Return the next node in the parent's list of children, or null if no such node.
Document	getOwnerDocument() The document that contains this node.
Element	getParentNode() The element that contains this node or null if this is a Document or the root element of a document.
Node	getPreviousSibling() Return the previous node in the parent's list of children, or null if no such node.
int	hashCode()
protected static void	htmlEncode(Writer writer, String string) Quote special XML characters '<', '>', '&', '"' if necessary, and write to character stream.
void	setAnnotation(Object annotation) Use by client to attach arbitrary data to DOM document.
String	toString() Hierarchically concatenated text nodes.
String	toXml() XML representation of this node.
abstract Element	xpathSelectElement(String xpath) Select the first element that matches the relative XPath expression with respect to this node, or null if there is no match.
abstract Enumeration	xpathSelectElements(String xpath) Select all the elements that match the relative XPath expression with respect to this node.
abstract String	xpathSelectString(String xpath) Select the first element that matches the relative XPath expression with respect to this node, or null if there is no match.
abstract Enumeration	xpathSelectStrings(String xpath) Select all the strings that match the relative XPath expression with respect to this node.
boolean	xpathSetStrings(String xpath, String value) For an xpath expression of the form "xpathPrefix/@attrName" set the attribute "attrName" to attrValue on all elements that match "XpathPrefix" which is an arbitrary xpath expression matching elements, or for an xpath expression of the form "xpathPrefixe/text()" set the text of all matching text nodes.

从类继承的方法 java.lang.Object

equals, finalize, getClass, notify, notifyAll, wait, wait, wait

构造器详细资料

Node

public Node()

方法详细资料

getOwnerDocument

public Document getOwnerDocument()

The document that contains this node. null IFF this is a Document

getParentNode

public Element getParentNode()

The element that contains this node or null if this is a Document or the root element of a document.

getPreviousSibling

public Node getPreviousSibling()

Return the previous node in the parent's list of children, or null if no such node.

getNextSibling

public Node getNextSibling()

Return the next node in the parent's list of children, or null if no such node.

getAnnotation

public Object getAnnotation()

另请参阅:

setAnnotation(java.lang.Object)

setAnnotation

public void setAnnotation(Object annotation)

Use by client to attach arbitrary data to DOM document. Does not update indices and other observers.

toXml

public String toXml()
             throws IOException

XML representation of this node.

抛出:

IOException

xpathSetStrings

public boolean xpathSetStrings(String xpath,
                      String value)
                        throws ParseException

For an xpath expression of the form "xpathPrefix/@attrName" set the attribute "attrName" to attrValue on all elements that match "XpathPrefix" which is an arbitrary xpath expression matching elements, or for an xpath expression of the form "xpathPrefixe/text()" set the text of all matching text nodes. (The following doc is used in the examples below.)

• node.xpathSetStrings( "xpathPrefix/@attrName", value ) is equivalent to

     foreach element in node.xpathSelectElement(xpathPrefix):
     element.setAttribute( "attrName", value );
     

• doc.xpathSetStrings( "/a/b/@x", "rrr" ) will result in
  (Every matching child gets its attribute set.)
• To set only the first child you would have to do doc.xpathSetStrings( "/a/b[@x]/@x", "rrr" ) which would result in:

• Not matching calls silently do nothing.
• doc.xpathSetStrings("/a/b/text()", "TTT" ) will result in:

  
     
     TTT
     TTT
     TTT
     
  
     

• doc.xpathSetStrings("/a/text()", "TTT" ) will result in:

  
     TTT
  
     

返回:

true iff anything changed

抛出:

ParseException

xpathSelectElements

public abstract Enumeration xpathSelectElements(String xpath)
                                         throws ParseException

Select all the elements that match the relative XPath expression with respect to this node.

抛出:

ParseException

xpathSelectStrings

public abstract Enumeration xpathSelectStrings(String xpath)
                                        throws ParseException

Select all the strings that match the relative XPath expression with respect to this node.

抛出:

ParseException

xpathSelectElement

public abstract Element xpathSelectElement(String xpath)
                                    throws ParseException

Select the first element that matches the relative XPath expression with respect to this node, or null if there is no match.

抛出:

ParseException

xpathSelectString

public abstract String xpathSelectString(String xpath)
                                  throws ParseException

Select the first element that matches the relative XPath expression with respect to this node, or null if there is no match.

抛出:

ParseException

clone

public abstract Object clone()

覆盖:

clone 在类中 Object

toString

public String toString()

Hierarchically concatenated text nodes.

覆盖:

toString 在类中 Object

htmlEncode

protected static void htmlEncode(Writer writer,
              String string)
                          throws IOException

Quote special XML characters '<', '>', '&', '"' if necessary, and write to character stream. We write to a character stream rather than simply returning a stream to avoid creating unneccessary objects.

抛出:

IOException

computeHashCode

protected abstract int computeHashCode()

Called whenever cached version of hashCode needs to be regenerated.

hashCode

public int hashCode()

覆盖:

hashCode 在类中 Object