Package org.eclipse.net4j.util.io

# Klasse DelegatingOutputStream

java.lang.Object
java.io.OutputStream
org.eclipse.net4j.util.io.DelegatingOutputStream

Alle implementierten Schnittstellen:
  `Closeable`, `Flushable`, `AutoCloseable`

Bekannte direkte Unterklassen:
  `XOROutputStream`

public class DelegatingOutputStream extends OutputStream
This class is the superclass of all classes that filter output streams. These streams sit on top of an already existing output stream (the underlying output stream) which it uses as its basic sink of data, but possibly transforming the data along the way or providing additional functionality.

The class `DelegatingOutputStream` itself simply overrides all methods of `OutputStream` with versions that pass all requests to the underlying output stream. Subclasses of `DelegatingOutputStream` may further override some of these methods as well as provide additional methods and fields.

Note: The only difference to `FilterOutputStream` is that `DelegatingOutputStream` does not override `OutputStream.write(byte[])` or `OutputStream.write(byte[], int, int)` but rather exposes the original implementations of `InputStream` which call `write(int)` instead of their delegate counterparts.

Autor:
  Eike Stepper

## Feldübersicht

Felder
Modifizierer und Typ
Feld
Beschreibung
`protected OutputStream`
`out`
The underlying output stream to be filtered.

## Konstruktorübersicht

Konstruktoren
Konstruktor
Beschreibung
`DelegatingOutputStream(OutputStream out)`
Creates an output stream filter built on top of the specified underlying output stream.

## Methodenübersicht

Modifizierer und Typ
Methode
Beschreibung
`void`
`close()`
Closes this output stream and releases any system resources associated with the stream.
`void`
`flush()`
Flushes this output stream and forces any buffered output bytes to be written out to the stream.
`OutputStream`
`getDelegate()`
`void`
`write(int b)`
Writes the specified `byte` to this output stream.

### Von Klasse geerbte Methoden java.io.OutputStream

`nullOutputStream, write, write`

### Von Klasse geerbte Methoden java.lang.Object

`clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

## Felddetails

### out

protected OutputStream out
The underlying output stream to be filtered.

## Konstruktordetails

### DelegatingOutputStream

public DelegatingOutputStream(OutputStream out)
Creates an output stream filter built on top of the specified underlying output stream.

Parameter:
  `out` - the underlying output stream to be assigned to the field `this.out` for later use, or `null` if this instance is to be created without an underlying stream.

## Methodendetails

### getDelegate

public OutputStream getDelegate()

### write

public void write(int b) throws IOException
Writes the specified `byte` to this output stream.

The `write` method of `DelegatingOutputStream` calls the `write` method of its underlying output stream, that is, it performs `out.write(b)`.

Implements the abstract `write` method of `OutputStream`.

Angegeben von:
  `write` in Klasse `OutputStream`
Parameter:
  `b` - the `byte`.
Löst aus:
  `IOException` - if an I/O error occurs.

### flush

public void flush() throws IOException
Flushes this output stream and forces any buffered output bytes to be written out to the stream.

The `flush` method of `DelegatingOutputStream` calls the `flush` method of its underlying output stream.

Angegeben von:
  `flush` in Schnittstelle `Flushable`
Setzt außer Kraft:
  `flush` in Klasse `OutputStream`
Löst aus:
  `IOException` - if an I/O error occurs.
Siehe auch:
  - `out`

### close

public void close() throws IOException
Closes this output stream and releases any system resources associated with the stream.

The `close` method of `DelegatingOutputStream` calls its `flush` method, and then calls the `close` method of its underlying output stream.

Angegeben von:
  `close` in Schnittstelle `AutoCloseable`
Angegeben von:
  `close` in Schnittstelle `Closeable`
Setzt außer Kraft:
  `close` in Klasse `OutputStream`
Löst aus:
  `IOException` - if an I/O error occurs.
Siehe auch:
  - `flush()`
  - `out`