接口 org.w3c.dom.Node 的使用 (Java Platform SE 6)

概述

软件包

类

使用

树

已过时

索引

帮助

Java^TM 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.metadata 中 Node 的使用

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

声明为 Node 的 javax.imageio.metadata 中的字段
`protected Node`	`IIOInvalidTreeException.offendingNode` 导致解析错误的 `Node`，或 `null`。

返回 Node 的 javax.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` 节点。

参数类型为 Node 的 javax.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` 对象的内部状态。

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

javax.xml.bind 中 Node 的使用

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

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

参数类型为 Node 的 javax.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.helpers 中 Node 的使用

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

参数类型为 Node 的 javax.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)

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

javax.xml.crypto.dom 中 Node 的使用

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

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

javax.xml.crypto.dsig.dom 中 Node 的使用

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

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

参数类型为 Node 的 javax.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.soap 中 Node 的使用

javax.xml.soap 中 Node 的子接口
`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 头部分的内容的对象。

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

javax.xml.transform.dom 中 Node 的使用

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

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

参数类型为 Node 的 javax.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.dom 中 Node 的使用

org.w3c.dom 中 Node 的子接口
`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`，并且表示 `Element` 或 `Attr` 的文本内容（在 XML 中称为字符数据）。

返回 Node 的 org.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_NODE` 或 `ATTRIBUTE_NODE` 类型的现有节点。
`Node`	`Node.replaceChild(Node newChild, Node oldChild)` 将子节点列表中的子节点 `oldChild` 替换为 `newChild`，并返回 `oldChild` 节点。
`Node`	`NamedNodeMap.setNamedItem(Node arg)` 使用 `nodeName` 属性添加节点。
`Node`	`NamedNodeMap.setNamedItemNS(Node arg)` 使用其 `namespaceURI` 和 `localName` 添加节点。

参数类型为 Node 的 org.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_NODE` 或 `ATTRIBUTE_NODE` 类型的现有节点。
`Node`	`Node.replaceChild(Node newChild, Node oldChild)` 将子节点列表中的子节点 `oldChild` 替换为 `newChild`，并返回 `oldChild` 节点。
`Node`	`NamedNodeMap.setNamedItem(Node arg)` 使用 `nodeName` 属性添加节点。
`Node`	`NamedNodeMap.setNamedItemNS(Node arg)` 使用其 `namespaceURI` 和 `localName` 添加节点。

org.w3c.dom.events 中 Node 的使用

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

参数类型为 Node 的 org.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.ls 中 Node 的使用

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

参数类型为 Node 的 org.w3c.dom.ls 中的方法
`short`	`LSParserFilter.acceptNode(Node nodeArg)` 此方法将由解析器在完成对每个节点的解析后调用。
`Node`	`LSParser.parseWithContext(LSInput input, Node contextArg, short action)` 从通过 `LSInput` 标识的资源中解析 XML 片段，并将其内容插入到用 `context` 和 `action` 参数指定的位置的现有文档。
`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` 参数。

概述