org.apache.lucene.util

Class IOUtils

java.lang.Object

org.apache.lucene.util.IOUtils

public final class IOUtils
extends java.lang.Object

This class emulates the new Java 7 "Try-With-Resources" statement. Remove once Lucene is on Java 7.

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	UTF_8 UTF-8 charset string.

Constructor Summary

Constructors

Modifier	Constructor and Description
private	IOUtils()

Method Summary

Modifier and Type	Method and Description
private static void	addSuppressed(java.lang.Throwable exception, java.lang.Throwable suppressed) adds a Throwable to the list of suppressed Exceptions of the first Throwable
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 exceptions.
static void	deleteFiles(Directory dir, java.util.Collection<java.lang.String> names) Deletes all given file names.
static void	deleteFiles(Directory dir, java.lang.String... files)
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) Simple utility method that takes a previously caught Throwable and rethrows either IOException or an unchecked exception.
static void	reThrowUnchecked(java.lang.Throwable th) Simple utility method that takes a previously caught Throwable and rethrows it as an unchecked exception.
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)

Methods inherited from class java.lang.Object

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

Field Detail

UTF_8

public static final java.lang.String UTF_8

UTF-8 charset string.

Where possible, use StandardCharsets.UTF_8 instead, as using the String constant may slow things down.

See Also:

StandardCharsets.UTF_8

Constructor Detail

IOUtils

private IOUtils()

Method Detail

close

public static void close(java.io.Closeable... objects)
                  throws java.io.IOException

Closes all given Closeables. Some of the Closeables may be null; they are ignored. After everything is closed, the method either throws the first exception it hit while closing, or completes normally if there were no exceptions.

Parameters:

objects - objects to call close() on

Throws:

java.io.IOException

close

public static void close(java.lang.Iterable<? extends java.io.Closeable> objects)
                  throws java.io.IOException

Closes all given Closeables.

Throws:

java.io.IOException

See Also:

close(Closeable...)

closeWhileHandlingException

public static void closeWhileHandlingException(java.io.Closeable... objects)

Closes all given Closeables, suppressing all thrown exceptions. Some of the Closeables may be null, they are ignored.

Parameters:

objects - objects to call close() on

closeWhileHandlingException

public static void closeWhileHandlingException(java.lang.Iterable<? extends java.io.Closeable> objects)

Closes all given Closeables, suppressing all thrown exceptions.

See Also:

closeWhileHandlingException(Closeable...)

addSuppressed

private static void addSuppressed(java.lang.Throwable exception,
                                  java.lang.Throwable suppressed)

adds a Throwable to the list of suppressed Exceptions of the first Throwable

Parameters:

exception - this exception should get the suppressed one added

suppressed - the suppressed exception

getDecodingReader

public static java.io.Reader getDecodingReader(java.io.InputStream stream,
                                               java.nio.charset.Charset charSet)

Wrapping the given 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.

Parameters:

stream - the stream to wrap in a reader

charSet - the expected charset

Returns:

a wrapping reader

getDecodingReader

public static java.io.Reader getDecodingReader(java.lang.Class<?> clazz,
                                               java.lang.String resource,
                                               java.nio.charset.Charset charSet)
                                        throws java.io.IOException

Opens a Reader for the given resource 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.

Parameters:

clazz - the class used to locate the resource

resource - the resource name to load

charSet - the expected charset

Returns:

a reader to read the given file

Throws:

java.io.IOException

deleteFilesIgnoringExceptions

public static void deleteFilesIgnoringExceptions(Directory dir,
                                                 java.util.Collection<java.lang.String> files)

Deletes all given files, suppressing all thrown IOExceptions.

Note that the files should not be null.

deleteFilesIgnoringExceptions

public static void deleteFilesIgnoringExceptions(Directory dir,
                                                 java.lang.String... files)

deleteFiles

public static void deleteFiles(Directory dir,
                               java.util.Collection<java.lang.String> names)
                        throws java.io.IOException

Deletes all given file names. Some of the file names may be null; they are ignored. After everything is deleted, the method either throws the first exception it hit while deleting, or completes normally if there were no exceptions.

Parameters:

dir - Directory to delete files from

names - file names to delete

Throws:

java.io.IOException

deleteFiles

public static void deleteFiles(Directory dir,
                               java.lang.String... files)
                        throws java.io.IOException

Throws:

java.io.IOException

deleteFilesIgnoringExceptions

public static void deleteFilesIgnoringExceptions(java.nio.file.Path... files)

Deletes all given files, suppressing all thrown IOExceptions.

Some of the files may be null, if so they are ignored.

deleteFilesIgnoringExceptions

public static void deleteFilesIgnoringExceptions(java.util.Collection<? extends java.nio.file.Path> files)

Deletes all given files, suppressing all thrown IOExceptions.

Some of the files may be null, if so they are ignored.

deleteFilesIfExist

public static void deleteFilesIfExist(java.nio.file.Path... files)
                               throws java.io.IOException

Deletes all given Paths, if they exist. Some of the Files may be null; they are ignored. After everything is deleted, the method either throws the first exception it hit while deleting, or completes normally if there were no exceptions.

Parameters:

files - files to delete

Throws:

java.io.IOException

deleteFilesIfExist

public static void deleteFilesIfExist(java.util.Collection<? extends java.nio.file.Path> files)
                               throws java.io.IOException

Deletes all given Paths, if they exist. Some of the Files may be null; they are ignored. After everything is deleted, the method either throws the first exception it hit while deleting, or completes normally if there were no exceptions.

Parameters:

files - files to delete

Throws:

java.io.IOException

rm

public static void rm(java.nio.file.Path... locations)
               throws java.io.IOException

Deletes one or more files or directories (and everything underneath it).

Throws:

java.io.IOException - if any of the given files (or their subhierarchy files in case of directories) cannot be removed.

rm

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)

reThrow

public static void reThrow(java.lang.Throwable th)
                    throws java.io.IOException

Simple utility method that takes a previously caught Throwable and rethrows either IOException or an unchecked exception. If the argument is null then this method does nothing.

Throws:

java.io.IOException

reThrowUnchecked

public static void reThrowUnchecked(java.lang.Throwable th)

Simple utility method that takes a previously caught Throwable and rethrows it as an unchecked exception. If the argument is null then this method does nothing.

fsync

public static void fsync(java.nio.file.Path fileToSync,
                         boolean isDir)
                  throws java.io.IOException

Ensure that any writes to the given file is written to the storage device that contains it.

Parameters:

fileToSync - the file to fsync

isDir - 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)

Throws:

java.io.IOException

spins

public static boolean spins(Directory dir)
                     throws java.io.IOException

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.

Throws:

java.io.IOException - if path does not exist.

spins

public static boolean spins(java.nio.file.Path path)
                     throws java.io.IOException

Rough Linux-only heuristics to determine whether the provided Path is backed by spinning storage. For example, this returns false if the disk is a solid-state disk.

Parameters:

path - a location to check which must exist. the mount point will be determined from this location.

Returns:

false if the storage is non-rotational (e.g. an SSD), or true if it is spinning or could not be determined

Throws:

java.io.IOException - if path does not exist.

spinsLinux

static boolean spinsLinux(java.nio.file.Path path)
                   throws java.io.IOException

Throws:

java.io.IOException

getFileStore

static java.nio.file.FileStore getFileStore(java.nio.file.Path path)
                                     throws java.io.IOException

Throws:

java.io.IOException

getMountPoint

static java.lang.String getMountPoint(java.nio.file.FileStore store)