public interface Entity
implements Node
org.w3c.dom.Entity |
该接口表示XML文档中已知的实体,无论是已分析还是未分析。 请注意,这将模拟实体本身而不是实体声明。
从 Node
继承的 nodeName
属性包含实体的名称。
XML处理器可以选择在结构模型传递给DOM之前完全展开实体; 在这种情况下,文档树中不会有EntityReference
节点。
XML不要求非验证XML处理器读取和处理在外部子集中做出的或在参数实体中声明的实体声明。 这意味着在外部子集中声明的解析实体不需要被某些类的应用程序扩展,并且实体的替换文本可能不可用。 当replacement text可用时,对应的Entity
节点的子列表表示该替换值的结构。 否则,子列表是空的。
DOM Level 3不支持编辑Entity
节点; 如果用户想要更改Entity
的内容,则每个相关的EntityReference
节点都必须在结构模型中用Entity
的内容克隆替换,然后必须对每个这些克隆进行所需的更改。 Entity
节点及其所有后代都是只读的。
一个 Entity
节点没有父节点。
注意:如果实体包含未绑定的名称空间前缀,则namespaceURI
在相应的节点Entity
节点树为null
。 对于涉及此实体的EntityReference
节点,当使用Document
接口的createEntityReference
方法创建它们时也是Document
。
另见 Document Object Model (DOM) Level 3 Core Specification 。
Inherited constants |
---|
From interface org.w3c.dom.Node
|
Public methods |
|
---|---|
abstract String |
getInputEncoding() 一个属性,指定在解析时用于此实体的编码,当它是外部解析的实体时。 |
abstract String |
getNotationName() 对于未分析的实体,实体的符号的名称。 |
abstract String |
getPublicId() 与实体关联的公共标识符(如果指定),否则为 |
abstract String |
getSystemId() 系统标识符与实体相关(如果指定的话),否则为 |
abstract String |
getXmlEncoding() 作为文本声明一部分的属性,指定此实体的编码,当它是外部解析的实体时。 |
abstract String |
getXmlVersion() 作为文本声明的一部分,属性指定此实体的版本号,当它是外部解析的实体时。 |
Inherited methods |
|
---|---|
From interface org.w3c.dom.Node
|
String getInputEncoding ()
一个属性,指定在解析时用于此实体的编码,当它是外部解析的实体时。 这是null
如果它是来自内部子集的实体或者它是未知的。
Returns | |
---|---|
String |
String getNotationName ()
对于未分析的实体,实体的符号的名称。 对于解析的实体,这是null
。
Returns | |
---|---|
String |
String getSystemId ()
系统标识符与实体相关联(如果指定),否则为null
。 这可能是绝对URI或不是。
Returns | |
---|---|
String |
String getXmlEncoding ()
作为文本声明一部分的属性,指定此实体的编码,当它是外部解析的实体时。 否则这是null
。
Returns | |
---|---|
String |
String getXmlVersion ()
作为文本声明的一部分,属性指定此实体的版本号,当它是外部解析的实体时。 否则这是null
。
Returns | |
---|---|
String |