co.codewizards.cloudstore.core.io

Class StreamUtil

java.lang.Object

co.codewizards.cloudstore.core.io.StreamUtil

public final class StreamUtil
extends Object

Utility class for working with IInputStream and IOutputStream.

Most importantly, the methods here are used for conversions:

• InputStream <=> IInputStream
• OutputStream <=> IOutputStream

Author:

Marco หงุ่ยตระกูล-Schulze - marco at codewizards dot co

Method Summary

Modifier and Type	Method and Description
static InputStream	castStream(IInputStream in) Casts an IInputStream as InputStream, if possible; or converts it by instantiating a new bridge instance, if a simple Java cast is not possible.
static IInputStream	castStream(InputStream in) Casts an InputStream as IInputStream, if possible; or converts it by instantiating a new bridge instance, if a simple Java cast is not possible.
static OutputStream	castStream(IOutputStream out) Casts an IOutputStream as OutputStream, if possible; or converts it by instantiating a new bridge instance, if a simple Java cast is not possible.
static IOutputStream	castStream(OutputStream out) Casts an OutputStream as IOutputStream, if possible; or converts it by instantiating a new bridge instance, if a simple Java cast is not possible.

Methods inherited from class java.lang.Object

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

Method Detail

castStream

public static IInputStream castStream(InputStream in)

Casts an InputStream as IInputStream, if possible; or converts it by instantiating a new bridge instance, if a simple Java cast is not possible.

Note that the bridge object (if its instantiation was needed) both subclasses InputStream and implements IInputStream. Thus subsequent castStream(...) invocations on the result object always are simple Java casts.

Parameters:

in - the InputStream to be converted (by Java cast or bridge object). May be null.

Returns:

either the same instance as in, if a simple Java cast was possible; or a new bridge object implementing the desired interface and delegating to the underlying object. May be null (only if the input argument is null).

castStream

public static InputStream castStream(IInputStream in)

Casts an IInputStream as InputStream, if possible; or converts it by instantiating a new bridge instance, if a simple Java cast is not possible.

Note that the bridge object (if its instantiation was needed) both subclasses InputStream and implements IInputStream. Thus subsequent castStream(...) invocations on the result object always are simple Java casts.

Parameters:

in - the IInputStream to be converted (by Java cast or bridge object). May be null.

Returns:

either the same instance as in, if a simple Java cast was possible; or a new bridge object extending InputStream and delegating to the underlying object. May be null (only if the input argument is null).

castStream

public static IOutputStream castStream(OutputStream out)

Casts an OutputStream as IOutputStream, if possible; or converts it by instantiating a new bridge instance, if a simple Java cast is not possible.

Note that the bridge object (if its instantiation was needed) both subclasses OutputStream and implements IOutputStream. Thus subsequent castStream(...) invocations on the result object always are simple Java casts.

Parameters:

out - the OutputStream to be converted (by Java cast or bridge object). May be null.

Returns:

either the same instance as out, if a simple Java cast was possible; or a new bridge object implementing the desired interface and delegating to the underlying object. May be null (only if the input argument is null).

castStream

public static OutputStream castStream(IOutputStream out)

Casts an IOutputStream as OutputStream, if possible; or converts it by instantiating a new bridge instance, if a simple Java cast is not possible.

Note that the bridge object (if its instantiation was needed) both subclasses OutputStream and implements IOutputStream. Thus subsequent castStream(...) invocations on the result object always are simple Java casts.

Parameters:

out - the IOutputStream to be converted (by Java cast or bridge object). May be null.

Returns:

either the same instance as out, if a simple Java cast was possible; or a new bridge object extending OutputStream and delegating to the underlying object. May be null (only if the input argument is null).