https://github.com/rainerhahnekamp/sneakythrow

SneakyThrow is a Java library to ignore checked exceptions
https://github.com/rainerhahnekamp/sneakythrow

exception-handling java

Last synced: 29 days ago
JSON representation

SneakyThrow is a Java library to ignore checked exceptions

• Host: GitHub
• URL: https://github.com/rainerhahnekamp/sneakythrow
• Owner: rainerhahnekamp
• License: mit
• Created: 2018-02-19T22:44:17.000Z (almost 7 years ago)
• Default Branch: master
• Last Pushed: 2019-10-24T10:34:02.000Z (about 5 years ago)
• Last Synced: 2024-10-30T20:45:49.024Z (about 1 month ago)
• Topics: exception-handling, java
• Language: Java
• Homepage:
• Size: 2.35 MB
• Stars: 77
• Watchers: 4
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-java - SneakyThrow - Ignores checked exceptions without bytecode manipulation. Can also be used inside Java 8 stream operations. (Projects / Development)
• awesome-java-zh - SneakyThrow - 忽略没有字节码操作的检查异常。也可以在Java 8流操作中使用。 (项目 / 发展)
• awesome-java - SneakyThrow - Ignores checked exceptions without bytecode manipulation. Can also be used inside Java 8 stream operations. (Projects / Development)

README

        
# SneakyThrow

[![Build Status](https://travis-ci.org/rainerhahnekamp/sneakythrow.svg?branch=master)](https://travis-ci.org/rainerhahnekamp/sneakythrow.svg?branch=master)

[![Coverage Status](https://coveralls.io/repos/github/rainerhahnekamp/sneakythrow/badge.svg?branch=master)](https://coveralls.io/github/rainerhahnekamp/sneakythrow?branch=master)

[![MIT Licence](https://badges.frapsoft.com/os/mit/mit.svg?v=103)](https://opensource.org/licenses/mit-license.php)

[![Maven Central](https://maven-badges.herokuapp.com/maven-central/com.rainerhahnekamp/sneakythrow/badge.svg)](https://maven-badges.herokuapp.com/maven-central/com.rainerhahnekamp/sneakythrow)

[![Javadocs](https://www.javadoc.io/badge/com.rainerhahnekamp/sneakythrow.svg)](https://www.javadoc.io/doc/com.rainerhahnekamp/sneakythrow)

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

```xml

  com.rainerhahnekamp

  sneakythrow

  1.2.0

```

![SneakyThrow Usage GIF](https://github.com/rainerhahnekamp/sneakythrow/blob/master/ezgif-3-db5218262c.gif)

## Usage

Without SneakyThrow:

```java

URL url;

try {

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

} catch (MalformedURLException mue) {

  throw new RuntimeException(mue);

}

```

With SneakyThrow:

```java

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

```

## Usage with Java 8 Streams

```java

private URL createURL(String url) throws MalformedURLException {

  return new URL(url);

}

```

The function above used within a Stream without SneakyThrow:

```java

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:

```java

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](https://github.com/pivovarit/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.