站内搜索: 请输入搜索关键词
当前页面: 在线文档首页 > JavaTM 2 Platform Standard Edition 5.0 API 规范中文版

接口 org.w3c.dom.Node 的使用 (Java 2 Platform SE 5.0) - JavaTM 2 Platform Standard Edition 5.0 API 规范中文版

JavaTM 2 Platform
Standard Ed. 5.0

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

使用 Node 的软件包
javax.imageio.metadata 用于处理读写元数据的 Java Image I/O 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.transform.domNode 的使用
 

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

参数类型为 Nodejavax.xml.transform.dom 中的方法
 void DOMResult.setNextSibling(Node nextSibling)
          设置将要插入的结果节点之后的子节点。
 void DOMSource.setNode(Node node)
          设置将表示 Source DOM 树的节点。
 void DOMResult.setNode(Node node)
          设置将包含结果 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 NodeList.item(int index)
          返回集合中的第 index 个项。
 Node NamedNodeMap.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 2 Platform
Standard Ed. 5.0

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

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