org.apache.flink.util

Class IOUtils

java.lang.Object

org.apache.flink.util.IOUtils

public final class IOUtils
extends Object

An utility class for I/O related functionality.

Method Summary

Modifier and Type	Method and Description
static void	cleanup(org.slf4j.Logger log, AutoCloseable... closeables) Close the AutoCloseable objects and ignore any Exception or null pointers.
static void	closeAll(Iterable<? extends AutoCloseable> closeables) Closes all AutoCloseable objects in the parameter, suppressing exceptions.
static void	closeAllQuietly(Iterable<? extends AutoCloseable> closeables) Closes all elements in the iterable with closeQuietly().
static void	closeQuietly(AutoCloseable closeable) Important: This method is expected to never throw an exception.
static void	closeSocket(Socket sock) Closes the socket ignoring IOException.
static void	closeStream(Closeable stream) Closes the stream ignoring IOException.
static void	copyBytes(InputStream in, OutputStream out) Copies from one stream to another.
static void	copyBytes(InputStream in, OutputStream out, boolean close) Copies from one stream to another.
static void	copyBytes(InputStream in, OutputStream out, int buffSize, boolean close) Copies from one stream to another.
static void	readFully(InputStream in, byte[] buf, int off, int len) Reads len bytes in a loop.
static void	skipFully(InputStream in, long len) Similar to readFully().

Methods inherited from class java.lang.Object

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

Method Detail

copyBytes

public static void copyBytes(InputStream in,
                             OutputStream out,
                             int buffSize,
                             boolean close)
                      throws IOException

Copies from one stream to another.

Parameters:

in - InputStream to read from

out - OutputStream to write to

buffSize - the size of the buffer

close - whether or not close the InputStream and OutputStream at the end. The streams are closed in the finally clause.

Throws:

IOException - thrown if an error occurred while writing to the output stream

copyBytes

public static void copyBytes(InputStream in,
                             OutputStream out)
                      throws IOException

Copies from one stream to another. closes the input and output streams at the end.

Parameters:

in - InputStream to read from

out - OutputStream to write to

Throws:

IOException - thrown if an I/O error occurs while copying

copyBytes

public static void copyBytes(InputStream in,
                             OutputStream out,
                             boolean close)
                      throws IOException

Copies from one stream to another.

Parameters:

in - InputStream to read from

out - OutputStream to write to

close - whether or not close the InputStream and OutputStream at the end. The streams are closed in the finally clause.

Throws:

IOException - thrown if an I/O error occurs while copying

readFully

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

Reads len bytes in a loop.

Parameters:

in - The InputStream to read from

buf - The buffer to fill

off - offset from the buffer

len - the length of bytes to read

Throws:

IOException - if it could not read requested number of bytes for any reason (including EOF)

skipFully

public static void skipFully(InputStream in,
                             long len)
                      throws IOException

Similar to readFully(). Skips bytes in a loop.

Parameters:

in - The InputStream to skip bytes from

len - number of bytes to skip

Throws:

IOException - if it could not skip requested number of bytes for any reason (including EOF)

cleanup

public static void cleanup(org.slf4j.Logger log,
                           AutoCloseable... closeables)

Close the AutoCloseable objects and ignore any Exception or null pointers. Must only be used for cleanup in exception handlers.

Parameters:

log - the log to record problems to at debug level. Can be null.

closeables - the objects to close

closeStream

public static void closeStream(Closeable stream)

Closes the stream ignoring IOException. Must only be called in cleaning up from exception handlers.

Parameters:

stream - the stream to close

closeSocket

public static void closeSocket(Socket sock)

Closes the socket ignoring IOException.

Parameters:

sock - the socket to close

closeAll

public static void closeAll(Iterable<? extends AutoCloseable> closeables)
                     throws Exception

Closes all AutoCloseable objects in the parameter, suppressing exceptions. Exception will be emitted after calling close() on every object.

Parameters:

closeables - iterable with closeables to close.

Throws:

Exception - collected exceptions that occurred during closing

closeAllQuietly

public static void closeAllQuietly(Iterable<? extends AutoCloseable> closeables)

Closes all elements in the iterable with closeQuietly().

closeQuietly

public static void closeQuietly(AutoCloseable closeable)

Important: This method is expected to never throw an exception.