java.lang.Object | |
↳ | javax.xml.transform.stream.StreamResult |
Acts as an holder for a transformation result, which may be XML, plain Text, HTML, or some other form of markup.
Constants | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
String | FEATURE | If getFeature(String)
returns true when passed this value as an argument,
the Transformer supports Result output of this type. |
[Expand]
Inherited Constants | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From interface
javax.xml.transform.Result
|
Public Constructors | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Zero-argument default constructor.
| |||||||||||
Construct a StreamResult from a byte stream.
| |||||||||||
Construct a StreamResult from a character stream.
| |||||||||||
Construct a StreamResult from a URL.
| |||||||||||
Construct a StreamResult from a File.
|
Public Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Get the byte stream that was set with setOutputStream.
| |||||||||||
Get the system identifier that was set with setSystemId.
| |||||||||||
Get the character stream that was set with setWriter.
| |||||||||||
Set the ByteStream that is to be written to.
| |||||||||||
Set the system ID from a | |||||||||||
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).
| |||||||||||
Set the writer that is to receive the result.
|
[Expand]
Inherited Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From class
java.lang.Object
| |||||||||||
From interface
javax.xml.transform.Result
|
If getFeature(String)
returns true when passed this value as an argument,
the Transformer supports Result output of this type.
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.
outputStream | A valid OutputStream reference. |
---|
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.
writer | A valid Writer reference. |
---|
Construct a StreamResult from a URL.
systemId | Must be a String that conforms to the URI syntax. |
---|
Construct a StreamResult from a File.
f | Must a non-null File reference. |
---|
Get the byte stream that was set with setOutputStream.
Get the system identifier that was set with setSystemId.
Get the character stream that was set with setWriter.
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.
outputStream | A valid OutputStream reference. |
---|
Set the system ID from a File
reference.
Note the use of toURI()
and toURL()
.
toURI()
is preferred and used if possible.
To allow JAXP 1.3 to run on J2SE 1.3, toURL()
is used if a NoSuchMethodException
is thrown by the attempt
to use toURI()
.
f | Must a non-null File reference. |
---|
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).
systemId | The system identifier as a URI string. |
---|
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.
writer | A valid Writer reference. |
---|