Java StreamのfindAny()メソッドの使い方を例付きで解説

Java Stream APIのfindAny()メソッドは、ストリーム内のいずれか1つの要素を返すメソッドです。戻り値はOptional型で、ストリームが空の場合には空のOptionalが返されます。ここでいうOptionalとは、null以外の値を保持している場合と保持していない場合があるコンテナオブジェクトのことです。

findAny()は並列処理（parallel stream）との相性が良く、どの要素が返されても問題ない場合に効率的に動作するのが特徴です。

基本的な構文

Optional<T> result = stream.findAny();

例1：整数のリストからfindAny()を使う

以下は、整数のリストに対してfindAny()メソッドを実装した例です。

import java.util.*;
public class Demo {
    public static void main(String[] args){
        List<Integer> list = Arrays.asList(10, 20, 30, 40, 50);
        Optional<Integer> res = list.stream().findAny();
        if (res.isPresent()) {
            System.out.println(res.get());
        } else {
            System.out.println("要素なし！");
        }
    }
}

出力結果

10

この例では、リスト内のいずれかの要素が取得され、ここでは「10」が出力されています。isPresent()メソッドで値の存在を確認してから、get()で値を取り出しています。

例2：文字列のリストからfindAny()を使う

次に、文字列のリストを使った別の例を見てみましょう。

import java.util.*;
public class Demo {
    public static void main(String[] args) {
        List<String> myList = Arrays.asList("Kevin", "Jofra", "Tom", "Chris", "Liam");
        Optional<String> res = myList.stream().findAny();
        if (res.isPresent()) {
            System.out.println(res.get());
        } else {
            System.out.println("要素なし！");
        }
    }
}

出力結果

Kevin

findAny()を使う際のポイント

• 戻り値は必ずOptional：ストリームが空でも例外が発生せず、空のOptionalが返されるため、安全に扱えます。
• 返される要素は不定：順次ストリームでは通常最初の要素が返されますが、仕様上はどの要素が返されるか保証されていません。
• orElse()との併用が便利：res.orElse(デフォルト値)のように書くと、要素が存在しない場合のデフォルト値を簡潔に指定できます。

このように、findAny()メソッドはOptionalと組み合わせることで、nullチェックを意識せずに安全なコードを書くことができる便利なメソッドです。