©
This document uses PHP Chinese website manual Release
|
JavaTM 2 Platform Standard Ed. 6 |
|||||||||
上一个类 下一个类 | 框架 无框架 | |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
public interface XMLStreamWriter
XMLStreamWriter 接口指定如何编写 XML。XMLStreamWriter 不在其输入中检查格式是否良好。但是,writeCharacters 方法需要转义属性值的 &、< 和 >。writeAttribute 方法将转义上述字符以及 ",以确保所有字符内容和属性值都是格式良好的。 必须单独编写每个 NAMESPACE 和 ATTRIBUTE。
XML Namespaces、javax.xml.stream.isRepairingNamespaces 和写入方法行为 |
||||
---|---|---|---|---|
方法 |
isRepairingNamespaces == true |
isRepairingNamespaces == false |
||
namespaceURI 绑定 | namespaceURI 未绑定 | namespaceURI 绑定 | namespaceURI 未绑定 | |
writeAttribute(namespaceURI, localName, value) |
prefix:localName="value" [1] | xmlns:{generated}="namespaceURI" {generated}:localName="value" | prefix:localName="value" [1] |
XMLStreamException
|
writeAttribute(prefix, namespaceURI, localName, value) |
绑定到相同的前缀: prefix:localName="value" [1] 绑定到不同的前缀: xmlns:{generated}="namespaceURI" {generated}:localName="value" |
xmlns:prefix="namespaceURI" prefix:localName="value" [3] |
绑定到相同的前缀: prefix:localName="value" [1][2] 绑定到不同的前缀: XMLStreamException [2]
|
xmlns:prefix="namespaceURI" prefix:localName="value" [2][5] |
writeStartElement(namespaceURI, localName) writeEmptyElement(namespaceURI, localName)
|
<prefix:localName> [1] | <{generated}:localName xmlns:{generated}="namespaceURI"> | <prefix:localName> [1] |
XMLStreamException
|
writeStartElement(prefix, localName, namespaceURI) writeEmptyElement(prefix, localName, namespaceURI)
|
绑定到相同的前缀: <prefix:localName> [1] 绑定到不同的前缀: <{generated}:localName xmlns:{generated}="namespaceURI"> |
<prefix:localName xmlns:prefix="namespaceURI"> [4] |
绑定到相同的前缀: <prefix:localName> [1] 绑定到不同的前缀: XMLStreamException
|
<prefix:localName> |
注:
|
XMLOutputFactory
,
XMLStreamReader
方法摘要 | |
---|---|
void |
close()
关闭此 writer 并释放与 writer 关联的所有资源。 |
void |
flush()
将所有缓存数据写入底层输出机制。 |
NamespaceContext |
getNamespaceContext()
返回当前名称空间上下文。 |
String |
getPrefix(String uri)
获取绑定 URI 的前缀 |
Object |
getProperty(String name)
从底层实现获取功能/属性值 |
void |
setDefaultNamespace(String uri)
将 URI 绑定到默认名称空间。 |
void |
setNamespaceContext(NamespaceContext context)
设置前缀和 URI 绑定的当前名称空间上下文。 |
void |
setPrefix(String prefix,
String uri)
设置绑定 URI 的前缀。 |
void |
writeAttribute(String localName,
String value)
向输出流写入一个不带前缀的属性。 |
void |
writeAttribute(String namespaceURI,
String localName,
String value)
向输出流写入一个属性 |
void |
writeAttribute(String prefix,
String namespaceURI,
String localName,
String value)
向输出流写入一个属性 |
void |
writeCData(String data)
编写 CData 节 |
void |
writeCharacters(char[] text,
int start,
int len)
向输出写入文本 |
void |
writeCharacters(String text)
向输出写入文本 |
void |
writeComment(String data)
编写一个包含数据的 XML 注释 |
void |
writeDefaultNamespace(String namespaceURI)
向流写入默认名称空间 |
void |
writeDTD(String dtd)
编写 DTD 节。 |
void |
writeEmptyElement(String localName)
向输出写入一个空元素标记 |
void |
writeEmptyElement(String namespaceURI,
String localName)
向输出写入一个空元素标记 |
void |
writeEmptyElement(String prefix,
String localName,
String namespaceURI)
向输出写入一个空元素标记 |
void |
writeEndDocument()
关闭所有开始标记并写入相应的结束标记。 |
void |
writeEndElement()
向依赖于 writer 内部状态的输出写入一个结束标记,以此确定事件的前缀和本地名称。 |
void |
writeEntityRef(String name)
编写一个实体引用 |
void |
writeNamespace(String prefix,
String namespaceURI)
向输出流写入一个名称空间。 |
void |
writeProcessingInstruction(String target)
编写一条处理指令 |
void |
writeProcessingInstruction(String target,
String data)
编写一条处理指令 |
void |
writeStartDocument()
编写 XML 声明。 |
void |
writeStartDocument(String version)
编写 XML 声明。 |
void |
writeStartDocument(String encoding,
String version)
编写 XML 声明。 |
void |
writeStartElement(String localName)
向输出写入一个开始标记。 |
void |
writeStartElement(String namespaceURI,
String localName)
向输出写入一个开始标记 |
void |
writeStartElement(String prefix,
String localName,
String namespaceURI)
向输出写入一个开始标记 |
方法详细信息 |
---|
void writeStartElement(String localName) throws XMLStreamException
localName
- 标记的本地名称,不可以为 null
XMLStreamException
void writeStartElement(String namespaceURI, String localName) throws XMLStreamException
namespaceURI
- 要使用的前缀的 namespaceURI ,不可以为 nulllocalName
- 标记的本地名称,不可以为 null
XMLStreamException
- 如果名称空间 URI 未绑定到前缀并且 javax.xml.stream.isRepairingNamespaces 未设置为 truevoid writeStartElement(String prefix, String localName, String namespaceURI) throws XMLStreamException
localName
- 标记的本地名称,不可以为 nullprefix
- 标记的前缀,不可以为 nullnamespaceURI
- 要绑定前缀的 URI,不可以为 null
XMLStreamException
void writeEmptyElement(String namespaceURI, String localName) throws XMLStreamException
namespaceURI
- 要绑定标记的 URI,不可以为 nulllocalName
- 标记的本地名称,不可以为 null
XMLStreamException
- 如果名称空间 URI 未绑定到前缀并且 javax.xml.stream.isRepairingNamespaces 未设置为 truevoid writeEmptyElement(String prefix, String localName, String namespaceURI) throws XMLStreamException
prefix
- 标记的前缀,不可以为 nulllocalName
- 标记的本地名称,不可以为 nullnamespaceURI
- 要绑定标记的 URI,不可以为 null
XMLStreamException
void writeEmptyElement(String localName) throws XMLStreamException
localName
- 标记的本地名称,不可以为 null
XMLStreamException
void writeEndElement() throws XMLStreamException
XMLStreamException
void writeEndDocument() throws XMLStreamException
XMLStreamException
void close() throws XMLStreamException
XMLStreamException
void flush() throws XMLStreamException
XMLStreamException
void writeAttribute(String localName, String value) throws XMLStreamException
localName
- 属性的本地名称value
- 属性的值
IllegalStateException
- 如果当前状态不允许 Attribute 写入
XMLStreamException
void writeAttribute(String prefix, String namespaceURI, String localName, String value) throws XMLStreamException
prefix
- 此属性的前缀namespaceURI
- 此属性前缀的 URIlocalName
- 属性的本地名称value
- 属性的值
IllegalStateException
- 如果当前状态不允许 Attribute 写入
XMLStreamException
- 如果名称空间 URI 未绑定到前缀且 javax.xml.stream.isRepairingNamespaces 未设置为 truevoid writeAttribute(String namespaceURI, String localName, String value) throws XMLStreamException
namespaceURI
- 此属性前缀的 URIlocalName
- 属性的本地名称value
- 属性的值
IllegalStateException
- 如果当前状态不允许 Attribute 写入
XMLStreamException
- 如果名称空间 URI 未绑定到前缀且 javax.xml.stream.isRepairingNamespaces 未设置为 truevoid writeNamespace(String prefix, String namespaceURI) throws XMLStreamException
prefix
- 要绑定名称空间的前缀namespaceURI
- 要绑定前缀的 URI
IllegalStateException
- 如果当前状态不允许 Namespace 写入
XMLStreamException
void writeDefaultNamespace(String namespaceURI) throws XMLStreamException
namespaceURI
- 要绑定默认名称空间的 URI
IllegalStateException
- 如果当前状态不允许 Namespace 写入
XMLStreamException
void writeComment(String data) throws XMLStreamException
data
- 包含在注释中的数据,可以为 null
XMLStreamException
void writeProcessingInstruction(String target) throws XMLStreamException
target
- 处理指令的目标,不可以为 null
XMLStreamException
void writeProcessingInstruction(String target, String data) throws XMLStreamException
target
- 处理指令的目标,不可以为 nulldata
- 处理指令中包含的数据,不可以为 null
XMLStreamException
void writeCData(String data) throws XMLStreamException
data
- CData 节中包含的数据,不可以为 null
XMLStreamException
void writeDTD(String dtd) throws XMLStreamException
dtd
- 要编写的 DTD
XMLStreamException
void writeEntityRef(String name) throws XMLStreamException
name
- 实体的名称
XMLStreamException
void writeStartDocument() throws XMLStreamException
XMLStreamException
void writeStartDocument(String version) throws XMLStreamException
version
- xml 文档的版本
XMLStreamException
void writeStartDocument(String encoding, String version) throws XMLStreamException
encoding
- XML 声明的编码version
- XML 文档的版本
XMLStreamException
- 如果给定编码与底层流的编码不匹配void writeCharacters(String text) throws XMLStreamException
text
- 要写入的值
XMLStreamException
void writeCharacters(char[] text, int start, int len) throws XMLStreamException
text
- 要写入的值start
- 数组中的起始位置len
- 要写入的字符数
XMLStreamException
String getPrefix(String uri) throws XMLStreamException
XMLStreamException
void setPrefix(String prefix, String uri) throws XMLStreamException
prefix
- 要绑定到 URI 的前缀,不可以为 nulluri
- 要绑定到前缀的 URI,不可以为 null
XMLStreamException
void setDefaultNamespace(String uri) throws XMLStreamException
uri
- 要绑定到默认名称空间的 URI,不可以为 null
XMLStreamException
void setNamespaceContext(NamespaceContext context) throws XMLStreamException
context
- 将用于此 writer 的名称空间上下文,不可以为 null
XMLStreamException
NamespaceContext getNamespaceContext()
Object getProperty(String name) throws IllegalArgumentException
name
- 属性的名称,不可以为 null
IllegalArgumentException
- 如果属性不受支持
NullPointerException
- 如果名称为 null
|
JavaTM 2 Platform Standard Ed. 6 |
|||||||||
上一个类 下一个类 | 框架 无框架 | |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。