- java.lang.Object
-
- javax.xml.transform.stream.StreamResult
-
-
Field Summary
Fields Modifier and Type Field and Description static String
FEATURE
IfTransformerFactory.getFeature(java.lang.String)
returns true when passed this value as an argument, the Transformer supports Result output of this type.-
Fields inherited from interface javax.xml.transform.Result
PI_DISABLE_OUTPUT_ESCAPING, PI_ENABLE_OUTPUT_ESCAPING
-
-
Constructor Summary
Constructors Constructor and Description StreamResult()
Zero-argument default constructor.StreamResult(File f)
Construct a StreamResult from a File.StreamResult(OutputStream outputStream)
Construct a StreamResult from a byte stream.StreamResult(String systemId)
Construct a StreamResult from a URL.StreamResult(Writer writer)
Construct a StreamResult from a character stream.
-
Method Summary
Methods Modifier and Type Method and Description OutputStream
getOutputStream()
Get the byte stream that was set with setOutputStream.String
getSystemId()
Get the system identifier that was set with setSystemId.Writer
getWriter()
Get the character stream that was set with setWriter.void
setOutputStream(OutputStream outputStream)
Set the ByteStream that is to be written to.void
setSystemId(File f)
Set the system ID from aFile
reference.void
setSystemId(String systemId)
Set the systemID that may be used in association with the byte or character stream, or, if neither is set, use this value as a writeable URI (probably a file name).void
setWriter(Writer writer)
Set the writer that is to receive the result.
-
-
-
Field Detail
-
FEATURE
public static final String FEATURE
IfTransformerFactory.getFeature(java.lang.String)
returns true when passed this value as an argument, the Transformer supports Result output of this type.- See Also:
- Constant Field Values
-
-
Constructor Detail
-
StreamResult
public StreamResult()
Zero-argument default constructor.
-
StreamResult
public StreamResult(OutputStream outputStream)
Construct a StreamResult from a byte stream. Normally, a stream should be used rather than a reader, so that the transformer may use instructions contained in the transformation instructions to control the encoding.- Parameters:
outputStream
- A valid OutputStream reference.
-
StreamResult
public StreamResult(Writer writer)
Construct a StreamResult from a character stream. Normally, a stream should be used rather than a reader, so that the transformer may use instructions contained in the transformation instructions to control the encoding. However, there are times when it is useful to write to a character stream, such as when using a StringWriter.- Parameters:
writer
- A valid Writer reference.
-
StreamResult
public StreamResult(String systemId)
Construct a StreamResult from a URL.- Parameters:
systemId
- Must be a String that conforms to the URI syntax.
-
StreamResult
public StreamResult(File f)
Construct a StreamResult from a File.- Parameters:
f
- Must a non-null File reference.
-
-
Method Detail
-
setOutputStream
public void setOutputStream(OutputStream outputStream)
Set the ByteStream that is to be written to. Normally, a stream should be used rather than a reader, so that the transformer may use instructions contained in the transformation instructions to control the encoding.- Parameters:
outputStream
- A valid OutputStream reference.
-
getOutputStream
public OutputStream getOutputStream()
Get the byte stream that was set with setOutputStream.- Returns:
- The byte stream that was set with setOutputStream, or null if setOutputStream or the ByteStream constructor was not called.
-
setWriter
public void setWriter(Writer writer)
Set the writer that is to receive the result. Normally, a stream should be used rather than a writer, so that the transformer may use instructions contained in the transformation instructions to control the encoding. However, there are times when it is useful to write to a writer, such as when using a StringWriter.- Parameters:
writer
- A valid Writer reference.
-
getWriter
public Writer getWriter()
Get the character stream that was set with setWriter.- Returns:
- The character stream that was set with setWriter, or null if setWriter or the Writer constructor was not called.
-
setSystemId
public void setSystemId(String systemId)
Set the systemID that may be used in association with the byte or character stream, or, if neither is set, use this value as a writeable URI (probably a file name).- Specified by:
setSystemId
in interfaceResult
- Parameters:
systemId
- The system identifier as a URI string.
-
setSystemId
public void setSystemId(File f)
Set the system ID from a
File
reference.- Parameters:
f
- Must a non-null File reference.
-
getSystemId
public String getSystemId()
Get the system identifier that was set with setSystemId.- Specified by:
getSystemId
in interfaceResult
- Returns:
- The system identifier that was set with setSystemId, or null if setSystemId was not called.
-
-
Document created the 11/06/2005, last modified the 04/03/2020
Source of the printed document:https://www.gaudry.be/en/java-api-rf-javax/xml/transform/stream/streamresult.html
The infobrol is a personal site whose content is my sole responsibility. The text is available under CreativeCommons license (BY-NC-SA). More info on the terms of use and the author.
References
These references and links indicate documents consulted during the writing of this page, or which may provide additional information, but the authors of these sources can not be held responsible for the content of this page.
The author This site is solely responsible for the way in which the various concepts, and the freedoms that are taken with the reference works, are presented here. Remember that you must cross multiple source information to reduce the risk of errors.