uk.kludje.fn.lang

Interface UCloseableResource

All Superinterfaces:

java.lang.AutoCloseable, CloseableResource

Functional Interface:

This is a functional interface and can therefore be used as the assignment target for a lambda expression or method reference.

@FunctionalInterface
 @Generated(value="uk.kludje.annotation.processor.UncheckedFunctionalInterfaceProcessor")
public interface UCloseableResource
extends CloseableResource

TLDR; IMPLEMENT void $close() throws Throwable USING A LAMBDA; INVOKE void close().

A functional interface for handling checked exceptions. See parent type for interface intent.

void close() invokes void $close() and throws anything thrown by void $close().

General example using java.lang.Runnable that reduces 11 lines to a single line. Call someMethodThatThrowsException in throwsNothing:

 public void someMethodThatThrowsException() throws IOException {
   // I/O functionality
 }

 public void throwsNothing(Runnable r) {
   r.run();
 }
 

Before:

 public void yourMethod() throws IOException {
   try {
     throwsNothing(() -> {
       try {
         someMethodThatThrowsException();
       } catch (IOException e) {
         throw new SomeWrapperException(e);
       }
     });
   } catch(SomeWrapperException w) {
     throw (IOException) w.getCause();
   }
 }
 

After:

 public void yourMethod() throws IOException {
   throwsNothing((URunnable) this::someMethodThatThrowsException);
 }
 

Method public static UCloseableResource asUCloseableResource(UCloseableResource t) provides a convenience method for manufacturing types as an alternative to casting.

Method Summary

Modifier and Type	Method and Description
void	$close()
static UCloseableResource	asUCloseableResource(UCloseableResource t)
default void	close() Overrides the parent method which throws Exception.

Methods inherited from interface uk.kludje.CloseableResource

expected

Method Detail

close

default void close()

Description copied from interface: CloseableResource

Overrides the parent method which throws Exception. Combined with CloseableResource.expected() this type can declare checked it throws any type.

Specified by:

close in interface java.lang.AutoCloseable

Specified by:

close in interface CloseableResource

$close

void $close()
     throws java.lang.Throwable

Throws:

java.lang.Throwable

asUCloseableResource

static UCloseableResource asUCloseableResource(UCloseableResource t)