| 
 | ||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
java.lang.Objectorg.apache.commons.net.io.Util
public final class Util
The Util class cannot be instantiated and stores short static convenience methods that are often quite useful.
CopyStreamException, 
CopyStreamListener, 
CopyStreamAdapter| Field Summary | |
|---|---|
| static int | DEFAULT_COPY_BUFFER_SIZEThe default buffer size used by copyStream andcopyReader . | 
| Method Summary | |
|---|---|
| static long | copyReader(Reader source,
                     Writer dest)Same as  copyReader(source, dest, DEFAULT_COPY_BUFFER_SIZE);  | 
| 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,
                     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 | copyStream(InputStream source,
                     OutputStream dest)Same as  copyStream(source, dest, DEFAULT_COPY_BUFFER_SIZE);  | 
| 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,
                     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,
                     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. | 
| Methods inherited from class java.lang.Object | 
|---|
| clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait | 
| Field Detail | 
|---|
public static final int DEFAULT_COPY_BUFFER_SIZE
copyStream 
 and copyReader . It's value is 1024.
| Method Detail | 
|---|
public static final long copyStream(InputStream source,
                                    OutputStream dest,
                                    int bufferSize,
                                    long streamSize,
                                    CopyStreamListener listener,
                                    boolean flush)
                             throws CopyStreamException
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.
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.
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.
public static final long copyStream(InputStream source,
                                    OutputStream dest,
                                    int bufferSize,
                                    long streamSize,
                                    CopyStreamListener listener)
                             throws CopyStreamException
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.
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.
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.
public static final long copyStream(InputStream source,
                                    OutputStream dest,
                                    int bufferSize)
                             throws CopyStreamException
source - The source InputStream.dest - The destination OutputStream.
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.
public static final long copyStream(InputStream source,
                                    OutputStream dest)
                             throws CopyStreamException
 copyStream(source, dest, DEFAULT_COPY_BUFFER_SIZE); 
CopyStreamException
public static final long copyReader(Reader source,
                                    Writer dest,
                                    int bufferSize,
                                    long streamSize,
                                    CopyStreamListener listener)
                             throws CopyStreamException
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.
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.
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.
public static final long copyReader(Reader source,
                                    Writer dest,
                                    int bufferSize)
                             throws CopyStreamException
source - The source Reader.dest - The destination writer.bufferSize - The number of characters to buffer during the copy.
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.
public static final long copyReader(Reader source,
                                    Writer dest)
                             throws CopyStreamException
 copyReader(source, dest, DEFAULT_COPY_BUFFER_SIZE); 
CopyStreamException| 
 | ||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||