public interface LSOutput
org.w3c.dom.ls.LSOutput |
该界面表示数据的输出目的地。
该接口允许应用程序将关于输出目标的信息封装在单个对象中,该对象可以包括URI,字节流(可能具有指定编码),基本URI和/或字符流。
字节流和字符流的确切定义依赖于绑定。
预计该应用程序将提供实现此接口的对象,无论何时需要此类对象。 应用程序可以提供自己的实现此接口的对象,也可以使用通用工厂方法DOMImplementationLS.createLSOutput()
来创建实现此接口的对象。
LSSerializer
将使用LSOutput
对象来确定将输出序列化到哪里。 LSSerializer
将按照以下顺序查看LSOutput
中指定的不同输出,以了解要输出到哪个输出,第一个不为空且不会使用空字符串:
LSOutput.characterStream
LSOutput.byteStream
LSOutput.systemId
LSOutput
对象属于应用程序。 DOM实现永远不会修改它们(尽管它可能会复制和修改副本,如有必要)。
另见 Document Object Model (DOM) Level 3 Load and Save Specification 。
Public methods |
|
---|---|
abstract OutputStream |
getByteStream() 表示可写入字节流的语言和依赖于绑定的类型的属性。 |
abstract Writer |
getCharacterStream() 表示可输出16位单元的可写入流的语言和依赖于绑定的类型的属性。 |
abstract String |
getEncoding() 用于输出的字符编码。 |
abstract String |
getSystemId() 系统标识符,该输出目标的URI参考[ IETF RFC 2396 ]。 |
abstract void |
setByteStream(OutputStream byteStream) 表示可写入字节流的语言和依赖于绑定的类型的属性。 |
abstract void |
setCharacterStream(Writer characterStream) 表示可输出16位单元的可写入流的语言和依赖于绑定的类型的属性。 |
abstract void |
setEncoding(String encoding) 用于输出的字符编码。 |
abstract void |
setSystemId(String systemId) 系统标识符,该输出目标的URI参考[ IETF RFC 2396 ]。 |
OutputStream getByteStream ()
表示可写入字节流的语言和依赖于绑定的类型的属性。
Returns | |
---|---|
OutputStream |
Writer getCharacterStream ()
表示可输出16位单元的可写入流的语言和依赖于绑定的类型的属性。
Returns | |
---|---|
Writer |
String getEncoding ()
用于输出的字符编码。 编码必须是XML编码声明可接受的字符串([ XML 1.0 ]部分4.3.3“实体中的字符编码”),建议字符编码以Internet编号授权机构[ IANA-CHARSETS ]注册(以字符集形式)指的是使用他们的注册名称。
Returns | |
---|---|
String |
String getSystemId ()
系统标识符,该输出目标的URI参考[ IETF RFC 2396 ]。
如果系统ID是相对URI引用(请参阅[ IETF RFC 2396 ]中的第5节),则行为取决于实现。
Returns | |
---|---|
String |
void setByteStream (OutputStream byteStream)
表示可写入字节流的语言和依赖于绑定的类型的属性。
Parameters | |
---|---|
byteStream |
OutputStream
|
void setCharacterStream (Writer characterStream)
表示可输出16位单元的可写入流的语言和依赖于绑定的类型的属性。
Parameters | |
---|---|
characterStream |
Writer
|
void setEncoding (String encoding)
用于输出的字符编码。 编码必须是XML编码声明([ XML 1.0 ]第4.3.3节“实体中的字符编码”)可接受的字符串,建议字符编码以互联网号码分配机构[ IANA-CHARSETS ]注册(以字符集形式)指的是使用他们的注册名称。
Parameters | |
---|---|
encoding |
String
|
void setSystemId (String systemId)
系统标识符,该输出目标的URI参考[ IETF RFC 2396 ]。
如果系统ID是相对URI引用(请参阅[ IETF RFC 2396 ]中的第5节),则行为取决于实现。
Parameters | |
---|---|
systemId |
String
|