javax.xml.transform.stream
public class StreamResult extends Object implements Result
Acts as an holder for a transformation result, which may be XML, plain Text, HTML, or some other form of markup.
Field Summary | |
---|---|
static String | FEATURE If {@link javax.xml.transform.TransformerFactory#getFeature}
returns true when passed this value as an argument,
the Transformer supports Result output of this type. |
Constructor Summary | |
---|---|
StreamResult()
Zero-argument default constructor. | |
StreamResult(OutputStream outputStream)
Construct a StreamResult from a byte stream. | |
StreamResult(Writer writer)
Construct a StreamResult from a character stream. | |
StreamResult(String systemId)
Construct a StreamResult from a URL.
| |
StreamResult(File f)
Construct a StreamResult from a File.
|
Method Summary | |
---|---|
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(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 | setSystemId(File f) Set the system ID from a Note the use of {@link File#toURI()} and {@link File#toURL()}. |
void | setWriter(Writer writer)
Set the writer that is to receive the result. |
Parameters: outputStream A valid OutputStream reference.
Parameters: writer A valid Writer reference.
Parameters: systemId Must be a String that conforms to the URI syntax.
Parameters: f Must a non-null File reference.
Returns: The byte stream that was set with setOutputStream, or null if setOutputStream or the ByteStream constructor was not called.
Returns: The system identifier that was set with setSystemId, or null if setSystemId was not called.
Returns: The character stream that was set with setWriter, or null if setWriter or the Writer constructor was not called.
Parameters: outputStream A valid OutputStream reference.
Parameters: systemId The system identifier as a URI string.
Set the system ID from a File
reference.
Note the use of {@link File#toURI()} and {@link File#toURL()}.
toURI()
is prefered and used if possible.
To allow JAXP 1.3 to run on J2SE 1.3, toURL()
is used if a {@link NoSuchMethodException} is thrown by the attempt
to use toURI()
.
Parameters: f Must a non-null File reference.
Parameters: writer A valid Writer reference.