JavaTM 2 Platform
Standard Ed. 5.0

org.w3c.dom
接口 Entity

所有超级接口:
Node

public interface Entity
extends Node

此接口表示在 XML 文档中解析和未解析的已知实体。注意,这模仿该实体本身而不是 实体声明。

Node 继承的 nodeName 属性包含实体的名称。

XML 处理器可能选择在结构模型传入 DOM 之前完全扩展实体;在此情况下,文档树中将不会有 EntityReference 节点。

XML 不要求非验证 XML 处理器读取和处理在外部子集中所做的或在参数实体中声明的实体声明。这意味着在外部子集中声明的解析实体不需要通过应用程序的某些类进行扩展,而且意味着该实体的替换文本可能不可用。当 替换文本 可用时,相应 Entity 节点的子列表表示该替换值的结构。否则,子列表为空。

DOM Level 3 不支持编辑 Entity 节点;如果用户希望更改 Entity 的内容,则必须通过克隆 Entity 的内容在结构模型中替换每个相关 EntityReference 节点,然后再对这些克隆中的每一个进行必要的更改。Entity 节点及其所有后代都为只读的。

Entity 节点没有任何父节点。

注:如果该实体包含未绑定的名称空间前缀,则 Entity 节点子树中相应节点的 namespaceURInull。对于指向此实体的 EntityReference 节点的同一名称空间 URI 同样是这样,这时使用 Document 接口的 createEntityReference 方法创建这些节点。

另请参见 Document Object Model (DOM) Level 3 Core Specification


字段摘要
 
从接口 org.w3c.dom.Node 继承的字段
ATTRIBUTE_NODE, CDATA_SECTION_NODE, COMMENT_NODE, DOCUMENT_FRAGMENT_NODE, DOCUMENT_NODE, DOCUMENT_POSITION_CONTAINED_BY, DOCUMENT_POSITION_CONTAINS, DOCUMENT_POSITION_DISCONNECTED, DOCUMENT_POSITION_FOLLOWING, DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC, DOCUMENT_POSITION_PRECEDING, DOCUMENT_TYPE_NODE, ELEMENT_NODE, ENTITY_NODE, ENTITY_REFERENCE_NODE, NOTATION_NODE, PROCESSING_INSTRUCTION_NODE, TEXT_NODE
 
方法摘要
 String getInputEncoding()
          当实体为外部解析实体时,它是在解析时用于此实体的指定编码的属性。
 String getNotationName()
          对于未解析实体,则为该实体的表示法名称。
 String getPublicId()
          如果已指定,则为与实体相关的公共标识符;否则为 null
 String getSystemId()
          如果已指定,则为与实体相关的系统标识符;否则为 null
 String getXmlEncoding()
          当实体为外部解析实体时,它是作为文本声明的一部分指定此实体的编码的属性。
 String getXmlVersion()
          当实体为外部解析实体时,它是作为文本声明的一部分指定此实体版本号的属性。
 
从接口 org.w3c.dom.Node 继承的方法
appendChild, cloneNode, compareDocumentPosition, getAttributes, getBaseURI, getChildNodes, getFeature, getFirstChild, getLastChild, getLocalName, getNamespaceURI, getNextSibling, getNodeName, getNodeType, getNodeValue, getOwnerDocument, getParentNode, getPrefix, getPreviousSibling, getTextContent, getUserData, hasAttributes, hasChildNodes, insertBefore, isDefaultNamespace, isEqualNode, isSameNode, isSupported, lookupNamespaceURI, lookupPrefix, normalize, removeChild, replaceChild, setNodeValue, setPrefix, setTextContent, setUserData
 

方法详细信息

getPublicId

String getPublicId()
如果已指定,则为与实体相关的公共标识符;否则为 null


getSystemId

String getSystemId()
如果已指定,则为与实体相关的系统标识符;否则为 null。这可以是绝对 URI,也可以不是。


getNotationName

String getNotationName()
对于未解析实体,则为该实体的表示法名称。对于解析实体,此值为 null


getInputEncoding

String getInputEncoding()
当实体为外部解析实体时,它是在解析时用于此实体的指定编码的属性。如果实体是内部子集中的实体,或如果未知,则此属性为 null

从以下版本开始:
DOM Level 3

getXmlEncoding

String getXmlEncoding()
当实体为外部解析实体时,它是作为文本声明的一部分指定此实体的编码的属性。否则,此属性为 null

从以下版本开始:
DOM Level 3

getXmlVersion

String getXmlVersion()
当实体为外部解析实体时,它是作为文本声明的一部分指定此实体版本号的属性。否则,此属性为 null

从以下版本开始:
DOM Level 3

JavaTM 2 Platform
Standard Ed. 5.0

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

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