Java Stream allMatch()方法详解

文
章
目
录

• 1.allMatch()方法
• 1.1 语法
• 1.2 描述
• 2.allMatch()方法示例
• 3.allMatch()方法与短路操作
• 4.总结

Java Stream的allMatch()方法是一个短路终端操作，用于检查流中所有元素是否满足提供的断言。

1.allMatch()方法

1.1 语法

boolean allMatch(Predicate<? super T> predicate)

allMatch()方法接受一个Predicate接口实例作为参数，该接口实例定义了一个test()方法，该方法接受一个参数并返回一个布尔值。

1.2 描述

allMatch()方法对流中的每个元素应用该断言，如果所有元素都满足断言条件，则返回true，否则返回false。

allMatch()方法与anyMatch()方法相反。anyMatch()方法只要找到一个满足断言的元素就返回true。而allMatch()方法只有当所有元素都满足断言时才返回true。

2.allMatch()方法示例

示例1：下面是一个使用allMatch()方法的示例，检查一个字符串流中是否所有元素都包含数字字符：

List<String> list = Arrays.asList(\"123\", \"456\", \"789\");
boolean result = list.stream().allMatch(str -> str.matches(\".*\\\\d+.*\"));
System.out.println(result); // 输出：true    //true

在这个例子中，我们使用list.stream()创建一个字符串流，然后使用allMatch()方法检查是否所有元素都满足断言条件。断言条件是使用正则表达式匹配任何包含数字字符的字符串。由于所有元素都包含数字字符，所以结果为true。

示例2：具有多个条件的Stream.allMatch() 方法

要满足多个条件，可以使用两个或多个简单predicate创建一个组合predicate。

在给定示例中，我们有一个Employee类型的列表。我们想要检查所有年龄超过50岁的员工是否收入超过40,000。

在列表中，员工“B”收入低于40,000并且年龄超过50岁，因此结果为false。

public class Main 
{
  public static void main(String[] args) 
  {
    Predicate<Employee> olderThan50 = e -> e.getAge() > 50;
    Predicate<Employee> earningMoreThan40K = e -> e.getSalary() > 40_000;
    Predicate<Employee> combinedCondition = olderThan50.and(earningMoreThan40K);
     
    boolean result = getEmployeeStream().allMatch(combinedCondition);
    System.out.println(result);  //false
  }
   
  private static Stream<Employee> getEmployeeStream()
  {
    List<Employee> empList = new ArrayList<>();
    empList.add(new Employee(1, \"A\", 46, 30000));
    empList.add(new Employee(2, \"B\", 56, 30000));
    empList.add(new Employee(3, \"C\", 42, 50000));
    empList.add(new Employee(4, \"D\", 52, 50000));
    empList.add(new Employee(5, \"E\", 32, 80000));
    empList.add(new Employee(6, \"F\", 72, 80000));
     
    return empList.stream();
  }
}
 
@Data
@AllArgsConstructor
class Employee 
{
  private long id;
  private String name;
  private int age;
  private double salary;
}

3.allMatch()方法与短路操作

allMatch()方法是一个短路终端操作，这意味着在确定结果后，它可能会提前终止处理流中的元素。在某些情况下，这可以提高效率。例如，如果已经找到一个不满足断言的元素，那么继续检查其他元素就没有必要了。

4.总结

Java Stream的allMatch()方法可以用于检查流中所有元素是否满足给定的断言条件。它是短路终端操作，可以在确定结果后提前终止处理流中的元素。在需要验证所有元素是否满足特定条件的场景中，可以使用allMatch()方法。例如，我们可以在Employee对象的流上使用allMatch()方法来验证所有员工是否都超过了一定年龄。这是一种短路操作。如果一个终止操作在面对无限输入时能在有限时间内终止，那么它就是短路操作。