Module java.xml
Package org.w3c.dom

Interface Entity

所有超级接口:
Node
public interface Entity extends Node
该接口表示XML文档中的已知实体，可以是已解析的也可以是未解析的。请注意，这里模拟的是实体本身，而不是实体声明。

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

XML处理器可能选择在将结构模型传递给DOM之前完全展开实体；在这种情况下，文档树中将没有EntityReference节点。

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

DOM Level 3不支持编辑Entity节点；如果用户想要更改Entity的内容，那么必须将结构模型中的每个相关EntityReference节点替换为Entity内容的克隆，然后必须对每个克隆进行所需的更改。Entity节点及其所有后代都是只读的。

Entity节点没有任何父节点。

注意: 如果实体包含未绑定的命名空间前缀，则Entity节点子树中相应节点的namespaceURI为null。当使用Document接口的createEntityReference方法创建引用此实体的EntityReference节点时，情况也是如此。

另请参阅文档对象模型（DOM）Level 3核心规范。

  • Method Details

    • getPublicId

      String getPublicId()
      与实体关联的公共标识符（如果指定），否则为null。

    • getSystemId

      String getSystemId()
      与实体关联的系统标识符（如果指定），否则为null。这可能是绝对URI，也可能不是。

    • getNotationName

      String getNotationName()
      对于未解析的实体，实体的符号名称。对于已解析的实体，这是null。

    • getInputEncoding

      String getInputEncoding()
      用于解析时指定此实体使用的编码的属性。如果它是来自内部子集的实体或者未知的，则为null。
      自从:
      1.5, DOM Level 3

    • getXmlEncoding

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

    • getXmlVersion

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