com.google.common.io

Class Closeables

java.lang.Object

com.google.common.io.Closeables

@Beta
public final class Closeables
extends Object

Utility methods for working with Closeable objects.

Since:

1.0

Author:

Michael Lancaster

Method Summary

Methods

Modifier and Type	Method and Description
static void	close(Closeable closeable, boolean swallowIOException) Closes a Closeable, with control over whether an IOException may be thrown.

Methods inherited from class java.lang.Object

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

Method Detail

close

public static void close(@Nullable
         Closeable closeable,
         boolean swallowIOException)
                  throws IOException

Closes a Closeable, with control over whether an IOException may be thrown. This is primarily useful in a finally block, where a thrown exception needs to be logged but not propagated (otherwise the original exception will be lost).

If swallowIOException is true then we never throw IOException but merely log it.

Example:

   public void useStreamNicely() throws IOException {
     SomeStream stream = new SomeStream("foo");
     boolean threw = true;
     try {
       // ... code which does something with the stream ...
       threw = false;
     } finally {
       // If an exception occurs, rethrow it only if threw==false:
       Closeables.close(stream, threw);
     }
   }

Parameters:

closeable - the Closeable object to be closed, or null, in which case this method does nothing

swallowIOException - if true, don't propagate IO exceptions thrown by the close methods

Throws:

IOException - if swallowIOException is false and close throws an IOException.