com.complexible.common.nio.file

Class Paths2

java.lang.Object

com.complexible.common.nio.file.Paths2

public final class Paths2
extends Object

Utility class for working with Path

Since:

5.0

Version:

5.0

Author:

Michael Grove

Method Summary

Modifier and Type	Method and Description
static com.google.common.io.ByteSource	asByteSource(Path thePath)
static Path	classPath(String thePath)
static Path	createTempDir()
static void	delete(Path thePath)
static void	deleteContents(Path thePath)
static void	deleteOnExit(Path thePath)
static Stream<Path>	list(Path theFile) Convenience wrapper for Files.list(java.nio.file.Path) which simply wraps the checked IOException as an UncheckedIOException.
static long	numFilesInDirectory(Path directory) Returns the number of files in a directory.
static long	numFilesInDirectoryByPattern(Path directory, String globPattern) Returns the number of files in a directory that match the specified glob pattern.
static long	size(Path theFile) Convenience wrapper for Files.size(java.nio.file.Path); returns the file size or 0L if the file does not exist like File.length().
static String	toString(Path thePath, Charset theCharset)
static Path	withJarFileSystem(String thePath, Class<?> theClass) Returns a Path object for the given context using a new jar-based FileSystem.
static void	write(String theInput, Path theFile, Charset theCharset)

Methods inherited from class java.lang.Object

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

Method Detail

toString

public static String toString(Path thePath,
                              Charset theCharset)
                       throws IOException

Throws:

IOException

withJarFileSystem

public static Path withJarFileSystem(String thePath,
                                     Class<?> theClass)

Returns a Path object for the given context using a new jar-based FileSystem. The new FileSystem probably needs to be closed after using the Path object.

classPath

public static Path classPath(String thePath)

asByteSource

public static com.google.common.io.ByteSource asByteSource(Path thePath)

deleteOnExit

public static void deleteOnExit(Path thePath)

delete

public static void delete(Path thePath)
                   throws IOException

Throws:

IOException

deleteContents

public static void deleteContents(Path thePath)
                           throws IOException

Throws:

IOException

write

public static void write(String theInput,
                         Path theFile,
                         Charset theCharset)
                  throws IOException

Throws:

IOException

createTempDir

public static Path createTempDir()

list

@MustBeClosed
public static Stream<Path> list(Path theFile)

Convenience wrapper for Files.list(java.nio.file.Path) which simply wraps the checked IOException as an UncheckedIOException.

Parameters:

theFile - the file

Returns:

the result of Files.list(java.nio.file.Path)

Throws:

UncheckedIOException - if Files.list(java.nio.file.Path) throws an IOException

numFilesInDirectory

public static long numFilesInDirectory(Path directory)

Returns the number of files in a directory.

Throws:

IllegalArgumentException - if the file could not otherwise be opened because it is not a directory (optional specific exception)

UncheckedIOException - if an I/O error occurs when opening the directory

numFilesInDirectoryByPattern

public static long numFilesInDirectoryByPattern(Path directory,
                                                String globPattern)

Returns the number of files in a directory that match the specified glob pattern.

Throws:

IllegalArgumentException - if the file could not otherwise be opened because it is not a directory (optional specific exception)

UncheckedIOException - if an I/O error occurs when opening the directory

size

public static long size(Path theFile)

Convenience wrapper for Files.size(java.nio.file.Path); returns the file size or 0L if the file does not exist like File.length().

Parameters:

theFile - the file

Returns:

the result of Files.size(java.nio.file.Path), or 0L if the file does not exist