org.apache.commons.net.io

Class Util

java.lang.Object
|
+--org.apache.commons.net.io.Util

public final class Util
extends java.lang.Object

The Util class cannot be instantiated and stores short static convenience methods that are often quite useful.

Author:

Daniel F. Savarese

Field Summary

static int

DEFAULT_COPY_BUFFER_SIZE

The default buffer size used by copyStream and copyReader .

Method Summary

static long	copyReader(Reader source, Writer dest, int bufferSize, long streamSize, CopyStreamListener listener) Copies the contents of a Reader to a Writer using a copy buffer of a given size and notifies the provided CopyStreamListener of the progress of the copy operation by calling its bytesTransferred(long, int) method after each write to the destination.
static long	copyReader(Reader source, Writer dest, int bufferSize) Copies the contents of a Reader to a Writer using a copy buffer of a given size.
static long	copyReader(Reader source, Writer dest) Same as copyReader(source, dest, DEFAULT_COPY_BUFFER_SIZE);
static long	copyStream(InputStream source, OutputStream dest, int bufferSize, long streamSize, CopyStreamListener listener) Copies the contents of an InputStream to an OutputStream using a copy buffer of a given size and notifies the provided CopyStreamListener of the progress of the copy operation by calling its bytesTransferred(long, int) method after each write to the destination.
static long	copyStream(InputStream source, OutputStream dest, int bufferSize) Copies the contents of an InputStream to an OutputStream using a copy buffer of a given size.
static long	copyStream(InputStream source, OutputStream dest) Same as copyStream(source, dest, DEFAULT_COPY_BUFFER_SIZE);

Field Details

DEFAULT_COPY_BUFFER_SIZE

public static final int DEFAULT_COPY_BUFFER_SIZE

The default buffer size used by copyStream and copyReader . It's value is 1024.

Method Details

copyReader

public static final long copyReader(Reader source, Writer dest)

Same as copyReader(source, dest, DEFAULT_COPY_BUFFER_SIZE);

Parameters:

source
dest

copyReader

public static final long copyReader(Reader source, Writer dest, int bufferSize)

Copies the contents of a Reader to a Writer using a copy buffer of a given size. The contents of the Reader are read until its end is reached, but neither the source nor the destination are closed. You must do this yourself outside of the method call. The number of characters read/written is returned.

Parameters:

source - The source Reader.
dest - The destination writer.
bufferSize - The number of characters to buffer during the copy.

Returns:

The number of characters read/written in the copy operation.

Throws:

CopyStreamException - If an error occurs while reading from the source or writing to the destination.

copyReader

public static final long copyReader(Reader source, Writer dest, int bufferSize, long streamSize, CopyStreamListener listener)

Copies the contents of a Reader to a Writer using a copy buffer of a given size and notifies the provided CopyStreamListener of the progress of the copy operation by calling its bytesTransferred(long, int) method after each write to the destination. If you wish to notify more than one listener you should use a CopyStreamAdapter as the listener and register the additional listeners with the CopyStreamAdapter.

The contents of the Reader are read until its end is reached, but neither the source nor the destination are closed. You must do this yourself outside of the method call. The number of characters read/written is returned.

Parameters:

source - The source Reader.
dest - The destination writer.
bufferSize - The number of characters to buffer during the copy.
streamSize - The number of characters in the stream being copied.
listener - The CopyStreamListener to notify of progress.

Returns:

The number of characters read/written in the copy operation.

Throws:

CopyStreamException - If an error occurs while reading from the source or writing to the destination.

copyStream

public static final long copyStream(InputStream source, OutputStream dest)

Same as copyStream(source, dest, DEFAULT_COPY_BUFFER_SIZE);

Parameters:

source
dest

copyStream

public static final long copyStream(InputStream source, OutputStream dest, int bufferSize)

Copies the contents of an InputStream to an OutputStream using a copy buffer of a given size. The contents of the InputStream are read until the end of the stream is reached, but neither the source nor the destination are closed. You must do this yourself outside of the method call. The number of bytes read/written is returned.

Parameters:

source - The source InputStream.
dest - The destination OutputStream.
bufferSize

Returns:

The number of bytes read/written in the copy operation.

Throws:

CopyStreamException - If an error occurs while reading from the source or writing to the destination.

copyStream

public static final long copyStream(InputStream source, OutputStream dest, int bufferSize, long streamSize, CopyStreamListener listener)

Copies the contents of an InputStream to an OutputStream using a copy buffer of a given size and notifies the provided CopyStreamListener of the progress of the copy operation by calling its bytesTransferred(long, int) method after each write to the destination. If you wish to notify more than one listener you should use a CopyStreamAdapter as the listener and register the additional listeners with the CopyStreamAdapter.

The contents of the InputStream are read until the end of the stream is reached, but neither the source nor the destination are closed. You must do this yourself outside of the method call. The number of bytes read/written is returned.

Parameters:

source - The source InputStream.
dest - The destination OutputStream.
bufferSize - The number of bytes to buffer during the copy.
streamSize - The number of bytes in the stream being copied.
listener - The CopyStreamListener to notify of progress.

Throws:

CopyStreamException - If an error occurs while reading from the source or writing to the destination.