public final class IOUtils
extends java.lang.Object
Modifier and Type | Class and Description |
---|---|
static interface |
IOUtils.IOConsumer<T>
An IO operation with a single input.
|
Modifier and Type | Field and Description |
---|---|
static java.lang.String |
UTF_8
UTF-8 charset string.
|
Modifier | Constructor and Description |
---|---|
private |
IOUtils() |
Modifier and Type | Method and Description |
---|---|
static <T> void |
applyToAll(java.util.Collection<T> collection,
IOUtils.IOConsumer<T> consumer)
Applies the consumer to all non-null elements in the collection even if an exception is thrown.
|
static void |
close(java.io.Closeable... objects)
Closes all given Closeables.
|
static void |
close(java.lang.Iterable<? extends java.io.Closeable> objects)
Closes all given Closeables.
|
static void |
closeWhileHandlingException(java.io.Closeable... objects)
Closes all given Closeables, suppressing all thrown exceptions.
|
static void |
closeWhileHandlingException(java.lang.Iterable<? extends java.io.Closeable> objects)
Closes all given Closeables, suppressing all thrown non
VirtualMachineError exceptions. |
static void |
deleteFiles(Directory dir,
java.util.Collection<java.lang.String> names)
Deletes all given file names.
|
static void |
deleteFilesIfExist(java.util.Collection<? extends java.nio.file.Path> files)
Deletes all given Paths, if they exist.
|
static void |
deleteFilesIfExist(java.nio.file.Path... files)
Deletes all given Paths, if they exist.
|
static void |
deleteFilesIgnoringExceptions(java.util.Collection<? extends java.nio.file.Path> files)
Deletes all given files, suppressing all thrown IOExceptions.
|
static void |
deleteFilesIgnoringExceptions(Directory dir,
java.util.Collection<java.lang.String> files)
Deletes all given files, suppressing all thrown IOExceptions.
|
static void |
deleteFilesIgnoringExceptions(Directory dir,
java.lang.String... files) |
static void |
deleteFilesIgnoringExceptions(java.nio.file.Path... files)
Deletes all given files, suppressing all thrown IOExceptions.
|
static void |
fsync(java.nio.file.Path fileToSync,
boolean isDir)
Ensure that any writes to the given file is written to the storage device that contains it.
|
static java.io.Reader |
getDecodingReader(java.lang.Class<?> clazz,
java.lang.String resource,
java.nio.charset.Charset charSet)
Opens a Reader for the given resource using a
CharsetDecoder . |
static java.io.Reader |
getDecodingReader(java.io.InputStream stream,
java.nio.charset.Charset charSet)
Wrapping the given
InputStream in a reader using a CharsetDecoder . |
(package private) static java.nio.file.FileStore |
getFileStore(java.nio.file.Path path) |
(package private) static java.lang.String |
getMountPoint(java.nio.file.FileStore store) |
static void |
reThrow(java.lang.Throwable th)
Deprecated.
This method is deprecated in favor of
rethrowAlways(java.lang.Throwable) . Code should
be updated to rethrowAlways(java.lang.Throwable) and guarded with an additional null-argument check
(because rethrowAlways(java.lang.Throwable) is not accepting null arguments). |
static java.lang.Error |
rethrowAlways(java.lang.Throwable th)
This utility method takes a previously caught (non-null)
Throwable and rethrows either the original argument
if it was a subclass of the IOException or an
RuntimeException with the cause set to the argument. |
static void |
reThrowUnchecked(java.lang.Throwable th)
Deprecated.
This method is deprecated in favor of
rethrowAlways(java.lang.Throwable) . Code should
be updated to rethrowAlways(java.lang.Throwable) and guarded with an additional null-argument check
(because rethrowAlways(java.lang.Throwable) is not accepting null arguments). |
private static java.util.LinkedHashMap<java.nio.file.Path,java.lang.Throwable> |
rm(java.util.LinkedHashMap<java.nio.file.Path,java.lang.Throwable> unremoved,
java.nio.file.Path... locations) |
static void |
rm(java.nio.file.Path... locations)
Deletes one or more files or directories (and everything underneath it).
|
static boolean |
spins(Directory dir)
If the dir is an
FSDirectory or wraps one via possibly
nested FilterDirectory or FileSwitchDirectory ,
this returns spins(Path) for the wrapped directory,
else, true. |
static boolean |
spins(java.nio.file.Path path)
Rough Linux-only heuristics to determine whether the provided
Path is backed by spinning storage. |
(package private) static boolean |
spinsLinux(java.nio.file.Path path) |
static <T extends java.lang.Throwable> |
useOrSuppress(T first,
T second)
Returns the second throwable if the first is null otherwise adds the second as suppressed to the first
and returns it.
|
public static final java.lang.String UTF_8
Where possible, use StandardCharsets.UTF_8
instead,
as using the String constant may slow things down.
StandardCharsets.UTF_8
public static void close(java.io.Closeable... objects) throws java.io.IOException
objects
- objects to call close() onjava.io.IOException
public static void close(java.lang.Iterable<? extends java.io.Closeable> objects) throws java.io.IOException
java.io.IOException
close(Closeable...)
public static void closeWhileHandlingException(java.io.Closeable... objects)
objects
- objects to call close() onpublic static void closeWhileHandlingException(java.lang.Iterable<? extends java.io.Closeable> objects)
VirtualMachineError
exceptions.
Even if a VirtualMachineError
is thrown all given closeable are closed.public static java.io.Reader getDecodingReader(java.io.InputStream stream, java.nio.charset.Charset charSet)
InputStream
in a reader using a CharsetDecoder
.
Unlike Java's defaults this reader will throw an exception if your it detects
the read charset doesn't match the expected Charset
.
Decoding readers are useful to load configuration files, stopword lists or synonym files to detect character set problems. However, it's not recommended to use as a common purpose reader.
stream
- the stream to wrap in a readercharSet
- the expected charsetpublic static java.io.Reader getDecodingReader(java.lang.Class<?> clazz, java.lang.String resource, java.nio.charset.Charset charSet) throws java.io.IOException
CharsetDecoder
.
Unlike Java's defaults this reader will throw an exception if your it detects
the read charset doesn't match the expected Charset
.
Decoding readers are useful to load configuration files, stopword lists or synonym files to detect character set problems. However, it's not recommended to use as a common purpose reader.
clazz
- the class used to locate the resourceresource
- the resource name to loadcharSet
- the expected charsetjava.io.IOException
public static void deleteFilesIgnoringExceptions(Directory dir, java.util.Collection<java.lang.String> files)
Note that the files should not be null.
public static void deleteFilesIgnoringExceptions(Directory dir, java.lang.String... files)
public static void deleteFiles(Directory dir, java.util.Collection<java.lang.String> names) throws java.io.IOException
dir
- Directory to delete files fromnames
- file names to deletejava.io.IOException
public static void deleteFilesIgnoringExceptions(java.nio.file.Path... files)
Some of the files may be null, if so they are ignored.
public static void deleteFilesIgnoringExceptions(java.util.Collection<? extends java.nio.file.Path> files)
Some of the files may be null, if so they are ignored.
public static void deleteFilesIfExist(java.nio.file.Path... files) throws java.io.IOException
files
- files to deletejava.io.IOException
public static void deleteFilesIfExist(java.util.Collection<? extends java.nio.file.Path> files) throws java.io.IOException
files
- files to deletejava.io.IOException
public static void rm(java.nio.file.Path... locations) throws java.io.IOException
java.io.IOException
- if any of the given files (or their subhierarchy files in case
of directories) cannot be removed.private static java.util.LinkedHashMap<java.nio.file.Path,java.lang.Throwable> rm(java.util.LinkedHashMap<java.nio.file.Path,java.lang.Throwable> unremoved, java.nio.file.Path... locations)
public static java.lang.Error rethrowAlways(java.lang.Throwable th) throws java.io.IOException, java.lang.RuntimeException
Throwable
and rethrows either the original argument
if it was a subclass of the IOException
or an
RuntimeException
with the cause set to the argument.
This method never returns any value, even though it declares
a return value of type Error
. The return value declaration
is very useful to let the compiler know that the code path following
the invocation of this method is unreachable. So in most cases the
invocation of this method will be guarded by an if
and
used together with a throw
statement, as in:
if (t != null) throw IOUtils.rethrowAlways(t)
th
- The throwable to rethrow, must not be null.java.io.IOException
- if the argument was an instance of IOExceptionjava.lang.RuntimeException
- with the Throwable.getCause()
set
to the argument, if it was not an instance of IOException.@Deprecated public static void reThrow(java.lang.Throwable th) throws java.io.IOException
rethrowAlways(java.lang.Throwable)
. Code should
be updated to rethrowAlways(java.lang.Throwable)
and guarded with an additional null-argument check
(because rethrowAlways(java.lang.Throwable)
is not accepting null arguments).IOException
or RuntimeException
if it's not null.java.io.IOException
@Deprecated public static void reThrowUnchecked(java.lang.Throwable th)
rethrowAlways(java.lang.Throwable)
. Code should
be updated to rethrowAlways(java.lang.Throwable)
and guarded with an additional null-argument check
(because rethrowAlways(java.lang.Throwable)
is not accepting null arguments).public static void fsync(java.nio.file.Path fileToSync, boolean isDir) throws java.io.IOException
fileToSync
- the file to fsyncisDir
- if true, the given file is a directory (we open for read and ignore IOExceptions,
because not all file systems and operating systems allow to fsync on a directory)java.io.IOException
public static boolean spins(Directory dir) throws java.io.IOException
FSDirectory
or wraps one via possibly
nested FilterDirectory
or FileSwitchDirectory
,
this returns spins(Path)
for the wrapped directory,
else, true.java.io.IOException
- if path
does not exist.public static boolean spins(java.nio.file.Path path) throws java.io.IOException
Path
is backed by spinning storage. For example, this
returns false if the disk is a solid-state disk.path
- a location to check which must exist. the mount point will be determined from this location.java.io.IOException
- if path
does not exist.static boolean spinsLinux(java.nio.file.Path path) throws java.io.IOException
java.io.IOException
static java.nio.file.FileStore getFileStore(java.nio.file.Path path) throws java.io.IOException
java.io.IOException
static java.lang.String getMountPoint(java.nio.file.FileStore store)
public static <T extends java.lang.Throwable> T useOrSuppress(T first, T second)
public static <T> void applyToAll(java.util.Collection<T> collection, IOUtils.IOConsumer<T> consumer) throws java.io.IOException
java.io.IOException