SneakyThrow is a Java library to ignore checked exceptions
Branch: master
Clone or download
Latest commit f6b0044 Jun 4, 2018
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.mvn/wrapper
documentation updated roadmap May 27, 2018
src
.editorconfig Initial commit Feb 19, 2018
.gitignore final commit before 0.9.0 release Feb 24, 2018
.travis.yml added coverall Feb 19, 2018
LICENSE
README.md latest push before 1.1 release Jun 4, 2018
ezgif-3-db5218262c.gif animated gif Mar 14, 2018
mvnw Initial commit Feb 19, 2018
mvnw.cmd Initial commit Feb 19, 2018
pom.xml Merge branch 'v1.1' of https://github.com/rainerhahnekamp/sneakythrow Jun 4, 2018

README.md

SneakyThrow

Build Status Coverage Status MIT Licence Maven Central Javadocs

SneakyThrow is a Java library to ignore checked exceptions. You can integrate it using maven:

<dependency>
  <groupId>com.rainerhahnekamp</groupId>
  <artifactId>sneakythrow</artifactId>
  <version>1.1.0</version>
</dependency>

SneakyThrow Usage GIF

Usage

Without SneakyThrow:

URL url;
try {
  url = new URL("https://www.hahnekamp.com");
} catch (MalformedURLException mue) {
  throw new RuntimeException(mue);
}

With SneakyThrow:

URL url = sneak(() -> new URL("https://www.hahnekamp.com"));

Usage with Java 8 Streams

private URL createURL(String url) throws MalformedURLException {
  return new URL(url);
}

The function above used within a Stream without SneakyThrow:

Stream
  .of("https://www.hahnekamp.com", "https://www.austria.info")
  .map(url -> {
    try {
      return this.createURL(url);
    } catch (MalformedURLException mue) {
      throw new RuntimeException(mue);
    }
  })  
  .collect(Collectors.toList());

Again with SneakyThrow:

Stream
  .of("https://www.hahnekamp.com", "https://www.austria.info")
  .map(sneaked(this::createURL))
  .collect(Collectors.toList());

The static method sneaked wraps each function, that has the same signature as a functional interface (java.util.functional).

Please note the difference between sneak and sneaked.

How it works

This project is heavily influenced by ThrowingFunction.

In SneakyThrow, each functional interface, defined in java.util.function, has an equivalent one with the same signature. The only difference is, that these "Sneaky Functional Interfaces" throw exceptions. This gives us the possibility to write lambdas or similar code that also throws exceptions.

Both sneak and sneaked wrap the passed "Sneaky Functional Interfaces" into a try/catch clause and return the equivalent java.util.function interface. In the case of sneak, execution and the return of the result is done immediately.