JavaTM Platform
Standard Ed. 6

接口 org.w3c.dom.Node
的使用

使用 Node 的软件包
javax.imageio.metadata 用于处理读写元数据的 Java Image I/O API 的包。 
javax.xml.bind 为包含解组、编组和验证功能的客户端应用程序提供运行时绑定框架。 
javax.xml.bind.helpers 仅由 JAXB 提供者用于: 提供某些 javax.xml.bind 接口的部分默认实现。 
javax.xml.crypto.dom javax.xml.crypto 包的特定于 DOM 的类。 
javax.xml.crypto.dsig.dom javax.xml.crypto.dsig 包特定于 DOM 的类。 
javax.xml.soap 提供用于创建和构建 SOAP 消息的 API。 
javax.xml.transform.dom 此包实现特定于 DOM 的转换 API。 
org.w3c.dom 为文档对象模型 (DOM) 提供接口,该模型是 Java API for XML Processing 的组件 API。 
org.w3c.dom.events   
org.w3c.dom.ls   
 

javax.imageio.metadataNode 的使用
 

实现 Nodejavax.imageio.metadata 中的类
 class IIOMetadataNode
          表示元数据树中节点的类,该类实现 org.w3c.dom.Element 接口,还允许通过 getUserObjectsetUserObject 方法存储非文本对象。
 

声明为 Nodejavax.imageio.metadata 中的字段
protected  Node IIOInvalidTreeException.offendingNode
          导致解析错误的 Node,或 null
 

返回 Nodejavax.imageio.metadata 中的方法
 Node IIOMetadataNode.appendChild(Node newChild)
          将节点 newChild 添加到此节点子节点列表的末尾。
 Node IIOMetadataNode.cloneNode(boolean deep)
          返回此节点的副本。
abstract  Node IIOMetadata.getAsTree(String formatName)
          返回 XML DOM Node 对象,该对象表示此对象所包含的元数据树的根(根据给定元数据格式定义的约定)。
 Node IIOMetadataNode.getFirstChild()
          此节点的第一个子节点;如果该节点没有子节点,则返回 null
 Node IIOMetadataNode.getLastChild()
          返回此节点的最后一个子节点;如果该节点没有子节点,则返回 null
 Node IIOMetadataNode.getNextSibling()
          返回此节点的下一个兄弟节点;如果该节点没有下一个兄弟节点,则返回 null
 Node IIOInvalidTreeException.getOffendingNode()
          返回导致解析错误的 Node
 Node IIOMetadataNode.getParentNode()
          返回此节点的父节点。
 Node IIOMetadataNode.getPreviousSibling()
          返回此节点的上一个兄弟节点;如果该节点没有上一个兄弟节点,则返回 null
 Node IIOMetadataNode.insertBefore(Node newChild, Node refChild)
          在现有子节点 refChild 之前插入节点 newChild
 Node IIOMetadataNode.item(int index)
           
 Node IIOMetadataNode.removeChild(Node oldChild)
          从子节点列表中移除 oldChild 所指示的子节点,并将其返回。
 Node IIOMetadataNode.replaceChild(Node newChild, Node oldChild)
          将子节点 oldChild 替换为子节点列表中的 newChild,并返回 oldChild 节点。
 

参数类型为 Nodejavax.imageio.metadata 中的方法
 Node IIOMetadataNode.appendChild(Node newChild)
          将节点 newChild 添加到此节点子节点列表的末尾。
 short IIOMetadataNode.compareDocumentPosition(Node other)
           
 Node IIOMetadataNode.insertBefore(Node newChild, Node refChild)
          在现有子节点 refChild 之前插入节点 newChild
 boolean IIOMetadataNode.isEqualNode(Node node)
           
 boolean IIOMetadataNode.isSameNode(Node node)
           
abstract  void IIOMetadata.mergeTree(String formatName, Node root)
          根据 XML DOM Node 树(其语法由给定元数据格式定义)改变此 IIOMetadata 对象的内部状态。
 Node IIOMetadataNode.removeChild(Node oldChild)
          从子节点列表中移除 oldChild 所指示的子节点,并将其返回。
 Node IIOMetadataNode.replaceChild(Node newChild, Node oldChild)
          将子节点 oldChild 替换为子节点列表中的 newChild,并返回 oldChild 节点。
 void IIOMetadata.setFromTree(String formatName, Node root)
          根据 XML DOM Node 的树(其语法由给定元数据格式定义)设置此 IIOMetadata 对象的内部状态。
 

参数类型为 Nodejavax.imageio.metadata 中的构造方法
IIOInvalidTreeException(String message, Node offendingNode)
          构造一个 IIOInvalidTreeException,使其具有消息字符串和对导致解析错误的 Node 的引用。
IIOInvalidTreeException(String message, Throwable cause, Node offendingNode)
          构造一个 IIOInvalidTreeException,使其具有消息字符串、对导致此异常的异常的引用和导致解析错误的 Node 的引用。
 

javax.xml.bindNode 的使用
 

返回 Nodejavax.xml.bind 中的方法
 Node ValidationEventLocator.getNode()
          返回对 DOM Node 的引用(如果可用)。
 Node Marshaller.getNode(Object contentTree)
          获取内容树的 DOM 树视图(可选)。
 

返回变量类型为 Node 的类型的 javax.xml.bind 中的方法
 Binder<Node> JAXBContext.createBinder()
          为 W3C DOM 创建一个 Binder
 

参数类型为 Nodejavax.xml.bind 中的方法
 void Marshaller.marshal(Object jaxbElement, Node node)
          将以 jaxbElement 为根的内容树编组到 DOM 树中。
 Object Unmarshaller.unmarshal(Node node)
          从指定的 DOM 树解组全局 XML 数据并返回得到的内容树。
<T> JAXBElement<T>
Unmarshaller.unmarshal(Node node, Class<T> declaredType)
          通过 JAXB 映射的 declaredType 解组 XML 数据并返回得到的内容树。
 

javax.xml.bind.helpersNode 的使用
 

返回 Nodejavax.xml.bind.helpers 中的方法
 Node ValidationEventLocatorImpl.getNode()
           
 Node AbstractMarshallerImpl.getNode(Object obj)
          默认情况下,getNode 方法不受支持并抛出 UnsupportedOperationException
 

参数类型为 Nodejavax.xml.bind.helpers 中的方法
 void AbstractMarshallerImpl.marshal(Object obj, Node node)
           
 void ValidationEventLocatorImpl.setNode(Node _node)
          在此事件定位符上设置 Node 字段。
<T> JAXBElement<T>
AbstractUnmarshallerImpl.unmarshal(Node node, Class<T> expectedType)
           
 

参数类型为 Nodejavax.xml.bind.helpers 中的构造方法
ValidationEventLocatorImpl(Node _node)
          构造一个指向 DOM Node 的对象。
 

javax.xml.crypto.domNode 的使用
 

返回 Nodejavax.xml.crypto.dom 中的方法
 Node DOMURIReference.getHere()
          返回当前位置的节点。
 Node DOMStructure.getNode()
          返回包含在此 DOMStructure 中的节点。
 

参数类型为 Nodejavax.xml.crypto.dom 中的构造方法
DOMStructure(Node node)
          创建包含指定节点的 DOMStructure
 

javax.xml.crypto.dsig.domNode 的使用
 

返回 Nodejavax.xml.crypto.dsig.dom 中的方法
 Node DOMSignContext.getNextSibling()
          返回 nextSibling 节点。
 Node DOMValidateContext.getNode()
          返回节点。
 Node DOMSignContext.getParent()
          返回父节点。
 

参数类型为 Nodejavax.xml.crypto.dsig.dom 中的方法
 void DOMSignContext.setNextSibling(Node nextSibling)
          设置下一个兄弟节点。
 void DOMValidateContext.setNode(Node node)
          设置节点。
 void DOMSignContext.setParent(Node parent)
          设置父节点。
 

参数类型为 Nodejavax.xml.crypto.dsig.dom 中的构造方法
DOMSignContext(Key signingKey, Node parent)
          创建带有指定签名密钥和父节点的 DOMSignContext
DOMSignContext(Key signingKey, Node parent, Node nextSibling)
          创建带有指定的签名密钥、父节点和下一个兄弟节点的 DOMSignContext
DOMSignContext(KeySelector ks, Node parent)
          创建带有指定密钥选择器和父节点的 DOMSignContext
DOMSignContext(KeySelector ks, Node parent, Node nextSibling)
          创建带有指定密钥选择器、父节点和下一个兄弟节点的 DOMSignContext
DOMValidateContext(Key validatingKey, Node node)
          创建包含指定密钥和节点的 DOMValidateContext
DOMValidateContext(KeySelector ks, Node node)
          创建包含指定密钥选择器和节点的 DOMValidateContext
 

javax.xml.soapNode 的使用
 

javax.xml.soapNode 的子接口
 interface Detail
          DetailEntry 对象的容器。
 interface DetailEntry
          Detail 对象的内容,给出 SOAPFault 对象的详细信息。
 interface Node
          XML 文档中节点(元素)的表示形式。
 interface SOAPBody
          表示 SOAP 消息中 SOAP 正文元素内容的对象。
 interface SOAPBodyElement
          表示 SOAPBody 对象中内容的 SOAPBodyElement 对象。
 interface SOAPElement
          表示 SOAP 规范允许使用但未特别规定的 SOAP 消息元素的对象。
 interface SOAPEnvelope
          SOAPPart 对象的 SOAPHeader 和 SOAPBody 部分的容器。
 interface SOAPFault
          SOAPBody 对象中的元素,包含错误和/或状态信息。
 interface SOAPFaultElement
          SOAPFault 对象内容的表示形式。
 interface SOAPHeader
          SOAP 头元素的表示形式。
 interface SOAPHeaderElement
          表示 SOAP 信封 SOAP 头部分的内容的对象。
 

实现 Nodejavax.xml.soap 中的类
 class SOAPPart
          SOAPMessage 对象中特定于 SOAP 部分的容器。
 

javax.xml.transform.domNode 的使用
 

返回 Nodejavax.xml.transform.dom 中的方法
 Node DOMResult.getNextSibling()
          获取将要插入的结果节点之后的子节点。
 Node DOMResult.getNode()
          获取将包含结果 DOM 树的节点。
 Node DOMSource.getNode()
          获取表示 Source DOM 树的节点。
 Node DOMLocator.getOriginatingNode()
          返回事件发生的节点位置。
 

参数类型为 Nodejavax.xml.transform.dom 中的方法
 void DOMResult.setNextSibling(Node nextSibling)
          设置将要插入的结果节点之后的子节点。
 void DOMResult.setNode(Node node)
          设置将包含结果 DOM 树的节点。
 void DOMSource.setNode(Node node)
          设置将表示 Source DOM 树的节点。
 

参数类型为 Nodejavax.xml.transform.dom 中的构造方法
DOMResult(Node node)
          使用 DOM 节点创建新输出目标。
DOMResult(Node node, Node nextSibling)
          使用 DOM 节点创建新输出目标,此目标指定了应该插入的结果节点之后的子节点。
DOMResult(Node node, Node nextSibling, String systemId)
          使用 DOM 节点创建新输出目标,此目标指定了子节点,其中结果节点为指定 System ID 且应该插入到该子节点之前。
DOMResult(Node node, String systemId)
          使用 DOM 节点创建带有指定 System ID 的新输出目标。
DOMSource(Node n)
          创建带有 DOM 节点的新输入源。
DOMSource(Node node, String systemID)
          创建带有 DOM 节点的新输入源,系统 ID 也作为基本 URI 被传入。
 

org.w3c.domNode 的使用
 

org.w3c.domNode 的子接口
 interface Attr
          Attr 接口表示 Element 对象中的属性。
 interface CDATASection
          CDATA 节用于转义文本块,该文本块包含的字符如果不转义则会被视为标记。
 interface CharacterData
          CharacterData 接口使用属性集合和用于访问 DOM 中字符数据的方法扩展节点。
 interface Comment
          此接口继承自 CharacterData 表示注释的内容,即起始 '<!--' 和结束 '-->' 之间的所有字符。
 interface Document
          Document 接口表示整个 HTML 或 XML 文档。
 interface DocumentFragment
          DocumentFragment 是“轻量级”或“最小”Document 对象。
 interface DocumentType
          每个 Document 都有 doctype 属性,该属性的值可以为 null,也可以为 DocumentType 对象。
 interface Element
          Element 接口表示 HTML 或 XML 文档中的一个元素。
 interface Entity
          此接口表示在 XML 文档中解析和未解析的已知实体。
 interface EntityReference
          EntityReference 节点可以用来在树中表示实体引用。
 interface Notation
          此接口表示在 DTD 中声明的表示法。
 interface ProcessingInstruction
          ProcessingInstruction 接口表示“处理指令”,该指令作为一种在文档的文本中保持特定于处理器的信息的方法在 XML 中使用。
 interface Text
          该 Text 接口继承自 CharacterData,并且表示 ElementAttr 的文本内容(在 XML 中称为字符数据)。
 

返回 Nodeorg.w3c.dom 中的方法
 Node Document.adoptNode(Node source)
          试图把另一文档中的节点采用到此文档。
 Node Node.appendChild(Node newChild)
          将节点 newChild 添加到此节点的子节点列表的末尾。
 Node Node.cloneNode(boolean deep)
          返回此节点的副本,即允当节点的一般复制构造方法。
 Node Node.getFirstChild()
          此节点的第一个子节点。
 Node Node.getLastChild()
          此节点的最后一个节点。
 Node NamedNodeMap.getNamedItem(String name)
          检索通过名称指定的节点。
 Node NamedNodeMap.getNamedItemNS(String namespaceURI, String localName)
          检索通过本地名称和名称空间 URI 指定的节点。
 Node Node.getNextSibling()
          直接在此节点之后的节点。
 Node Node.getParentNode()
          此节点的父节点。
 Node Node.getPreviousSibling()
          直接在此节点之前的节点。
 Node DOMLocator.getRelatedNode()
          此定位器指向的节点;如果没有可用的节点,则为 null
 Node Document.importNode(Node importedNode, boolean deep)
          从另一文档向此文档导入节点,而不改变或移除原始文档中的源节点;此方法创建源节点的一个新副本。
 Node Node.insertBefore(Node newChild, Node refChild)
          在现有子节点 refChild 之前插入节点 newChild
 Node NamedNodeMap.item(int index)
          返回映射中第 index 个项。
 Node NodeList.item(int index)
          返回集合中的第 index 个项。
 Node Node.removeChild(Node oldChild)
          从子节点列表中移除 oldChild 所指示的子节点,并将其返回。
 Node NamedNodeMap.removeNamedItem(String name)
          移除通过名称指定的节点。
 Node NamedNodeMap.removeNamedItemNS(String namespaceURI, String localName)
          移除通过本地名称和名称空间 URI 指定的节点。
 Node Document.renameNode(Node n, String namespaceURI, String qualifiedName)
          重命名 ELEMENT_NODEATTRIBUTE_NODE 类型的现有节点。
 Node Node.replaceChild(Node newChild, Node oldChild)
          将子节点列表中的子节点 oldChild 替换为 newChild,并返回 oldChild 节点。
 Node NamedNodeMap.setNamedItem(Node arg)
          使用 nodeName 属性添加节点。
 Node NamedNodeMap.setNamedItemNS(Node arg)
          使用其 namespaceURIlocalName 添加节点。
 

参数类型为 Nodeorg.w3c.dom 中的方法
 Node Document.adoptNode(Node source)
          试图把另一文档中的节点采用到此文档。
 Node Node.appendChild(Node newChild)
          将节点 newChild 添加到此节点的子节点列表的末尾。
 short Node.compareDocumentPosition(Node other)
          就节点在文档中的位置并按照文档的顺序,比较引用节点(即在其上调用此方法的节点)与作为参数传递的节点。
 void UserDataHandler.handle(short operation, String key, Object data, Node src, Node dst)
          每当导入或克隆为其注册此处理程序的节点时,调用此方法。
 Node Document.importNode(Node importedNode, boolean deep)
          从另一文档向此文档导入节点,而不改变或移除原始文档中的源节点;此方法创建源节点的一个新副本。
 Node Node.insertBefore(Node newChild, Node refChild)
          在现有子节点 refChild 之前插入节点 newChild
 boolean Node.isEqualNode(Node arg)
          测试两个节点是否相等。
 boolean Node.isSameNode(Node other)
          返回此节点是否是与给定节点相同的节点。
 Node Node.removeChild(Node oldChild)
          从子节点列表中移除 oldChild 所指示的子节点,并将其返回。
 Node Document.renameNode(Node n, String namespaceURI, String qualifiedName)
          重命名 ELEMENT_NODEATTRIBUTE_NODE 类型的现有节点。
 Node Node.replaceChild(Node newChild, Node oldChild)
          将子节点列表中的子节点 oldChild 替换为 newChild,并返回 oldChild 节点。
 Node NamedNodeMap.setNamedItem(Node arg)
          使用 nodeName 属性添加节点。
 Node NamedNodeMap.setNamedItemNS(Node arg)
          使用其 namespaceURIlocalName 添加节点。
 

org.w3c.dom.eventsNode 的使用
 

返回 Nodeorg.w3c.dom.events 中的方法
 Node MutationEvent.getRelatedNode()
          relatedNode 用于识别与 mutation 事件相关联的辅助节点。
 

参数类型为 Nodeorg.w3c.dom.events 中的方法
 void MutationEvent.initMutationEvent(String typeArg, boolean canBubbleArg, boolean cancelableArg, Node relatedNodeArg, String prevValueArg, String newValueArg, String attrNameArg, short attrChangeArg)
          该 initMutationEvent 方法用于初始化通过 DocumentEvent 接口创建的 MutationEvent 的值。
 

org.w3c.dom.lsNode 的使用
 

返回 Nodeorg.w3c.dom.ls 中的方法
 Node LSParser.parseWithContext(LSInput input, Node contextArg, short action)
          从通过 LSInput 标识的资源中解析 XML 片段,并将其内容插入到用 contextaction 参数指定的位置的现有文档。
 

参数类型为 Nodeorg.w3c.dom.ls 中的方法
 short LSParserFilter.acceptNode(Node nodeArg)
          此方法将由解析器在完成对每个节点的解析后调用。
 Node LSParser.parseWithContext(LSInput input, Node contextArg, short action)
          从通过 LSInput 标识的资源中解析 XML 片段,并将其内容插入到用 contextaction 参数指定的位置的现有文档。
 boolean LSSerializer.write(Node nodeArg, LSOutput destination)
          像前面对 LSSerializer 接口的一般介绍中所描述的那样序列化指定的节点。
 String LSSerializer.writeToString(Node nodeArg)
          像前面对 LSSerializer 接口的一般介绍中所描述的那样序列化指定的节点。
 boolean LSSerializer.writeToURI(Node nodeArg, String uri)
          这是一种简便方法,其作用就像使用没有指定编码的 LSOutput 调用 LSSerializer.write,并且 LSOutput.systemId 被设置为 uri 参数。
 


JavaTM Platform
Standard Ed. 6

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策