Why does Iterable not provide stream() and parallelStream() methods?

by

This was not an omission; there was detailed discussion on the EG list in June of 2013.

The definitive discussion of the Expert Group is rooted at this thread.

While it seemed “obvious” (even to the Expert Group, initially) that stream() seemed to make sense on Iterable, the fact that Iterable was so general became a problem, because the obvious signature:

Stream<T> stream()

was not always what you were going to want. Some things that were Iterable<Integer> would rather have their stream method return an IntStream, for example. But putting the stream() method this high up in the hierarchy would make that impossible. So instead, we made it really easy to make a Stream from an Iterable, by providing a spliterator() method. The implementation of stream() in Collection is just:

default Stream<E> stream() {
    return StreamSupport.stream(spliterator(), false);
}

Any client can get the stream they want from an Iterable with:

Stream s = StreamSupport.stream(iter.spliterator(), false);

In the end we concluded that adding stream() to Iterable would be a mistake.

More Related Contents:

  1. Convert Iterable to Stream using Java 8 JDK
  2. Why does Stream not implement Iterable?
  3. Using Java 8’s Optional with Stream::flatMap
  4. Java 8 Streams: multiple filters vs. complex condition
  5. Java 8 stream reverse order
  6. Partition a Java 8 Stream
  7. Java 8’s streams: why parallel stream is slower?
  8. Stream and lazy evaluation
  9. How do I keep the iteration order of a List when using Collections.toMap() on a stream?
  10. Why is this java Stream operated upon twice?
  11. Java 8 Streams – collect vs reduce
  12. How can I get a List from some class properties with Java 8 Stream?
  13. Is it possible to use the Java 8 Stream API on Android API < 24?
  14. Why is Files.lines (and similar Streams) not automatically closed?
  15. Why doesn’t java.util.Collection implement the new Stream interface?
  16. Stream Filter of 1 list based on another list
  17. How do I create a Stream of regex matches?
  18. Simplest way to print an `IntStream` as a `String`
  19. Iterate two Java-8-Streams together [duplicate]
  20. Grouping by object value, counting and then setting group key by maximum object attribute
  21. Why parallel stream get collected sequentially in Java 8
  22. In Stream reduce method, must the identity always be 0 for sum and 1 for multiplication?
  23. How to add elements of a Java8 stream into an existing List
  24. How to implement a Java stream?
  25. Why didn’t Stream have a toList() method?
  26. Is flatMap guaranteed to be lazy? [duplicate]
  27. Does collect operation on Stream close the stream and underlying resources?
  28. How to get multiple values from an object using a single stream operation?
  29. Java8 Lambda: concat list [duplicate]
  30. non-interference requirement on Java 8 streams

Leave a Comment