public final class IOUtils
extends java.lang.Object
Modifier and Type | Field and Description |
---|---|
static java.nio.charset.Charset |
CHARSET_UTF_8
UTF-8
Charset instance to prevent repeated
Charset.forName(String) lookups |
static java.lang.String |
UTF_8
UTF-8 charset string
|
Modifier and Type | Method and Description |
---|---|
static void |
close(java.io.Closeable... objects)
Closes all given Closeables.
|
static void |
close(java.lang.Iterable<? extends java.io.Closeable> objects) |
static void |
closeWhileHandlingException(java.io.Closeable... objects)
Closes all given Closeables, suppressing all thrown exceptions.
|
static <E extends java.lang.Exception> |
closeWhileHandlingException(E priorException,
java.io.Closeable... objects)
Closes all given Closeables, suppressing all thrown exceptions.
|
static <E extends java.lang.Exception> |
closeWhileHandlingException(E priorException,
java.lang.Iterable<? extends java.io.Closeable> objects) |
static void |
closeWhileHandlingException(java.lang.Iterable<? extends java.io.Closeable> objects) |
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.File file,
java.nio.charset.Charset charSet)
Opens a Reader for the given
File 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 . |
public static final java.lang.String UTF_8
Charset.forName(String)
,
Constant Field Valuespublic static final java.nio.charset.Charset CHARSET_UTF_8
Charset
instance to prevent repeated
Charset.forName(String)
lookupspublic static <E extends java.lang.Exception> void closeWhileHandlingException(E priorException, java.io.Closeable... objects) throws E extends java.lang.Exception, java.io.IOException
Closes all given Closeables, suppressing all thrown exceptions. Some of the Closeables may be null, they are ignored. After everything is closed, method either throws priorException, if one is supplied, or the first of suppressed exceptions, or completes normally.
Sample usage:
Closeable resource1 = null, resource2 = null, resource3 = null; ExpectedException priorE = null; try { resource1 = ...; resource2 = ...; resource3 = ...; // Acquisition may throw ExpectedException ..do..stuff.. // May throw ExpectedException } catch (ExpectedException e) { priorE = e; } finally { closeSafely(priorE, resource1, resource2, resource3); }
priorException
- null or an exception that will be rethrown after method completionobjects
- objects to call close() onE extends java.lang.Exception
java.io.IOException
public static <E extends java.lang.Exception> void closeWhileHandlingException(E priorException, java.lang.Iterable<? extends java.io.Closeable> objects) throws E extends java.lang.Exception, java.io.IOException
E extends java.lang.Exception
java.io.IOException
closeWhileHandlingException(Exception, Closeable...)
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) throws java.io.IOException
objects
- objects to call close() onjava.io.IOException
public static void closeWhileHandlingException(java.lang.Iterable<? extends java.io.Closeable> objects) throws java.io.IOException
java.io.IOException
closeWhileHandlingException(Closeable...)
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, its 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.io.File file, java.nio.charset.Charset charSet) throws java.io.IOException
File
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, its not recommended to use as a common purpose reader.
file
- the file to open a reader oncharSet
- the expected charsetjava.io.IOException
public 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, its 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
Copyright © 2000-2023 Apache Software Foundation. All Rights Reserved.