com.cloudera.oryx.common.io

Class IOUtils

java.lang.Object

com.cloudera.oryx.common.io.IOUtils

public final class IOUtils
extends Object

I/O-related utility methods.

Method Summary

Modifier and Type	Method and Description
static int	chooseFreePort() Binds to a free ephemeral port, and then releases it.
static void	closeQuietly(Closeable closeable) Closes a Closeable and logs the exception, if any.
static void	deleteRecursively(Path rootDir) Deletes the given path, and if it is a directory, all files and subdirectories within it.
static List<Path>	listFiles(Path dir, String glob)

Methods inherited from class java.lang.Object

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

Method Detail

deleteRecursively

public static void deleteRecursively(Path rootDir)
                              throws IOException

Deletes the given path, and if it is a directory, all files and subdirectories within it.

Parameters:

rootDir - directory to delete

Throws:

IOException - if any error occurs while deleting files or directories

listFiles

public static List<Path> listFiles(Path dir,
                                   String glob)
                            throws IOException

Parameters:

dir - directory to list

glob - glob pattern for files that should be returned, which can span subdirectories as in patterns like * /*

Returns:

Paths, including both files and directories, matching the glob pattern. No path containing an element whose name starts with "." is returned. Returned paths are also ordered lexicographically.

Throws:

IOException - if an error occurs while accessing the file system

closeQuietly

public static void closeQuietly(Closeable closeable)

Closes a Closeable and logs the exception, if any. This is only suitable for closing objects where a failure to close does not impact correctness -- for example, an input stream that is already fully read, but not an output stream which may fail when flushing final output.

Parameters:

closeable - thing to close

chooseFreePort

public static int chooseFreePort()
                          throws IOException

Binds to a free ephemeral port, and then releases it. The returned port is quite likely to be free for use after this, but is not entirely guaranteed to be.

Returns:

a (probably) free ephemeral port

Throws:

IOException - if an error occurs while binding to a port