chkstream

KO | EN

gitlite — search

#javascript #hacktoberfest #llm #rust #deep-learning #docker #macos #windows #cli #kubernetes #awesome-list #security #pytorch #mcp

(★ 18)

Checked exception support in Java 8 streams via decorator.

chkstream Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Checked Exception Streams

**Checked Exception Streams** (ChkStreams) adds checked exception support to the
Java 8 Stream API.

ChkStreams is not an official Google product.

## Overview

Have you ever wanted to write something like this, but been foiled by the
dreaded `Unhandled exception type IOException`?

```java
filenames.parallelStream()
  .map(Files::readFully)
  .collect(toList());
```

Be foiled no more!

```java
ChkStreams.of(filenames.parallelStream())
  .canThrow(IOException.class)
  .map(Files::readFully)
  .collect(toList());
```

## Usage

ChkStreams extends the existing Java 8 Stream API. To use it, simply:

1.  Wrap any `Stream` using `ChkStreams.of(Stream)` to get a `ChkStream`.
2.  Declare one or more checked exceptions by calling
    `ChkStream#canThrow(Exception)`, so that subsequent stream operations will
    allow that `Exception`.
3. Use the same Stream API you're used to (except now your lambdas can throw the
   declared exceptions!)
4. Handle the checked exceptions in the usual way (catch or declare thrown) in
   any method that invokes a **terminal** operation on the stream.

## Features

* Adds checked exception support to the familiar Streams API!
* Exceptions are enforced by the compiler in the usual way, and need only be
  handled when invoking terminal operations.
* Can be converted to/from regular Java `Stream`s (See `ChkStreams#of(Stream)`
  and `ChkStream#toStream()`). Regular streams obtained from
  `ChkStream#toStream()` will throw unchecked exceptions (specifically
  `ChkStreamWrappedException`) when checked exceptions occur in the stream.
* All primitive specializations of `Stream` are supported without boxing (See
  `ChkStreams#ofInt(IntStream)`).
* (Optional) support for the
  [StreamSupport backport](https://streamsupport.sourceforge.io/) and
  [Retrolambda](https://github.com/orfjackal/retrolambda). Enjoy the power of
  `ChkStream` on Java 6+ and Android!
* May cause you to barf rainbows.

## Limitations

* A maximum of 5 checked exceptions may be added to a `ChkStream`.
* No interfaces in common with `Stream` or between `ChkStream`s with different
  numbers of exceptions.

## License

This project is licensed under the GNU GPLv2 with Classpath Exception, which is
the same license as OpenJDK itself.

chkstream

chkstream Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

chkstream

chkstream Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README