oracle.dbtools.plugin.api.io

Interface IOStreams

public interface IOStreams

Methods for working with InputStream, OutputStream, Readable, and Appendable streams.

Author:

cdivilly

Method Summary

Methods

Modifier and Type	Method and Description
byte[]	asByteArray(InputStream is) buffer the contents of the specified byte stream into a byte[] array.
InputStream	asInputStream(byte[] bytes) Adapt the specified byte array to an instance of InputStream.
InputStream	asInputStream(CharSequence text) Convert a CharSequence into an InputStream instance
String	asString(InputStream is) Buffer the contents of the specified byte stream into a String.
String	asString(Readable r) Buffer the contents of the specified character stream into a String .
long	copy(InputStream is, OutputStream os) Copy the contents of a InputStream to an OutputStream
long	copy(Readable source, Appendable destination) Copy the contents of a Readable (input character stream) to an Appendable (output character stream)
long	copy(ReadableByteChannel source, WritableByteChannel destination) Copy the contents of a ReadableByteChannel (input byte stream) to a WritableByteChannel (output byte stream)
InputStream	emptyStream() Return an InputStream containing zero bytes
boolean	isEmptyStream(InputStream stream) Checks if the specified InputStream is the empty stream instance provided by emptyStream().
InputStream	uncloseable(InputStream in) Wrapper an InputStream so it cannot be closed.

Method Detail

copy

long copy(InputStream is,
        OutputStream os)
          throws IOException

Copy the contents of a InputStream to an OutputStream

Parameters:

is - The stream containing the content

os - The stream to write the content to

Returns:

The number of bytes copied

Throws:

IOException

copy

long copy(Readable source,
        Appendable destination)
          throws IOException

Copy the contents of a Readable (input character stream) to an Appendable (output character stream)

Parameters:

source - The stream containing the content

destination - The stream to write the content to

Returns:

The number of characters copied

Throws:

IOException

copy

long copy(ReadableByteChannel source,
        WritableByteChannel destination)
          throws IOException

Copy the contents of a ReadableByteChannel (input byte stream) to a WritableByteChannel (output byte stream)

Parameters:

source - The stream containing the content

destination - The stream to write the content to

Returns:

The number of bytes copied

Throws:

IOException

emptyStream

InputStream emptyStream()

Return an InputStream containing zero bytes

Returns:

an empty stream

uncloseable

InputStream uncloseable(InputStream in)

Wrapper an InputStream so it cannot be closed.

Parameters:

in - InputStream instance

Returns:

InputStream instance that cannot be closed.

isEmptyStream

boolean isEmptyStream(InputStream stream)

Checks if the specified InputStream is the empty stream instance provided by emptyStream().

Parameters:

stream - The stream to be tested

Returns:

true if the specified InputStream is the same instance, false otherwise.

asString

String asString(InputStream is)
                throws IOException

Buffer the contents of the specified byte stream into a String. The contents of the byte stream must be encoded in UTF-8.

Parameters:

is - The byte stream

Returns:

The buffered stream as a String

Throws:

IOException

asString

String asString(Readable r)
                throws IOException

Buffer the contents of the specified character stream into a String .

Parameters:

r - The character stream

Returns:

The buffered stream as a String

Throws:

IOException

asInputStream

InputStream asInputStream(CharSequence text)
                          throws IOException

Convert a CharSequence into an InputStream instance

Parameters:

text - The text to be transformed into an InputStream

Returns:

InputStream instance

Throws:

IOException

asInputStream

InputStream asInputStream(byte[] bytes)

Adapt the specified byte array to an instance of InputStream.

Parameters:

bytes - The bytes to be exposed as a stream

Returns:

The InputStream instance.

asByteArray

byte[] asByteArray(InputStream is)
                   throws IOException

buffer the contents of the specified byte stream into a byte[] array.

Parameters:

is - The byte stream

Returns:

byte[] buffer containing the entire contents of the stream

Throws:

IOException