API Reference Document

Most visited

Recently visited

Results for

Added in API level 1

Summary: Inherited Constants | Inherited Methods | [Expand All]

CDATASection

public interface CDATASection
implements Text

org.w3c.dom.CDATASection

CDATA部分用于转义包含字符的文本块，否则这些字符将被视为标记。在CDATA部分中唯一可识别的分隔符是“]]>”字符串，用于结束CDATA部分。 CDATA部分不能嵌套。它们的主要目的是包含诸如XML片段之类的材料，而无需转义所有的分隔符。

CharacterData.data属性保存CDATA节包含的文本。请注意，这可能包含需要在CDATA部分之外转义的字符，并且根据为序列化选择的字符编码（“字符集”），可能无法将某些字符写入CDATA部分。

CharacterData接口通过CDATASection接口继承Text接口。相邻的CDATASection节点不通过使用Node接口的normalize方法合并。

没有对CDATA部分的内容进行词法检查，因此可能在内容中包含字符序列"]]>" ，该部分在[ XML 1.0 ]的2.7节的CDATA部分中是非法的。在序列化期间，此字符序列的存在必须产生致命错误，或者在序列化之前必须拆分cdata部分（另请参阅DOMConfiguration界面中的参数"split-cdata-sections" ）。

注意：由于在CDATASection内没有标识，所以在序列化时字符数字引用不能用作转义机制。因此，在使用字符编码序列化CDATASection时，需要采取措施，其中某些包含的字符无法表示。不这样做不会产生格式良好的XML。

注意：序列化过程中的一个潜在解决方案是在字符前面结束CDATA部分，使用字符引用或实体引用输出字符，并为文本节点中的任何其他字符打开新的CDATA部分。但是，请注意，在编写本文时，某些代码转换库在编码中缺少字符时不会返回错误或异常，从而确保数据在序列化过程中不会损坏。

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

Summary

Inherited constants

From interface org.w3c.dom.Node

Inherited methods

From interface org.w3c.dom.Text

From interface org.w3c.dom.CharacterData

From interface org.w3c.dom.Node

`abstract Node`	`appendChild(Node newChild)` 将节点 `newChild`添加到此节点的子节点列表的末尾。
`abstract Node`	`cloneNode(boolean deep)` 返回此节点的副本，即充当节点的通用拷贝构造函数。
`abstract short`	`compareDocumentPosition(Node other)` 比较参考节点，即
`abstract NamedNodeMap`	`getAttributes()` 甲 `NamedNodeMap`含有此节点的属性（如果它是一个 `Element` ）或 `null`否则。
`abstract String`	`getBaseURI()` 如果实现无法获得绝对URI，则此节点的绝对基准URI或 `null` 。
`abstract NodeList`	`getChildNodes()` 包含此节点的所有子节点的 `NodeList` 。
`abstract Object`	`getFeature(String feature, String version)` 此方法返回一个专用对象，该对象实现指定功能和版本的专用API，如中指定。
`abstract Node`	`getFirstChild()` 这个节点的第一个孩子。
`abstract Node`	`getLastChild()` 这个节点的最后一个孩子。
`abstract String`	`getLocalName()` 返回此节点的限定名称的本地部分。
`abstract String`	`getNamespaceURI()` 该节点的名称空间URI，如果未指定， `null` （请参阅 `null` ）。
`abstract Node`	`getNextSibling()` 节点紧跟在此节点之后。
`abstract String`	`getNodeName()` 该节点的名称取决于其类型; 见上表。
`abstract short`	`getNodeType()` 如上定义的代表底层对象类型的代码。
`abstract String`	`getNodeValue()` 此节点的值取决于其类型; 见上表。
`abstract Document`	`getOwnerDocument()` 与此节点关联的 `Document`对象。
`abstract Node`	`getParentNode()` 此节点的父节点。
`abstract String`	`getPrefix()` 该节点的名称空间前缀，如果未指定， `null` 。
`abstract Node`	`getPreviousSibling()` 该节点之前的节点。
`abstract String`	`getTextContent()` 该属性返回此节点及其后代的文本内容。
`abstract Object`	`getUserData(String key)` 检索与此节点上的键关联的对象。
`abstract boolean`	`hasAttributes()` 返回此节点（如果它是元素）是否具有任何属性。
`abstract boolean`	`hasChildNodes()` 返回此节点是否有任何子节点。
`abstract Node`	`insertBefore(Node newChild, Node refChild)` 插入节点 `newChild`现有的子节点之前 `refChild` 。
`abstract boolean`	`isDefaultNamespace(String namespaceURI)` 此方法检查指定的 `namespaceURI`是否是默认名称空间。
`abstract boolean`	`isEqualNode(Node arg)` 测试两个节点是否相等。
`abstract boolean`	`isSameNode(Node other)` 返回此节点是否与给定节点相同。
`abstract boolean`	`isSupported(String feature, String version)` 测试DOM实现是否实现了特定的功能，该功能是否受此节点支持，如指定。
`abstract String`	`lookupNamespaceURI(String prefix)` 从该节点开始查找与给定前缀关联的命名空间URI。
`abstract String`	`lookupPrefix(String namespaceURI)` 从该节点开始查找与给定名称空间URI关联的前缀。
`abstract void`	`normalize()` 将包含属性节点的此 `Node`下的子树的全部深度中的所有 `Text`节点置于“正常”形式，其中仅结构（例如元素，注释，处理指令，CDATA节和实体引用）将 `Text`节点即没有相邻的 `Text`节点，也没有空的 `Text`节点。
`abstract Node`	`removeChild(Node oldChild)` 从子项列表中删除由 `oldChild`指示的子节点，并将其返回。
`abstract Node`	`replaceChild(Node newChild, Node oldChild)` 替换子节点 `oldChild`与 `newChild`儿童的名单，并返回 `oldChild`节点。
`abstract void`	`setNodeValue(String nodeValue)` 此节点的值取决于其类型; 见上表。
`abstract void`	`setPrefix(String prefix)` 该节点的名称空间前缀，如果未指定， `null` 。
`abstract void`	`setTextContent(String textContent)` 该属性返回此节点及其后代的文本内容。
`abstract Object`	`setUserData(String key, Object data, UserDataHandler handler)` 将对象与此节点上的键相关联。