(原)
stream的内容比较多,先简单看一下它的说明:
A sequence of elements supporting sequential and parallel aggregate
* operations. The following example illustrates an aggregate operation using
* {@link Stream} and {@link IntStream}:
*
* <pre>{@code
* int sum = widgets.stream()
* .filter(w -> w.getColor() == RED)
* .mapToInt(w -> w.getWeight())
* .sum();
* }</pre>
* In this example, {@code widgets} is a {@code Collection<Widget>}. We create
* a stream of {@code Widget} objects via {@link Collection#stream Collection.stream()},
* filter it to produce a stream containing only the red widgets, and then
* transform it into a stream of {@code int} values representing the weight of
* each red widget. Then this stream is summed to produce a total weight.
一个元素的序列,它支持一个串行和并行的聚合操作。下面的例子介绍了使用stream和intstream进行聚合操作。
这个例子里,widgets是一个集合,我们通过Collection.stream()创建了一个Widget的Stream对象。然后过滤了Color属性为RED的对象,然后将其转换成一个int值的Stream,它表示每个红色的重量,然后通过 sum将这些值累加起来。
通过文档能让我们大概的了解stream是怎样操作的。
* <p>In addition to {@code Stream}, which is a stream of object references,
* there are primitive specializations for {@link IntStream}, {@link LongStream},
* and {@link DoubleStream}, all of which are referred to as "streams" and
* conform to the characteristics and restrictions described here.
除了Stream之外(它是一种对象引用流),除此之外,还有一些针对于原生类型的聚化,例如IntStream、LongStream、DoubleStream,它们都被称作为“Stream”,并且它们都遵循这里所描述的stream的特性和限制。
* <p>To perform a computation, stream
* <a href="package-summary.html#StreamOps">operations</a> are composed into a
* <em>stream pipeline</em>. A stream pipeline consists of a source (which
* might be an array, a collection, a generator function, an I/O channel,
* etc), zero or more <em>intermediate operations</em> (which transform a
* stream into another stream, such as {@link Stream#filter(Predicate)}), and a
* <em>terminal operation</em> (which produces a result or side-effect, such
* as {@link Stream#count()} or {@link Stream#forEach(Consumer)}).
* Streams are lazy; computation on the source data is only performed when the
* terminal operation is initiated, and source elements are consumed only
* as needed.
通过Stream的计算,它的操作会将它组合到一个Stream管道中(Stream特别像Linux里面管道的概念),一个流的管道包含的源可能是一个数组、一个集合、一个函数或是IO channel,在Stream的计算中可能会包括一个或多个中间操作(这些中间操作会将这个Stream转换成另一个Stream,例如通过Stream#filter(Predicate)),和一个中止操作(它会产生一个结果,如Stream#count()),Stream是惰性和,它的源数据只有在终止操作初始化的时候才执行,源数据只有被需要的时候才会被消费。
上面的意思是说,比如。Stream.aaa().bbb().ccc().count();
aaa,bbb,ccc方法为Stream的中间操作。在最的一个count未被调用时,这些中间操作是不会被执行的,这意味这count是一个终止操作。
根据文档的描述,Stream的计算由三部分组中:
1、 源数据
2、 中间操作
3、 终止操作
这里的中间操作属于惰性求值,而终止操作属于及早求值。
那么Stream要怎样创建呢?
看这个方法:
/**
* Returns a sequential ordered stream whose elements are the specified values.
*
* @param <T> the type of stream elements
* @param values the elements of the new stream
* @return the new stream
*/
@SafeVarargs
@SuppressWarnings("varargs") // Creating a stream from an array is safe
public static<T> Stream<T> of(T... values) {
return Arrays.stream(values);
}
根据指定的元素返回一个有序有Stream
于是我们可以这样创建:
Stream stream1 = Stream.of("zhangsan", "lisi", "wangwu");
或者
String[] str2 = {"zhangsan", "lisi", "wangwu"}; Stream stream2 = Stream.of(str2);
或者通过List.stream()
List list3 = Arrays.asList("zhangsan", "lisi", "wangwu"); Stream stream3 = list3.stream();
我们通过IntStream创建流并将其输出:
IntStream.of(3,1,4,9).forEach(System.out::println);
在IntStream中有range和rangeClosed二个方法,接收二个参数,代表着一个整数区间范围,range表示不包含最后一位,rangeClosed表示包含最后一位。
IntStream.range(1,4).forEach(System.out::println); System.out.println("---"); IntStream.rangeClosed(1,4).forEach(System.out::println);
如果现在有一个Int集合,要让集合里面的所有数值乘以2再相加得到最后的结果,用以前的写法不得不用循环的方式这么写:
List<Integer> partList3 = Arrays.asList(1,2,3); Integer sum3 = 0; for (Integer o : partList3) { sum3 += o * 2; }
而通过Stream可以化成一行代码:
Integer sum33 = partList3.stream().map(integer -> integer * 2).reduce(0,Integer::sum);
/**
* Returns a stream consisting of the results of applying the given
* function to the elements of this stream.
*
* <p>This is an <a href="package-summary.html#StreamOps">intermediate
* operation</a>.
*
* @param <R> The element type of the new stream
* @param mapper a <a href="package-summary.html#NonInterference">non-interfering</a>,
* <a href="package-summary.html#Statelessness">stateless</a>
* function to apply to each element
* @return the new stream
*/
<R> Stream<R> map(Function<? super T, ? extends R> mapper);
这里的map方法接收一个Function参数,最后会返回一个Stream对象,记住,这里是一个中间操作。Map方法中的Function函数会传入一个参数,然后返回把这个参数经过处理后的结果,reduce方法是一个终止操作,将这些值都通过方法引用Integer::sum的方式加起来。其中reduce接收二个参数:
T reduce(T identity, BinaryOperator<T> accumulator);
第一个参数可以认为是初始值,第二个参数是计算方式的函数,计算结果等价于:
T result = identity;
for (T element : this stream)
result = accumulator.apply(result, element)
return result;
}
如果将一个Stream对象转成一数组?
Stream<String> stream4 = Stream.of("a", "k", "g", "b");
Stream中有一个toArray方法。
/**
* Returns an array containing the elements of this stream, using the
* provided {@code generator} function to allocate the returned array, as
* well as any additional arrays that might be required for a partitioned
* execution or for resizing.
*
* <p>This is a <a href="package-summary.html#StreamOps">terminal
* operation</a>.
*
* @apiNote
* The generator function takes an integer, which is the size of the
* desired array, and produces an array of the desired size. This can be
* concisely expressed with an array constructor reference:
* <pre>{@code
* Person[] men = people.stream()
* .filter(p -> p.getGender() == MALE)
* .toArray(Person[]::new);
* }</pre>
*
* @param <A> the element type of the resulting array
* @param generator a function which produces a new array of the desired
* type and the provided length
* @return an array containing the elements in this stream
* @throws ArrayStoreException if the runtime type of the array returned
* from the array generator is not a supertype of the runtime type of every
* element in this stream
*/
<A> A[] toArray(IntFunction<A[]> generator)
这里除了使用之前说过的这种方式。
String[] streamArr1 = stream4.toArray(len -> new String[len]);
因为IntFunction这个函数接收一个Int类型为数组长度,返回一个数组的类型,我们也可以用文档中提供的例子这种方法。
String[] streamArr2 = stream4.toArray(String[]::new);
如果将一个Stream转换成List
Stream中提供了2个重载的方法
<R> R collect(Supplier<R> supplier, BiConsumer<R, ? super T> accumulator, BiConsumer<R, R> combiner); <R, A> R collect(Collector<? super T, A, R> collector);
下面一个方法可以看作是上面的缩写形式,
第一个方法中,文档中如此描述:
Performs a <a href="package-summary.html#MutableReduction">mutable
* reduction</a> operation on the elements of this stream. A mutable
* reduction is one in which the reduced value is a mutable result container,
* such as an {@code ArrayList}, and elements are incorporated by updating
* the state of the result rather than by replacing the result. This
* produces a result equivalent to:
* <pre>{@code
* R result = supplier.get();
* for (T element : this stream)
* accumulator.accept(result, element);
* return result;
* }</pre>
对这个流中的元素执行一个可变的汇聚的操作,一个可变的汇聚的操作指的是被汇聚的值是一个可变的结果容器,比如ArrayList, 这个集合是通过更新结果状态来合并的,而不是通过替换这个结果来合并的,这个结果等同于:
R result = supplier.get();
for (T element : this stream)
accumulator.accept(result, element);
return result;
}
参数1:Supplier,返回的对象是该方法返回的对象类型。
参数2:BiConsumer,接收的第一个参数可以理解是一个需要汇聚的对象,第二个参数是stream中的某一个元素。
参数3:BiConsumer,相当于是一个合并器,将上一次的结果和装进同一个对象中,用于最后的返回。当然这个对象的类型就是Supplier返回的对象类型。
例如这样:
Stream<String> stream5 = Stream.of("hello", "world", "good", "morning"); List<String> list5 = stream5.collect(() -> new ArrayList<>(),(list1,item) -> list1.add(item),(list2,list1) -> list2.addAll(list1)); list5.forEach(System.out::println);
这里有个简单的方法可以替代以上的代码
Stream<String> stream444 = Stream.of("list1", "list2", "list3");
List<String> list444 = stream444.collect(Collectors.toList());
list444.forEach(System.out::println);
Collectors中有很多方法,toList()只是将stream中的值存入ArrayList中返回。
如果想要换成LinkedList,可以用
Collectors.toCollection(LinkedList::new)
如果要将里面的值拼接成一个字符串返回,可以用
Collectors.joining()
在stream中,map作为一个映射方法,可以将集合中的无素作相处理,但如果集合中的每个元素都是一个list,要将这些list中的元素合并成一个集合,以前的做法就是用list.addAll()这个方法,现在可以利用stream中的另一个映射方法,floatMap.
<R> Stream<R> flatMap(Function<? super T, ? extends Stream<? extends R>> mapper);
它接收一个 Function函数,返回值为stream
于是可以这样写:
Stream<List<Integer>> stream7 = Stream.of(Arrays.asList(1,2), Arrays.asList(3), Arrays.asList(4,5));
List<Integer> list7 = stream7.flatMap(list -> list.stream()).collect(Collectors.toList());
System.out.println(list7);
将每个stream中的元素都展开,放在一个stream中,最后用collect方法放一个集合中输出。
例子请看这里:https://github.com/LeeScofield/java8