com.facebook.buck.util

Class ThrowingCloseableWrapper<T,E extends Exception>

java.lang.Object

com.facebook.buck.util.AbstractCloseableWrapper<T,E>

com.facebook.buck.util.ThrowingCloseableWrapper<T,E>

All Implemented Interfaces:

AutoCloseable

public class ThrowingCloseableWrapper<T,E extends Exception>
extends AbstractCloseableWrapper<T,E>

Convenience wrapper class to attach closeable functionality to non-closeable class so it can be used with try-with-resources to make sure resources are always released and proper exception suppression is used. The closer may throw an exception which type can be specialized.

Example:

 class Main {
  private static void finalizeMyClass(MyClass obj) throws IOException {
    obj.shutdown();
  }

  public static void main() {
    try (ThrowingCloseableWrapper<MyClass, IOException> myClassWrapper =
          ThrowingCloseableWrapper.of(new MyClass(), Main::finalizeMyClass)) {
      myClassWrapper.get().doSomething();
    }
  }
 }

 

Method Summary

Modifier and Type	Method and Description
static <T,E extends Exception> ThrowingCloseableWrapper<T,E>	of(T obj, ThrowingConsumer<T,E> closer) Wrap an object with AutoCloseable interface and provide a function to replace a close method The wrapper is idempotent, i.e.

Methods inherited from class com.facebook.buck.util.AbstractCloseableWrapper

close, get

Methods inherited from class java.lang.Object

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

Method Detail

of

public static <T,E extends Exception> ThrowingCloseableWrapper<T,E> of(T obj,
                                                                       ThrowingConsumer<T,E> closer)

Wrap an object with AutoCloseable interface and provide a function to replace a close method The wrapper is idempotent, i.e. it will call closer function exactly once, even if user calls close multiple times.

Parameters:

obj - Any class that does not implement AutoCloseable interface which is hard to extend

closer - A function to call on close