🦔

Java Stream API における filter 処理の基本と実践例

に公開

Java Stream API における filter 処理の基本と実践例

Java 8 から導入された Stream API は、コレクション操作を簡潔かつ宣言的に記述できる強力な仕組みです。
本記事では、その中でも特に使用頻度の高い filter 処理について、サンプルコードを用いて解説します。


1. filter とは何か

filter は、条件に合致する要素のみを通過させる中間操作です。

stream.filter(条件式)
  • 条件式は Predicate<T>(戻り値が boolean)
  • true → 要素を残す
  • false → 要素を除外する

SQL の WHERE 句に近い役割を持ちます。


2. 元となる処理の概要

以下は、試験結果のリストから スコアだけを抽出し、null を除外する処理です。

List<Integer> scored = subjectResults.stream()
    .map(VRoutineExam::getScore)
    .filter(Objects::nonNull)
    .collect(Collectors.toList());

この処理は次の3ステップで構成されています。

  1. map:オブジェクト → スコア(Integer) に変換
  2. filter:null を除外
  3. collect:List に変換

3. 記事用のサンプルコード

3.1 サンプルクラス

public class ExamResult {
    private String subject;
    private Integer score;

    public ExamResult(String subject, Integer score) {
        this.subject = subject;
        this.score = score;
    }

    public String getSubject() {
        return subject;
    }

    public Integer getScore() {
        return score;
    }
}

3.2 サンプルデータ

List<ExamResult> results = Arrays.asList(
    new ExamResult("Math", 80),
    new ExamResult("English", null),
    new ExamResult("Science", 65),
    new ExamResult("History", null)
);

3.3 filter を使った実装例

List<Integer> scores = results.stream()
    // ExamResult から score のみを取得
    .map(ExamResult::getScore)

    // score が null のデータを除外
    .filter(Objects::nonNull)

    // List<Integer> に変換
    .collect(Collectors.toList());

実行結果

[80, 65]

4. filter の処理を詳しく見る

4.1 Objects::nonNull の意味

.filter(Objects::nonNull)

これは以下と同じ意味です。

.filter(score -> score != null)

メソッド参照を使うことで、コードをより簡潔に書けます。


4.2 filter を使わない場合との比較

従来の for 文

List<Integer> scores = new ArrayList<>();

for (ExamResult result : results) {
    if (result.getScore() != null) {
        scores.add(result.getScore());
    }
}

Stream API 使用時

List<Integer> scores = results.stream()
    .map(ExamResult::getScore)
    .filter(Objects::nonNull)
    .collect(Collectors.toList());

➡ 条件判定とデータ変換の意図が明確になり、可読性が向上


5. filter の応用例

5.1 点数が60点以上のみ抽出

List<Integer> passedScores = results.stream()
    .map(ExamResult::getScore)
    .filter(score -> score != null && score >= 60)
    .collect(Collectors.toList());

5.2 複数条件での filter

List<ExamResult> passedResults = results.stream()
    .filter(r -> r.getScore() != null)
    .filter(r -> r.getScore() >= 70)
    .collect(Collectors.toList());

6. まとめ

  • filter は 条件に合致する要素のみを残す中間処理
  • Objects::nonNull を使うことで null チェックを簡潔に記述可能
  • map と組み合わせることで、データ変換+条件抽出が明確になる
  • 従来の for 文に比べて 可読性・保守性が向上

Stream API の filter を適切に使うことで、ロジックの意図が伝わりやすいコードを書くことができます。

Discussion