JavaTM 2 Platform
Standard Ed. 5.0

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。

JavaTM 2 Platform
Standard Ed. 5.0

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策