# StreamResult

Added in[API level 8](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  
Summary:[Constants](https://developer.android.com/reference/javax/xml/transform/stream/StreamResult#constants)\|[Inherited Constants](https://developer.android.com/reference/javax/xml/transform/stream/StreamResult#inhconstants)\|[Ctors](https://developer.android.com/reference/javax/xml/transform/stream/StreamResult#pubctors)\|[Methods](https://developer.android.com/reference/javax/xml/transform/stream/StreamResult#pubmethods)\|[Inherited Methods](https://developer.android.com/reference/javax/xml/transform/stream/StreamResult#inhmethods)  

# StreamResult

`
public


class
StreamResult
`  
`

extends `[Object](https://developer.android.com/reference/java/lang/Object)`


``


implements

`[Result](https://developer.android.com/reference/javax/xml/transform/Result)`


`

|---|-----------------------------------------|
| [java.lang.Object](https://developer.android.com/reference/java/lang/Object) ||
| ↳ | javax.xml.transform.stream.StreamResult |

<br />

*** ** * ** ***

<br />

Acts as an holder for a transformation result, which may be XML, plain Text, HTML, or some other form of markup.

<br />

## Summary

|                                                                                                                                                                                                             ### Constants                                                                                                                                                                                                             ||
|--------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| [String](https://developer.android.com/reference/java/lang/String) | [FEATURE](https://developer.android.com/reference/javax/xml/transform/stream/StreamResult#FEATURE) If[TransformerFactory.getFeature(String)](https://developer.android.com/reference/javax/xml/transform/TransformerFactory#getFeature(java.lang.String))returns true when passed this value as an argument, the Transformer supports Result output of this type. |

|                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     ### Inherited constants                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| From interface[javax.xml.transform.Result](https://developer.android.com/reference/javax/xml/transform/Result) |--------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | [String](https://developer.android.com/reference/java/lang/String) | [PI_DISABLE_OUTPUT_ESCAPING](https://developer.android.com/reference/javax/xml/transform/Result#PI_DISABLE_OUTPUT_ESCAPING) The name of the processing instruction that is sent if the result tree disables output escaping.                                                                                      | | [String](https://developer.android.com/reference/java/lang/String) | [PI_ENABLE_OUTPUT_ESCAPING](https://developer.android.com/reference/javax/xml/transform/Result#PI_ENABLE_OUTPUT_ESCAPING) The name of the processing instruction that is sent if the result tree enables output escaping at some point after having received a PI_DISABLE_OUTPUT_ESCAPING processing instruction. | |

|                                                                                                                                ### Public constructors                                                                                                                                ||
|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---|
| ` `[StreamResult](https://developer.android.com/reference/javax/xml/transform/stream/StreamResult#StreamResult())`() ` Zero-argument default constructor.                                                                                                                          |
| ` `[StreamResult](https://developer.android.com/reference/javax/xml/transform/stream/StreamResult#StreamResult(java.io.File))`(`[File](https://developer.android.com/reference/java/io/File)` f) ` Construct a StreamResult from a File.                                           |
| ` `[StreamResult](https://developer.android.com/reference/javax/xml/transform/stream/StreamResult#StreamResult(java.io.OutputStream))`(`[OutputStream](https://developer.android.com/reference/java/io/OutputStream)` outputStream) ` Construct a StreamResult from a byte stream. |
| ` `[StreamResult](https://developer.android.com/reference/javax/xml/transform/stream/StreamResult#StreamResult(java.io.Writer))`(`[Writer](https://developer.android.com/reference/java/io/Writer)` writer) ` Construct a StreamResult from a character stream.                    |
| ` `[StreamResult](https://developer.android.com/reference/javax/xml/transform/stream/StreamResult#StreamResult(java.lang.String))`(`[String](https://developer.android.com/reference/java/lang/String)` systemId) ` Construct a StreamResult from a URL.                           |

|                                                                                                                                                                                                                           ### Public methods                                                                                                                                                                                                                            ||
|---------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| ` `[OutputStream](https://developer.android.com/reference/java/io/OutputStream) | ` `[getOutputStream](https://developer.android.com/reference/javax/xml/transform/stream/StreamResult#getOutputStream())`() ` Get the byte stream that was set with setOutputStream.                                                                                                                                                                                                    |
| ` `[String](https://developer.android.com/reference/java/lang/String)           | ` `[getSystemId](https://developer.android.com/reference/javax/xml/transform/stream/StreamResult#getSystemId())`() ` Get the system identifier that was set with setSystemId.                                                                                                                                                                                                          |
| ` `[Writer](https://developer.android.com/reference/java/io/Writer)             | ` `[getWriter](https://developer.android.com/reference/javax/xml/transform/stream/StreamResult#getWriter())`() ` Get the character stream that was set with setWriter.                                                                                                                                                                                                                 |
| ` void`                                                                         | ` `[setOutputStream](https://developer.android.com/reference/javax/xml/transform/stream/StreamResult#setOutputStream(java.io.OutputStream))`(`[OutputStream](https://developer.android.com/reference/java/io/OutputStream)` outputStream) ` Set the ByteStream that is to be written to.                                                                                               |
| ` void`                                                                         | ` `[setSystemId](https://developer.android.com/reference/javax/xml/transform/stream/StreamResult#setSystemId(java.lang.String))`(`[String](https://developer.android.com/reference/java/lang/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](https://developer.android.com/reference/javax/xml/transform/stream/StreamResult#setSystemId(java.io.File))`(`[File](https://developer.android.com/reference/java/io/File)` f) ` <br /> Set the system ID from a`File`reference.                                                                                                                                       |
| ` void`                                                                         | ` `[setWriter](https://developer.android.com/reference/javax/xml/transform/stream/StreamResult#setWriter(java.io.Writer))`(`[Writer](https://developer.android.com/reference/java/io/Writer)` writer) ` Set the writer that is to receive the result.                                                                                                                                  |

| ### Inherited methods |
|-----------------------|---|
| From class` `[java.lang.Object](https://developer.android.com/reference/java/lang/Object)` ` |--------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ` `[Object](https://developer.android.com/reference/java/lang/Object)          | ` `[clone](https://developer.android.com/reference/java/lang/Object#clone())`() ` Creates and returns a copy of this object.                                                                                                                                                      | | ` boolean`                                                                     | ` `[equals](https://developer.android.com/reference/java/lang/Object#equals(java.lang.Object))`(`[Object](https://developer.android.com/reference/java/lang/Object)` obj) ` Indicates whether some other object is "equal to" this one.                                           | | ` void`                                                                        | ` `[finalize](https://developer.android.com/reference/java/lang/Object#finalize())`() ` Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.                                                          | | ` final `[Class](https://developer.android.com/reference/java/lang/Class)`<?>` | ` `[getClass](https://developer.android.com/reference/java/lang/Object#getClass())`() ` Returns the runtime class of this`Object`.                                                                                                                                                | | ` int`                                                                         | ` `[hashCode](https://developer.android.com/reference/java/lang/Object#hashCode())`() ` Returns a hash code value for the object.                                                                                                                                                 | | ` final void`                                                                  | ` `[notify](https://developer.android.com/reference/java/lang/Object#notify())`() ` Wakes up a single thread that is waiting on this object's monitor.                                                                                                                            | | ` final void`                                                                  | ` `[notifyAll](https://developer.android.com/reference/java/lang/Object#notifyAll())`() ` Wakes up all threads that are waiting on this object's monitor.                                                                                                                         | | ` `[String](https://developer.android.com/reference/java/lang/String)          | ` `[toString](https://developer.android.com/reference/java/lang/Object#toString())`() ` Returns a string representation of the object.                                                                                                                                            | | ` final void`                                                                  | ` `[wait](https://developer.android.com/reference/java/lang/Object#wait(long,%20int))`(long timeoutMillis, int nanos) ` Causes the current thread to wait until it is awakened, typically by being*notified* or*interrupted*, or until a certain amount of real time has elapsed. | | ` final void`                                                                  | ` `[wait](https://developer.android.com/reference/java/lang/Object#wait(long))`(long timeoutMillis) ` Causes the current thread to wait until it is awakened, typically by being*notified* or*interrupted*, or until a certain amount of real time has elapsed.                   | | ` final void`                                                                  | ` `[wait](https://developer.android.com/reference/java/lang/Object#wait())`() ` Causes the current thread to wait until it is awakened, typically by being*notified* or*interrupted*.                                                                                             | ||
| From interface` `[javax.xml.transform.Result](https://developer.android.com/reference/javax/xml/transform/Result)` ` |--------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ` abstract `[String](https://developer.android.com/reference/java/lang/String) | ` `[getSystemId](https://developer.android.com/reference/javax/xml/transform/Result#getSystemId())`() ` Get the system identifier that was set with setSystemId.                                                                                | | ` abstract void`                                                               | ` `[setSystemId](https://developer.android.com/reference/javax/xml/transform/Result#setSystemId(java.lang.String))`(`[String](https://developer.android.com/reference/java/lang/String)` systemId) ` Set the system identifier for this Result. | ||

## Constants

### FEATURE

Added in[API level 8](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  

```
public static final String FEATURE
```

If[TransformerFactory.getFeature(String)](https://developer.android.com/reference/javax/xml/transform/TransformerFactory#getFeature(java.lang.String))returns true when passed this value as an argument, the Transformer supports Result output of this type.

<br />

Constant Value: "http://javax.xml.transform.stream.StreamResult/feature"

## Public constructors

### StreamResult

Added in[API level 8](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  

```
public StreamResult ()
```

Zero-argument default constructor.

<br />

### StreamResult

Added in[API level 8](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  

```
public StreamResult (File f)
```

Construct a StreamResult from a File.

<br />

|                     Parameters                      ||
|-----|------------------------------------------------|
| `f` | `File`: Must a non-null File reference. <br /> |

### StreamResult

Added in[API level 8](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  

```
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.

<br />

|                               Parameters                               ||
|----------------|--------------------------------------------------------|
| `outputStream` | `OutputStream`: A valid OutputStream reference. <br /> |

### StreamResult

Added in[API level 8](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  

```
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.

<br />

|                      Parameters                      ||
|----------|--------------------------------------------|
| `writer` | `Writer`: A valid Writer reference. <br /> |

### StreamResult

Added in[API level 8](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  

```
public StreamResult (String systemId)
```

Construct a StreamResult from a URL.

<br />

|                                   Parameters                                   ||
|------------|--------------------------------------------------------------------|
| `systemId` | `String`: Must be a String that conforms to the URI syntax. <br /> |

## Public methods

### getOutputStream

Added in[API level 8](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  

```
public OutputStream getOutputStream ()
```

Get the byte stream that was set with setOutputStream.

<br />

|                                                                                                     Returns                                                                                                      ||
|------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------|
| [OutputStream](https://developer.android.com/reference/java/io/OutputStream) | The byte stream that was set with setOutputStream, or null if setOutputStream or the ByteStream constructor was not called. <br /> |

### getSystemId

Added in[API level 8](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  

```
public String getSystemId ()
```

Get the system identifier that was set with setSystemId.

<br />

|                                                                                Returns                                                                                 ||
|--------------------------------------------------------------------|----------------------------------------------------------------------------------------------------|
| [String](https://developer.android.com/reference/java/lang/String) | The system identifier that was set with setSystemId, or null if setSystemId was not called. <br /> |

### getWriter

Added in[API level 8](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  

```
public Writer getWriter ()
```

Get the character stream that was set with setWriter.

<br />

|                                                                                          Returns                                                                                          ||
|------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------|
| [Writer](https://developer.android.com/reference/java/io/Writer) | The character stream that was set with setWriter, or null if setWriter or the Writer constructor was not called. <br /> |

### setOutputStream

Added in[API level 8](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  

```
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.

<br />

|                               Parameters                               ||
|----------------|--------------------------------------------------------|
| `outputStream` | `OutputStream`: A valid OutputStream reference. <br /> |

### setSystemId

Added in[API level 8](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  

```
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).

<br />

|                             Parameters                              ||
|------------|---------------------------------------------------------|
| `systemId` | `String`: The system identifier as a URI string. <br /> |

### setSystemId

Added in[API level 8](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  

```
public void setSystemId (File f)
```

<br />

Set the system ID from a`File`reference.

Note the use of[File.toURI()](https://developer.android.com/reference/java/io/File#toURI())and[File.toURL()](https://developer.android.com/reference/java/io/File#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](https://developer.android.com/reference/java/lang/NoSuchMethodException)is thrown by the attempt to use`toURI()`.

<br />

<br />

|                     Parameters                      ||
|-----|------------------------------------------------|
| `f` | `File`: Must a non-null File reference. <br /> |

### setWriter

Added in[API level 8](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  

```
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.

<br />

|                      Parameters                      ||
|----------|--------------------------------------------|
| `writer` | `Writer`: A valid Writer reference. <br /> |