CDATASection (Java 2 Platform SE 5.0) - JavaTM 2 Platform Standard Edition 5.0 API 规范中文版
|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
| 上一个类 下一个类 | 框架 无框架 | |||||||||
| 摘要： 嵌套 | 字段 | 构造方法 | 方法 | 详细信息： 字段 | 构造方法 | 方法 | |||||||||
org.w3c.dom
接口 CDATASection
- 所有超级接口：
- CharacterData, Node, Text
public interface CDATASection
- extends Text
CDATA 节用于转义文本块，该文本块包含的字符如果不转义则会被视为标记。在 CDATA 节中识别的唯一分隔符是结束 CDATA 节的 "]]>" 字符串。CDATA 节不能嵌套。它们的主要目的是包含诸如 XML 片段之类的材料而无需转义所有分隔符。
CharacterData.data 属性保存由 CDATA 节包含的文本。注意，这可以 包含需要在 CDATA 节之外转义的字符，而且根据为序列化选择的字符编码 ("charset")，它不能作为 CDATA 节的一部分写出某些字符。
CDATASection 接口通过 Text 接口继承自 CharacterData 接口。相邻的 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。
| 字段摘要 |
|---|
| 方法摘要 |
|---|
| 从接口 org.w3c.dom.Text 继承的方法 |
|---|
getWholeText, isElementContentWhitespace, replaceWholeText, splitText |
| 从接口 org.w3c.dom.CharacterData 继承的方法 |
|---|
appendData, deleteData, getData, getLength, insertData, replaceData, setData, substringData |
|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
| 上一个类 下一个类 | 框架 无框架 | |||||||||
| 摘要： 嵌套 | 字段 | 构造方法 | 方法 | 详细信息： 字段 | 构造方法 | 方法 | |||||||||
提交错误或意见
有关更多的 API 参考资料和开发人员文档，请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述，以及总体概述、术语定义、使用技巧和工作代码示例。
版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。