com.aoindustries.io

Class IoUtils

java.lang.Object

com.aoindustries.io.IoUtils

public final class IoUtils
extends Object

I/O utilities.

Method Summary

Modifier and Type	Method and Description
static boolean	contentEquals(InputStream in, byte[] contents) Compares the contents retrieved from an InputStream to the provided contents.
static long	copy(InputStream in, OutputStream out) copies without flush.
static long	copy(InputStream in, OutputStream out, boolean flush) Copies all information from one stream to another.
static long	copy(Reader in, Appendable out) Copies all information from one stream to an appendable.
static long	copy(Reader in, StringBuilder out) Copies all information from one stream to another.
static long	copy(Reader in, Writer out) Copies all information from one stream to another.
static byte[]	readFully(InputStream in) Reads an input stream fully (to end of stream), returning a byte[] of the content read.
static void	readFully(InputStream in, byte[] buffer) readFully for any stream.
static void	readFully(InputStream in, byte[] buffer, int off, int len) readFully for any stream.
static String	readFully(Reader in) Reads a reader fully (to end of stream), returning a String of the content read.

Methods inherited from class java.lang.Object

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

Method Detail

copy

public static long copy(InputStream in,
                        OutputStream out)
                 throws IOException

copies without flush.

Throws:

IOException

See Also:

copy(java.io.InputStream, java.io.OutputStream, boolean)

copy

public static long copy(InputStream in,
                        OutputStream out,
                        boolean flush)
                 throws IOException

Copies all information from one stream to another. Internally reuses thread-local buffers to avoid initial buffer zeroing cost and later garbage collection overhead.

Returns:

the number of bytes copied

Throws:

IOException

See Also:

BufferManager.getBytes()

copy

public static long copy(Reader in,
                        Writer out)
                 throws IOException

Copies all information from one stream to another. Internally reuses thread-local buffers to avoid initial buffer zeroing cost and later garbage collection overhead.

Returns:

the number of bytes copied

Throws:

IOException

See Also:

BufferManager.getChars()

copy

public static long copy(Reader in,
                        Appendable out)
                 throws IOException

Copies all information from one stream to an appendable.

Returns:

the number of bytes copied

Throws:

IOException

See Also:

BufferManager.getChars()

copy

public static long copy(Reader in,
                        StringBuilder out)
                 throws IOException

Copies all information from one stream to another. Internally reuses thread-local buffers to avoid initial buffer zeroing cost and later garbage collection overhead.

Returns:

the number of bytes copied

Throws:

IOException

See Also:

BufferManager.getChars()

readFully

public static void readFully(InputStream in,
                             byte[] buffer)
                      throws IOException

readFully for any stream.

Throws:

IOException

readFully

public static void readFully(InputStream in,
                             byte[] buffer,
                             int off,
                             int len)
                      throws IOException

readFully for any stream.

Throws:

IOException

readFully

public static byte[] readFully(InputStream in)
                        throws IOException

Reads an input stream fully (to end of stream), returning a byte[] of the content read.

Throws:

IOException

readFully

public static String readFully(Reader in)
                        throws IOException

Reads a reader fully (to end of stream), returning a String of the content read.

Throws:

IOException

contentEquals

public static boolean contentEquals(InputStream in,
                                    byte[] contents)
                             throws IOException

Compares the contents retrieved from an InputStream to the provided contents.

Returns:

true when the contents exactly match

Throws:

IOException