https://github.com/stefan-zobel/streamsupport
Backport of Java 8/9 java.util.stream API to Java 6/7 and Android
https://github.com/stefan-zobel/streamsupport
android completablefuture flow java10 java8 java9 jep-266 reactive-streams stream-api
Last synced: 7 months ago
JSON representation
Backport of Java 8/9 java.util.stream API to Java 6/7 and Android
- Host: GitHub
- URL: https://github.com/stefan-zobel/streamsupport
- Owner: stefan-zobel
- License: gpl-2.0
- Archived: true
- Created: 2018-03-04T13:19:21.000Z (about 8 years ago)
- Default Branch: master
- Last Pushed: 2024-01-21T20:15:30.000Z (over 2 years ago)
- Last Synced: 2025-01-13T22:24:14.245Z (over 1 year ago)
- Topics: android, completablefuture, flow, java10, java8, java9, jep-266, reactive-streams, stream-api
- Language: Java
- Homepage:
- Size: 3.72 MB
- Stars: 189
- Watchers: 11
- Forks: 29
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
[](https://lgtm.com/projects/g/stefan-zobel/streamsupport/alerts/)
[](https://lgtm.com/projects/g/stefan-zobel/streamsupport/context:java)
[](http://mvnrepository.com/artifact/net.sourceforge.streamsupport/streamsupport)
[](https://javadoc.io/doc/net.sourceforge.streamsupport/streamsupport)
# streamsupport
streamsupport is a backport of the Java 8 `java.util.function` (functional interfaces) and `java.util.stream`
(streams) API for Android and users of Java 6 or 7 supplemented with selected additions from `java.util.concurrent`
which didn't exist back in Java 6.
Due to the lack of default interface methods and static interface methods in pre-Java 8 the API had to be slightly
adjusted in these areas but still covers the full functionality scope of Java 8. In detail, static and default
interface methods have been moved to companion classes in the same package that bear the identical name as the
interface but with an "s" appended (e.g. `Comparator` -> `Comparators`).
For ease of use, the default methods for most of the functional interfaces were NOT retained as abstract methods
in the redefined interfaces (keeping them single method interfaces) - the missing default (and static) methods can
always be found in the corresponding companion class.
The streamsupport API lives in the packages `java8.util.*` and `java8.lang` respectively. So, it's not possible to
simply import the `java.util.stream` package in your code - you'd rather have to use `java8.util.stream` instead
(see [Readme.txt](https://github.com/stefan-zobel/streamsupport/blob/master/Readme.txt) for details). While that
is fine as long as you have full control over your source code there is the other common scenario of using a binary
3rd party dependency that has been compiled against the standard Java 8 `java.util.stream` API. In the latter case
bytecode rewriting via [ProGuard](https://github.com/Guardsquare/proguard) might be an option. ProGuard supports
most Java 8 language features and the latest release can also replace the standard Java 8 stream API by the the
streamsupport backport (cf. the Proguard [documentation](https://www.guardsquare.com/manual/languages/java),
especially the section titled "Java 8 stream API support").
The current stable release of streamsupport is `streamsupport-1.7.4`.
Want also lambdas? https://github.com/orfjackal/retrolambda
Note that the [streamsupport sourceforge](https://sourceforge.net/projects/streamsupport/) site has been discontinued.
New developments, if any, will take place here.
Please give feedback [here](https://github.com/stefan-zobel/streamsupport/issues) if you experience any problems.
## Features
* Java 8 / Java 9 Streams library backport
* Java 8 / Java 9 CompletableFuture backport
* Java 8 Parallel array operations backport
* Java 8 Functional interfaces backport
* Further java.util.concurrent enhancements from Java 7/8 backported to Java 6
* Includes miscellaneous Java 8 / Java 9 goodies (Optional, StringJoiner, ...)
* Supports Android - all versions, starting from Ice Cream Sandwich
### build.gradle:
```gradle
dependencies {
implementation 'net.sourceforge.streamsupport:streamsupport:1.7.4'
}
```
### Maven:
```xml
net.sourceforge.streamsupport
streamsupport
1.7.4
```
### All-in-One JAR:
Contains streamsupport core + atomic + cfuture + flow
```xml
net.sourceforge.streamsupport
streamsupport_all
1.7.4
```
### Example usage
```java
import java.util.List;
import java8.util.stream.IntStreams;
import java8.util.stream.StreamSupport;
import static java8.util.stream.Collectors.toList;
List list = IntStreams.of(1, 2, 3, 4).boxed()
.collect(toList());
List incremented = StreamSupport.stream(list)
.map(i -> i + 1)
.collect(toList());
```
### Forks
Android developers using the Android Studio 3.x toolchain should have a look at the `streamsupport` forks:
* [android-retrostreams](https://github.com/retrostreams/android-retrostreams)
* [android-retrofuture](https://github.com/retrostreams/android-retrofuture)
* [android-retroflow](https://github.com/retrostreams/android-retroflow)
* [android-retroatomic](https://github.com/retrostreams/android-retroatomic)
## Release Notes
[Release Notes](Readme.txt)
## LICENSE
GNU General Public License, version 2, [with the Classpath Exception](https://github.com/stefan-zobel/streamsupport/blob/master/GPL_ClasspathException) (and [CC0 1.0](https://creativecommons.org/publicdomain/zero/1.0/) for JSR-166 derived code)