org.w3c.dom.ls

接口
异常
public interface LSOutput

此接口表示数据的输出目标。

此接口允许应用程序封装有关单个对象中的输出目标的信息,它可包括 URI、字节流(可能带有指定的编码)、基 URI 和/或字符流。

对字节流和字符流的精确定义具有绑定依赖性。

当需要这种对象时,期望应用程序提供实现此接口的对象。应用程序既可以提供自己的实现此接口的对象,也可以使用一般的工厂方法 DOMImplementationLS.createLSOutput() 来创建实现此接口的对象。

LSSerializer 将使用 LSOutput 对象来确定将输出序列化到何处。LSSerializer 将按照下面的顺序查看在 LSOutput 中指定的不同输出,以了解输出到哪个当中,将使用不为 null 并且不是空字符串的第一个输出:

  1. LSOutput.characterStream
  2. LSOutput.byteStream
  3. LSOutput.systemId

LSOutput 对象属于该应用程序。DOM 实现永远不会修改这些对象(尽管可在必要时制做副本和修改副本)。

另请参见《Document Object Model (DOM) Level 3 Load and Save Specification》。


方法摘要
 OutputStream getByteStream()
          具有语言和绑定依赖性类型的属性,表示字节的可写流。
 Writer getCharacterStream()
          具有语言和绑定依赖性类型的属性,它表示可向其输出 16 位单元的可写流。
 String getEncoding()
          用于输出的字符编码。
 String getSystemId()
          系统标识符,它是此输出目标的 URI 引用 [IETF RFC 2396]。
 void setByteStream(OutputStream byteStream)
          具有语言和绑定依赖性类型的属性,表示字节的可写流。
 void setCharacterStream(Writer characterStream)
          具有语言和绑定依赖性类型的属性,它表示可向其输出 16 位单元的可写流。
 void setEncoding(String encoding)
          用于输出的字符编码。
 void setSystemId(String systemId)
          系统标识符,它是此输出目标的 URI 引用 [IETF RFC 2396]。
 

方法详细信息

getCharacterStream

Writer getCharacterStream()
具有语言和绑定依赖性类型的属性,它表示可向其输出 16 位单元的可写流。


setCharacterStream

void setCharacterStream(Writer characterStream)
具有语言和绑定依赖性类型的属性,它表示可向其输出 16 位单元的可写流。


getByteStream

OutputStream getByteStream()
具有语言和绑定依赖性类型的属性,表示字节的可写流。


setByteStream

void setByteStream(OutputStream byteStream)
具有语言和绑定依赖性类型的属性,表示字节的可写流。


getSystemId

String getSystemId()
系统标识符,它是此输出目标的 URI 引用 [ IETF RFC 2396]。
如果系统 ID 是相对 URI 引用(参见 [ IETF RFC 2396] 中的 5 节),则该行为具有实现依赖性。


setSystemId

void setSystemId(String systemId)
系统标识符,它是此输出目标的 URI 引用 [ IETF RFC 2396]。
如果系统 ID 是相对 URI 引用(参见 [ IETF RFC 2396] 中的 5 节),则该行为具有实现依赖性。


getEncoding

String getEncoding()
用于输出的字符编码。编码必须是 XML 编码声明([ XML 1.0] 的 4.3.3 节 "Character Encoding in Entities")可接受的字符串,建议在“国际因特网地址分配委员会”[ IANA-CHARSETS] 注册的字符编码应该使用它们的注册名称来引用。


setEncoding

void setEncoding(String encoding)
用于输出的字符编码。编码必须是 XML 编码声明([ XML 1.0] 的 4.3.3 节 "Character Encoding in Entities")可接受的字符串,建议在“国际因特网地址分配委员会”[ IANA-CHARSETS] 中注册的字符编码使用它们的注册名称来引用。