【Java 8 新特性】Java Stream通过findFirst()查找满足条件的一条数据

Stream的findFirst方法在此流中查找第一个元素作为Optional。

如果流中没有元素，findFirst返回空的Optional。

如果流没有顺序，那么findFirst可以选择任何元素。

如果findFirst选择的元素为null，它将抛出NullPointerException。

在javadoc中的findFirst声明

Optional<T> findFirst() 

返回：findFirst方法返回Optional包含流中第一个元素的元素。
异常：如果选择null值，findFirst将抛出NullPointerException。

findFirst是短路终端操作(short-circuiting terminal operation)，流操作是一组中间操作和终端操作，如果中间操作可以为无限输入生成有限流，则它是短路(short-circuiting)。

下面我们来看一组例子

示例1：假设我们有一个整数流，并对其调用findFirst方法。

Stream.of(50, 60, 70).findFirst()
    .ifPresent(s -> System.out.println(s)); 

输出是50，这是流的第一个元素。

扩展

FindFirstDemo1.java

package com.concretepage;
import java.util.Arrays;
import java.util.List;
public class FindFirstDemo1 {
  public static void main(String[] args) {
	List<String> list = Arrays.asList("Vijay", "Suresh", "Vinod");
	String output = list.stream()
	  .filter(e -> e.startsWith("V")) // Vijay, Vinod
	  .findFirst() //Vijay
	  .orElse("NA");
	System.out.println(output);

	List<Integer> numList = Arrays.asList(31, 32, 33, 34);
	numList.stream()
	  .filter(n -> n % 2 == 0) // 32, 34
	  .findFirst() //32
	  .ifPresent(e -> System.out.println(e));
  }
} 

输出

Vijay
32 

示例2：下面是使用IntStream、LongStream和DoubleStream的findFirst方法的示例。

FindFirstDemo2.java

package com.concretepage;
import java.util.stream.DoubleStream;
import java.util.stream.IntStream;
import java.util.stream.LongStream;
public class FindFirstDemo2 {
  public static void main(String[] args) {
	IntStream intStream = IntStream.of(10, 20, 30, 40);
	intStream.filter(i -> i > 20).findFirst()
	     .ifPresent(i -> System.out.println(i));

	LongStream longStream = LongStream.of(100, 200, 300);
	longStream.filter(l -> l < 250).findFirst()
	     .ifPresent(l -> System.out.println(l));

	DoubleStream doubleStream = DoubleStream.of(100.52, 200.55, 300.66);
	doubleStream.filter(d -> d > 200).findFirst()
	     .ifPresent(l -> System.out.println(l));
  }
} 

输出

30
100
200.55 

示例3：下面是带有并行流的findFirst示例。

FindFirstDemo3.java

package com.concretepage;
import java.util.ArrayList;
import java.util.List;
public class FindFirstDemo3 {
  public static void main(String[] args) {
	List<Employee> list = new ArrayList<>();
	list.add(new Employee("Emp A", 3000));
	list.add(new Employee("Emp B", 4000));
	list.add(new Employee("Emp C", 5000));
	list.add(new Employee("Emp D", 6000));

	list.parallelStream()
	    .filter(e -> e.getSal() >= 4000 && e.getSal() <= 5000)
	    .mapToInt(e -> e.getSal())
	    .findFirst()
		.ifPresent(s -> System.out.println(s));
  }
}
class Employee {
  private String name;
  private int sal;

  public Employee(String name, int sal) {
	this.name = name;
	this.sal = sal;
  }
  //Sets and Gets
} 

输出

4000

示例4：下面是具有空值的findFirst示例。

FindFirstDemo4.java

package com.concretepage;
import java.util.stream.Stream;
public class FindFirstDemo4 {
  public static void main(String[] args) {
	Stream.of(null, "A").
	    findFirst().ifPresent(s -> System.out.println(s));
  }
} 

输出将为NullPointerException。

参考文献

【1】Java doc: Stream
【2】Java Stream findFirst()