The following methods in the Stream interface are used to perform find operations:
Optional<T> findAny() Optional<T> findFirst()
IntStream, LongStream, and DoubleStream also contain the same methods for primitive types.
All find operations are terminal operations.
They are also short-circuiting operations.
A short-circuiting operation may not have to process the entire stream to return the result.
The return type of the findAny() and findFirst() methods is Optional<T> because these methods may not have a result if the stream is empty.
import java.time.LocalDate; import java.time.Month; import java.util.Arrays; import java.util.List; import java.util.Optional; public class Main { public static void main(String[] args) { // Get the list of persons List<Person> persons = Person.persons(); // Find any male Optional<Person> anyMale = persons.stream().filter(Person::isMale).findAny(); if (anyMale.isPresent()) { System.out.println("Any male: " + anyMale.get()); } else {//from ww w . j av a2 s. c o m System.out.println("No male found."); } // Find the first male Optional<Person> firstMale = persons.stream().filter(Person::isMale).findFirst(); if (firstMale.isPresent()) { System.out.println("First male: " + anyMale.get()); } else { System.out.println("No male found."); } } } class Person { // An enum to represent the gender of a person public static enum Gender { MALE, FEMALE } private long id; private String name; private Gender gender; private LocalDate dob; private double income; public Person(long id, String name, Gender gender, LocalDate dob, double income) { this.id = id; this.name = name; this.gender = gender; this.dob = dob; this.income = income; } public long getId() { return id; } public void setId(long id) { this.id = id; } public String getName() { return name; } public void setName(String name) { this.name = name; } public Gender getGender() { return gender; } public boolean isMale() { return this.gender == Gender.MALE; } public boolean isFemale() { return this.gender == Gender.FEMALE; } public void setGender(Gender gender) { this.gender = gender; } public LocalDate getDob() { return dob; } public void setDob(LocalDate dob) { this.dob = dob; } public double getIncome() { return income; } public void setIncome(double income) { this.income = income; } public static List<Person> persons() { Person ken = new Person(1, "Java", Gender.MALE, LocalDate.of(1970, Month.MAY, 4), 6020.0); Person jeff = new Person(2, "Jack", Gender.MALE, LocalDate.of(1970, Month.JULY, 15), 7320.0); Person donna = new Person(3, "Javascript", Gender.FEMALE, LocalDate.of(1972, Month.JULY, 29), 8720.0); Person chris = new Person(4, "XML", Gender.MALE, LocalDate.of(1993, Month.DECEMBER, 16), 5800.0); Person laynie = new Person(5, "Json", Gender.FEMALE, LocalDate.of(2002, Month.DECEMBER, 13), 0.0); Person lee = new Person(6, "Database", Gender.MALE, LocalDate.of(2011, Month.MAY, 9), 2400.0); // Create a list of persons List<Person> persons = Arrays.asList(ken, jeff, donna, chris, laynie, lee); return persons; } @Override public String toString() { String str = String.format("(%s, %s, %s, %s, %.2f)", id, name, gender, dob, income); return str; } }