1、什么是流?
Stream 作为 Java 8 的一大亮点,它与 java.io 包里的 InputStream 和 OutputStream 是完全不相关的东西。
Java 8 中的 Stream 是对集合(Collection)对象功能的增强,它专注于对集合对象进行各种非常便利、高效的聚合操作(aggregate operation),或者大批量数据操作 (bulk data operation)。
Java 8 中出现的 java.util.stream 是一个函数式语言+多核时代综合影响的产物。
这里一个简单的示例——对数组求和。
在引入流之前:
int[] nums = { 1, 2, 3 };
//循环计算求职
int sum = 0;
for (int i : nums) {
sum += i;
}
System.out.println("结果为:" + sum);
逻辑也比较简单,引入流之后:
//使用流
int sum2 = IntStream.of(nums).sum();
System.out.println("结果为:" + sum2);
代码相对而言要简洁一些。
这只是一个简单的迭代求和,如果是一些复杂的聚合或批量操作,那么流在代码简洁性上就更有优势了。
2、创建流
当我们使用一个流的时候,通常包括三个基本步骤:
获取一个数据源(source)→ 数据转换→ 执行操作获取想要的结果。
每次转换原有 Stream 对象不改变,返回一个新的 Stream 对象(可以有多次转换),这就允许对其操作可以像链条一样排列,变成一个管道,如下图所示。
有很多方法可以创建不同数据源的流实例。
2.1、空的流
创建空的流,使用empty()方法:
Stream<String> streamEmpty = Stream.empty();
使用empty()方法创建来避免没有元素的流返回null的问题:
public Stream<String> streamOf(List<String> list) {
return list == null || list.isEmpty() ? Stream.empty() : list.stream();
}
2.2、集合的流
可以创建任何类型的集合(Collection, List, Set)的流:
Collection<String> collection = Arrays.asList("a", "b", "c");
Stream<String> streamOfCollection = collection.stream();
2.3、数组的流
数组也可以作为流的数据源:
Stream<String> streamOfArray = Stream.of("a", "b", "c");
也可以从现有数组或数组的一部分中创建流:
String[] arr = new String[]{"a", "b", "c"};
Stream<String> streamOfArrayFull = Arrays.stream(arr);
Stream<String> streamOfArrayPart = Arrays.stream(arr, 1, 3);
2.4、 Stream.builder()
使用builder时,应在语句的右侧另外使用的类型,否则build()方法将创建 Stream <Object >的实例:
Stream<String> streamBuilder =
Stream.<String>builder().add("a").add("b").add("c").build();
2.5、 Stream.generate()
generate()方法接受Supplier\ 进行元素生成。由于结果流是无限的,因此开发人员应指定所需的大小,否则generate()方法运行后会达到内存的上限:
Stream<String> streamGenerated =
Stream.generate(() -> "element").limit(10);
上面的代码创建了一个由十个字符串组成的序列,其值是“ element”。
2.6、 Stream.iterate()
创建无限流的另一种方法是使用iterate()方法:
Stream<Integer> streamIterated = Stream.iterate(40, n -> n + 2).limit(20);
结果流的第一个元素是iterate()方法的第一个参数。为了创建后续的元素,使用了上一个元素。在上面的示例中,第二个元素为42。
2.7、 基本类型的流
Java 8提供了从三种基本类型中创建流的方式:int,long和double。
由于Stream <T>是泛型接口,无法将基本类型用作泛型的类型参数,因此创建了三个新的特殊接口:IntStream,LongStream和DoubleStream。使用新接口可以减轻不必要的自动装箱,从而提效率:
IntStream intStream = IntStream.range(1, 3);
LongStream longStream = LongStream.rangeClosed(1, 3);
range(int startInclusive,int endExclusive)方法创建从第一个参数到第二个参数的有序流。它以等于1的步长递增后续元素的值。结果不包括最后一个参数,它只是序列的上限。
2.8、字符串的流
字符串也可以用作创建流的数据源。
由于JDK中没有接口CharStream,因此使用IntStream表示字符流。用到了String类的chars()方法。
IntStream streamOfChars = "abc".chars();
下面的示例根据指定的正则表达式将String细分为子字符串:
Stream<String> streamOfString =
Pattern.compile(", ").splitAsStream("a, b, c");
2.9、文件的流
Java NIO类 Files 允许通过lines()方法生成文本文件的Stream <String>。文本的每一行都成为流的元素:
Path path = Paths.get("C:\\file.txt");
Stream<String> streamOfStrings = Files.lines(path);
Stream<String> streamWithCharset =
Files.lines(path, Charset.forName("UTF-8"));
可以将字符编码指定为lines()方法的参数。
最常用的就是从集合中创建出流。
3、流操作
上面学习了流的创建方式,接下来学习流的操作。
它们分为中间操作(返回Stream <T>)和终端操作(返回确定类型的结果)。中间操作允许链式传递。
我们来看一看常用的非终端操作。
3.1、中间操作
中间操作也叫非终端操作。
Java Stream API的非终端流操作是对流中的元素进行转换或过滤的操作。
当向流添加非终端操作时,将得到一个新的流。新流表示应用了非终端操作的原始流产生的元素流。这是添加到流中的非终端操作的示例——会产生新的流:
List<String> stringList = new ArrayList<String>();
stringList.add("ONE");
stringList.add("TWO");
stringList.add("THREE");
Stream<String> stream = stringList.stream();
Stream<String> stringStream =
stream.map((value) -> { return value.toLowerCase(); });
注意对stream.map()的调用。该调用实际上返回一个新的Stream实例,该实例表示已使用map操作原来的字符流。
只能将单个操作添加到给定的Stream实例。
如果需要将多个操作彼此链接在一起,则需要将第二个操作应用第一个操作产生的Stream流。实例如下:
Stream<String> stringStream1 =
stream.map((value) -> { return value.toLowerCase(); });
Stream<½String> stringStream2 =
stringStream1.map((value) -> { return value.toUpperCase(); });
链式调用是非常常见的,这是链式调用的实例:
Stream<String> stream1 = stream
.map((value) -> { return value.toLowerCase(); })
.map((value) -> { return value.toUpperCase(); })
.map((value) -> { return value.substring(0,3); });
许多非终端Stream操作可以将Java Lambda表达式作为参数。该lambda表达式实现了适合给定非终端操作的Java函数式接口。非终端操作方法参数的参数通常是函数式接口——这就是为什么它也可以由Java lambda表达式实现的原因。
3.1.1、filter()
Java Stream filter()可用于过滤Java Stream中的元素。filter方法采用一个Predicate,该Predicate被流中的每个元素被调用。如果元素要包含在结果流中,则Predicate返回true。如果不应包含该元素,则Predicate返回false。
下面是一个filter()实例:
Stream<String> longStringsStream = stream.filter((value) -> {
return value.length() >= 3;
});
3.1.2、map()
Java Stream map()方法将一个元素转换(映射)到另一个对象。例如,如果你有一个字符串列表,则可以将每个字符串转换为小写,大写或原始字符串的子字符串,或者完全转换成其他字符串。
这是一个Java Stream map()示例:
List<String> list = new ArrayList<String>();
Stream<String> stream = list.stream();
Stream<String> streamMapped = stream.map((value) -> value.toUpperCase());
3.1.3、flatMap()
Java Stream flatMap()方法将单个元素映射到多个元素。意思是将每个元素从由多个内部元素组成的复杂结构“展平”到仅由这些内部元素组成的“展平”流。
例如,假设你有一个带有嵌套对象(子对象)的对象。然后,你可以将该对象映射到一个“平”流,该流由自身加上其嵌套对象——或仅嵌套对象组成。你还可以将元素列表流映射到元素本身。或将字符串流映射到这些字符串中的字符流——或映射到这些字符串中的各个Character实例。
这是一个将字符串列表平面映射到每个字符串中的字符的示例。
List<String> stringList = new ArrayList<String>();
stringList.add("One flew over the cuckoo's nest");
stringList.add("To kill a muckingbird");
stringList.add("Gone with the wind");
Stream<String> stream = stringList.stream();
stream.flatMap((value) -> {
String[] split = value.split(" ");
return (Stream<String>) Arrays.asList(split).stream();
}).forEach((value) -> System.out.println(value));
此Java Stream flatMap() 示例首先创建一个包含3个包含书名的字符串的List。然后,获取List的Stream,并调用flatMap()。
3.1.4、distinct()
Java Stream unique()方法是一种非终端操作,返回一个新的Stream,与来源的流不同,它去掉了重复的元素。这是Java Streamdisting()方法的示例:
List<String> stringList = new ArrayList<String>();
stringList.add("one");
stringList.add("two");
stringList.add("three");
stringList.add("one");
Stream<String> stream = stringList.stream();
List<String> distinctStrings = stream
.distinct()
.collect(Collectors.toList());
System.out.println(distinctStrings);
在此示例中,元素 " one " 在原来的流中出现2次。在新的流中只会出现第一次出现的元素。因此,结果列表(通过调用collect()将仅包含 “one” , “two” 和"three"。从此示例打印的输出将是:
[one, two, three]
3.1.5、limit()
Java Stream limit()方法可以将流中的元素数量限制为指定给limit()方法的数量。limit() 方法返回一个新的Stream,该Stream最多包含给定数量的元素。这是一个Java Stream limit() 示例:
List<String> stringList = new ArrayList<String>();
stringList.add("one");
stringList.add("two");
stringList.add("three");
stringList.add("one");
Stream<String> stream = stringList.stream();
stream
.limit(2)
.forEach( element -> { System.out.println(element); });
本示例首先创建一个Stream流,然后在其上调用limit(),然后使用forEach()来打印出该流中的元素。由于调用了limit(2),仅将打印前两个元素。
3.1.6、peek()
Java Stream peek()方法是一种非终端操作,它以 Consumer(java.util.function.Consumer)作为参数。将为流中的每个元素调用Consumer。peek()方法返回一个新的Stream,其中包含原来的流中的所有元素。
正如方法所说,peek() 方法的目的是见识流中的元素,而不是对其进行转换。peek方法不会启动流中元素的内部迭代。要这是一个Java Stream peek()示例:
List<String> stringList = new ArrayList<String>();
stringList.add("abc");
stringList.add("def");
Stream<String> stream = stringList.stream();
Stream<String> streamPeeked = stream.peek((value) -> {
System.out.println("value");
});
3.2、终端操作
Java Stream接口的终端操作通常返回单个值。一旦在Stream上调用了终端操作,就将开始Stream的迭代以及链路上的流。迭代完成后,将返回终端操作的结果。
终端操作通常不返回新的Stream实例。因此,一旦在流上调用了终端操作,来自非终端操作的Stream实例链就结束了。
这是在Java Stream上调用终端操作的示例:
long count = stream
.map((value) -> { return value.toLowerCase(); })
.map((value) -> { return value.toUpperCase(); })
.map((value) -> { return value.substring(0,3); })
.count();
该示例末尾的对count()的调用是终端操作。由于count()返回long,因此非终端操作的Stream链路(map()调用)结束。
3.2.1、anyMatch()
Java Stream anyMatch()方法是一种终端操作,它以单个Predicate作为参数,启动Stream的内部迭代,并将Predicate参数应用于每个元素。如果Predicate对任意一个元素返回true,则anyMatch()方法返回true。如果没有元素与Predicate匹配,则anyMatch()将返回false。
这是一个Java Stream anyMatch()示例:
List<String> stringList = new ArrayList<String>();
stringList.add("One flew over the cuckoo's nest");
stringList.add("To kill a muckingbird");
stringList.add("Gone with the wind");
Stream<String> stream = stringList.stream();
boolean anyMatch = stream.anyMatch((value) -> { return value.startsWith("One"); });
System.out.println(anyMatch);
在上面的示例中,anyMatch() 方法调用将返回true,因为流中的第一个字符串元素以“ One”开头。
3.2.2、allMatch()
Java Stream allMatch() 方法是一种终端操作,该操作以单个Predicate作为参数,启动Stream中元素的内部迭代,并将Predicate参数应用于每个元素。如果Predicate对于Stream中的所有元素都返回true,则allMatch() 将返回true。如果不是所有元素都与Predicate匹配,则allMatch() 方法将返回false。
这是一个Java Stream allMatch() 示例:
List<String> stringList = new ArrayList<String>();
stringList.add("One flew over the cuckoo's nest");
stringList.add("To kill a muckingbird");
stringList.add("Gone with the wind");
Stream<String> stream = stringList.stream();
boolean allMatch = stream.allMatch((value) -> { return value.startsWith("One"); });
System.out.println(allMatch);
在上面的示例中,allMatch()方法将返回false,因为Stream中只有一个字符串以“ One”开头。
3.2.3、noneMatch()
Java Stream noneMatch() 方法是一个终端操作,它将对流中的元素进行迭代并返回true或false,这取决于流中是否没有元素与作为参数传递给noneMatch() 的谓词相匹配。如果谓词不匹配任何元素,则noneMatch() 方法将返回true;如果匹配一个或多个元素,则方法将返回false。
这是一个Java Stream noneMatch() 示例:
List<String> stringList = new ArrayList<String>();
stringList.add("abc");
stringList.add("def");
Stream<String> stream = stringList.stream();
boolean noneMatch = stream.noneMatch((element) -> {
return "xyz".equals(element);
});
System.out.println("noneMatch = " + noneMatch);
3.2.4、collect()
Java Stream collect() 方法是一种终端操作,它开始元素的内部迭代,并以某种类型的集合或对象接收流中的元素。
这是一个简单的Java Stream collect()方法示例:
List<String> stringList = new ArrayList<String>();
stringList.add("One flew over the cuckoo's nest");
stringList.add("To kill a muckingbird");
stringList.add("Gone with the wind");
Stream<String> stream = stringList.stream();
List<String> stringsAsUppercaseList = stream
.map(value -> value.toUpperCase())
.collect(Collectors.toList());
System.out.println(stringsAsUppercaseList);
collect() 方法采用Collector(java.util.stream.Collector)作为参数。实现Collector需要对Collector接口进行一些研究。幸运的是,Java类java.util.stream.Collectors包含了一组可以用于最常用操作的预先实现的Collector实现。在上面的示例中,使用的是Collectors.toList() 返回的Collector实现。该Collector只是将流中的所有元素收集到标准Java List中。
3.2.5、 count()
Java Stream count() 方法是一种终端操作,用于启动Stream中元素的内部迭代并计算元素。这是一个Java Stream count() 示例:
List<String> stringList = new ArrayList<String>();
stringList.add("One flew over the cuckoo's nest");
stringList.add("To kill a muckingbird");
stringList.add("Gone with the wind");
Stream<String> stream = stringList.stream();
long count = stream.flatMap((value) -> {
String[] split = value.split(" ");
return (Stream<String>) Arrays.asList(split).stream();
})
.count();
System.out.println("count = " + count);
此示例首先创建一个字符串列表,然后获取该列表的Stream,为其添加一个flatMap()操作,然后完成对count()的调用。count()方法将开始Stream中元素的迭代,flatMap()操作中将字符串元素拆分为单词,然后进行计数。最终打印出来的结果是14。
3.2.6、findAny()
Java Stream findAny() 方法可以从Stream中查找单个元素。找到的元素可以来自Stream中的任何位置。无法保证从流中何处获取元素。
这是一个Java Stream findAny()示例:
List<String> stringList = new ArrayList<String>();
stringList.add("one");
stringList.add("two");
stringList.add("three");
stringList.add("one");
Stream<String> stream = stringList.stream();
Optional<String> anyElement = stream.findAny();
System.out.println(anyElement.get());
注意findAny()方法返回了Optional。Stream可能为空——因此无法返回任何元素。可以检查是否通过可选的isPresent()方法找到元素。
3.2.7、findFirst()
如果Stream中存在任何元素,则Java Stream findFirst()方法将查找Stream中的第一个元素。findFirst()方法返回一个Optional,可以从中获取元素(如果存在)。
这是一个Java Stream findFirst() 示例:
List<String> stringList = new ArrayList<String>();
stringList.add("one");
stringList.add("two");
stringList.add("three");
stringList.add("one");
Stream<String> stream = stringList.stream();
Optional<String> result = stream.findFirst();
System.out.println(result.get());
可以通过isPresent() 方法检查Optional返回的元素是否包含元素。
3.2.8、forEach()
Java Stream forEach() 方法是一种终端操作,它对Stream中元素迭代,并将Consumer(java.util.function.Consumer)应用于Stream中的每个元素。forEach() 无返回值。
这是一个Java Stream forEach() 示例:
List<String> stringList = new ArrayList<String>();
stringList.add("one");
stringList.add("two");
stringList.add("three");
stringList.add("one");
Stream<String> stream = stringList.stream();
stream.forEach( element -> { System.out.println(element); });
3.2.9、min()
Java Stream min() 方法是一种终端操作,它返回Stream中的最小元素。哪个元素最小是由传递给min() 方法的Comparator实现确定的。
这是一个Java Stream min() 示例:
List<String> stringList = new ArrayList<String>();
stringList.add("abc");
stringList.add("def");
Stream<String> stream = stringList.stream();
Optional<String> min = stream.min((val1, val2) -> {
return val1.compareTo(val2);
});
String minString = min.get();
System.out.println(minString);
注意min() 方法返回一个Optional,它可能包含也可能不包含结果。如果Stream为空,则Optional get()方法将抛出NoSuchElementException。
3.2.10、max()
Java Stream max() 方法是一种终端操作,它返回Stream中最大的元素。哪个元素最大,取决于传递给max()方法的Comparator实现。
这是一个Java Stream max() 示例:
List<String> stringList = new ArrayList<String>();
stringList.add("abc");
stringList.add("def");
Stream<String> stream = stringList.stream();
Optional<String> max = stream.max((val1, val2) -> {
return val1.compareTo(val2);
});
String maxString = max.get();
System.out.println(maxString);
注意max() 方法如何返回一个Optional,它可以包含也可以不包含结果。如果Stream为空,则Optional get()方法将抛出NoSuchElementException。
3.2.11、reduce()
Java Stream reduce() 方法是一种终端操作,可以将流中的所有元素缩减为单个元素。
这是一个Java Stream reduce() 示例:
List<String> stringList = new ArrayList<String>();
stringList.add("One flew over the cuckoo's nest");
stringList.add("To kill a muckingbird");
stringList.add("Gone with the wind");
Stream<String> stream = stringList.stream();
Optional<String> reduced = stream.reduce((value, combinedValue) -> {
return combinedValue + " + " + value;
});
System.out.println(reduced.get());
3.2.12、toArray()
Java Stream toArray() 方法是一种终端操作,它迭代流中元素,并返回包含所有元素的Object数组。
这是一个Java Stream toArray() 示例:
List<String> stringList = new ArrayList<String>();
stringList.add("One flew over the cuckoo's nest");
stringList.add("To kill a muckingbird");
stringList.add("Gone with the wind");
Stream<String> stream = stringList.stream();
Object[] objects = stream.toArray();
3.2.13、sorted()
Collection 需要排序的时候可以使用Comparator和Comparable实现。在Java 8中,同样可以使用Comparator对Stream进行排序。
示例如下:
public class Human {
private String name;
private int age;
}
ArrayList<Human> humans = new ArrayList<Human>();
humans.add(new Human("李四", 4));
humans.add(new Human("王二", 2));
humans.add(new Human("张三", 3));
System.out.println(humans);
List<Human> sortHumans = humans.stream().sorted(Comparator.comparing(Human::getAge))
.collect(Collectors.toList());
System.out.println(sortHumans);
4、总结
Stream API是一组功能强大但易于理解的工具,用于处理元素序列。如果使用得当,我们可以减少大量的重复代码,创建更具可读性的程序,并提高应用的工作效率。
参考:
【1】:Java 8 中的 Streams API 详解
【2】:[译] 一文带你玩转 Java8 Stream 流,从此操作集合 So Easy
【3】:A Guide to Streams in Java 8: In-Depth Tutorial With Examples
【4】:The Java 8 Stream API Tutorial
【5】:java.util.stream
【6】:Introduction to Java 8 Streams
【7】:Java Stream API
【8】:Java8 使用 stream().sorted()对List集合进行排序
【9】:Java 8 Stream sorted() Example