org.apache.commons.net.io
public final class Util extends Object
See Also: CopyStreamException CopyStreamListener CopyStreamAdapter
Field Summary | |
---|---|
static int | DEFAULT_COPY_BUFFER_SIZE
The default buffer size used by {@link #copyStream copyStream }
and {@link #copyReader 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, boolean flush)
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, 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);
|
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. Should be set to CopyStreamEvent.UNKNOWN_STREAM_SIZE if unknown. listener The CopyStreamListener to notify of progress. If this parameter is null, notification is not attempted.
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. The CopyStreamException will contain the number of bytes confirmed to have been transferred before an IOException occurred, and it will also contain the IOException that caused the error. These values can be retrieved with the CopyStreamException getTotalBytesTransferred() and getIOException() methods.
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. The CopyStreamException will contain the number of bytes confirmed to have been transferred before an IOException occurred, and it will also contain the IOException that caused the error. These values can be retrieved with the CopyStreamException getTotalBytesTransferred() and getIOException() methods.
copyReader(source, dest, DEFAULT_COPY_BUFFER_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 The number of bytes to buffer during the copy. streamSize The number of bytes in the stream being copied. Should be set to CopyStreamEvent.UNKNOWN_STREAM_SIZE if unknown. listener The CopyStreamListener to notify of progress. If this parameter is null, notification is not attempted. flush Whether to flush the output stream after every write. This is necessary for interactive sessions that rely on buffered streams. If you don't flush, the data will stay in the stream buffer.
Throws: CopyStreamException If an error occurs while reading from the source or writing to the destination. The CopyStreamException will contain the number of bytes confirmed to have been transferred before an IOException occurred, and it will also contain the IOException that caused the error. These values can be retrieved with the CopyStreamException getTotalBytesTransferred() and getIOException() methods.
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. Should be set to CopyStreamEvent.UNKNOWN_STREAM_SIZE if unknown. listener The CopyStreamListener to notify of progress. If this parameter is null, notification is not attempted.
Throws: CopyStreamException If an error occurs while reading from the source or writing to the destination. The CopyStreamException will contain the number of bytes confirmed to have been transferred before an IOException occurred, and it will also contain the IOException that caused the error. These values can be retrieved with the CopyStreamException getTotalBytesTransferred() and getIOException() methods.
Parameters: source The source InputStream. dest The destination OutputStream.
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. The CopyStreamException will contain the number of bytes confirmed to have been transferred before an IOException occurred, and it will also contain the IOException that caused the error. These values can be retrieved with the CopyStreamException getTotalBytesTransferred() and getIOException() methods.
copyStream(source, dest, DEFAULT_COPY_BUFFER_SIZE);