SneakyThrow

Java library to ignore checked exceptions

License

License

Categories

Categories

SneakyThrow Development Tools Development Libraries
GroupId

GroupId

com.rainerhahnekamp
ArtifactId

ArtifactId

sneakythrow
Last Version

Last Version

1.2.0
Release Date

Release Date

Type

Type

jar
Description

Description

SneakyThrow
Java library to ignore checked exceptions
Project URL

Project URL

https://github.com/rainerhahnekamp/sneakythrow
Source Code Management

Source Code Management

https://github.com/rainerhahnekamp/sneakythrow

Download sneakythrow

How to add to project

<!-- https://jarcasting.com/artifacts/com.rainerhahnekamp/sneakythrow/ -->
<dependency>
    <groupId>com.rainerhahnekamp</groupId>
    <artifactId>sneakythrow</artifactId>
    <version>1.2.0</version>
</dependency>
// https://jarcasting.com/artifacts/com.rainerhahnekamp/sneakythrow/
implementation 'com.rainerhahnekamp:sneakythrow:1.2.0'
// https://jarcasting.com/artifacts/com.rainerhahnekamp/sneakythrow/
implementation ("com.rainerhahnekamp:sneakythrow:1.2.0")
'com.rainerhahnekamp:sneakythrow:jar:1.2.0'
<dependency org="com.rainerhahnekamp" name="sneakythrow" rev="1.2.0">
  <artifact name="sneakythrow" type="jar" />
</dependency>
@Grapes(
@Grab(group='com.rainerhahnekamp', module='sneakythrow', version='1.2.0')
)
libraryDependencies += "com.rainerhahnekamp" % "sneakythrow" % "1.2.0"
[com.rainerhahnekamp/sneakythrow "1.2.0"]

Dependencies

test (1)

Group / Artifact Type Version
org.junit.jupiter : junit-jupiter-engine jar 5.2.0

Project Modules

There are no modules declared in this project.

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.2.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.

Versions

Version
1.2.0
1.1.0
1.0.0
0.9.0