javax.xml.transform.stream
类 StreamResult

java.lang.Object
  javax.xml.transform.stream.StreamResult

所有已实现的接口：

Result

public class StreamResult
extends Object
implements Result

充当转换结果的持有者，可以为 XML、纯文本、HTML 或某些其他格式的标记。

字段摘要

static String

FEATURE 当将此值作为参数传递时，如果 TransformerFactory.getFeature(java.lang.String) 返回 true，则 Transformer 支持此类型的 Result 输出。

从接口 javax.xml.transform.Result 继承的字段

PI_DISABLE_OUTPUT_ESCAPING, PI_ENABLE_OUTPUT_ESCAPING

构造方法摘要

StreamResult()
零参数的默认构造方法。

StreamResult(File f)
从 File 构造 StreamResult。

StreamResult(OutputStream outputStream)
从字节流构造 StreamResult。

StreamResult(String systemId)
从 URL 构造 StreamResult。

StreamResult(Writer writer)
从字符流构造 StreamResult。

方法摘要

OutputStream	getOutputStream() 获取通过 setOutputStream 设置的字节流。
String	getSystemId() 获取通过 setSystemId 设置的系统标识符。
Writer	getWriter() 获取通过 setWriter 设置的字符流。
void	setOutputStream(OutputStream outputStream) 设置要写入的 ByteStream。
void	setSystemId(File f) 设置来自 File 引用的系统 ID。
void	setSystemId(String systemId) 设置可以与字节流或字符流关联使用的 systemID，如果未设置，则使用此值作为 writeable URI（可能是文件名）。
void	setWriter(Writer writer) 设置要接收结果的 writer。

从类 java.lang.Object 继承的方法

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

字段详细信息

FEATURE

public static final String FEATURE

当将此值作为参数传递时，如果 TransformerFactory.getFeature(java.lang.String) 返回 true，则 Transformer 支持此类型的 Result 输出。

另请参见：

常量字段值

构造方法详细信息

StreamResult

public StreamResult()

零参数的默认构造方法。

StreamResult

public StreamResult(OutputStream outputStream)

从字节流构造 StreamResult。通常，应使用流而不是 reader，以便转换器可以使用转换指令中包含的指令来控制编码。

参数：

outputStream - 有效的 OutputStream 引用。

StreamResult

public StreamResult(Writer writer)

从字符流构造 StreamResult。通常，应使用流而不是 reader，以便转换器可以使用转换指令中包含的指令来控制编码。但是，有时写入字符流是很有用的，例如当使用 StringWriter 时。

参数：

writer - 有效的 Writer 引用。

StreamResult

public StreamResult(String systemId)

从 URL 构造 StreamResult。

参数：

systemId - 必须为遵守 URI 语法的 String。

StreamResult

public StreamResult(File f)

从 File 构造 StreamResult。

参数：

f - 必须为非 null File 引用。

方法详细信息

setOutputStream

public void setOutputStream(OutputStream outputStream)

设置要写入的 ByteStream。通常，应使用流而不是 reader，以便转换器可以使用转换指令中包含的指令来控制编码。

参数：

outputStream - 有效的 OutputStream 引用。

getOutputStream

public OutputStream getOutputStream()

获取通过 setOutputStream 设置的字节流。

返回：

通过 setOutputStream 设置的字节流，如果未调用 setOutputStream 或 ByteStream 构造方法，则返回 null。

setWriter

public void setWriter(Writer writer)

设置要接收结果的 writer。通常，应使用流而不是 writer，以便转换器可以使用转换指令中包含的指令来控制编码。但是，有时写入 writer 是很有用的，例如当使用 StringWriter 时。

参数：

writer - 有效的 Writer 引用。

getWriter

public Writer getWriter()

获取通过 setWriter 设置的字符流。

返回：

通过 setWriter 设置的字符流，如果未调用 setWriter 或 Writer 构造方法，则返回 null。

setSystemId

public void setSystemId(String systemId)

设置可以与字节流或字符流关联使用的 systemID，如果未设置，则使用此值作为 writeable URI（可能是文件名）。

指定者：

接口 Result 中的 setSystemId

参数：

systemId - URI 字符串形式的系统标识符。

setSystemId

public void setSystemId(File f)

设置来自 File 引用的系统 ID。

注意 File.toURI() 和 File.toURL() 的使用。toURI() 是首选的，要尽可能使用它。为了允许在 J2SE 1.3 上运行 JAXP 1.3，如果试图使用 toURI() 时抛出 NoSuchMethodException，则使用 toURL()。

参数：

f - 必须为非 null File 引用。

getSystemId

public String getSystemId()

获取通过 setSystemId 设置的系统标识符。

指定者：

接口 Result 中的 getSystemId

返回：

通过 setSystemId 设置的系统标识符，如果未调用 setSystemId，则返回 null。