カテゴリ: Java 更新日: 2026/06/07

Java Streamのemptyメソッドを使った空のストリーム作成入門

Streamのemptyメソッド
Streamのemptyメソッド

先生と生徒の会話形式で理解しよう

生徒

「先生、Streamで空のデータを扱いたいときはどうすればいいですか?」

先生

「そのような場合は、JavaのStreamクラスにあるemptyメソッドを使います。要素を一件も持たない空のストリームを作成できます。」

生徒

「空のストリームを作る意味はあるんですか?」

先生

「あります。実際のJava開発ではデータが存在しないケースがよくあります。そのようなときにnullではなく空のストリームを返すことで、安全にStream APIを利用できます。」

生徒

「なるほど。初心者でも覚えておいた方がよさそうですね。」

先生

「その通りです。それではJavaのStream.emptyメソッドについて詳しく学習していきましょう。」

1. emptyメソッドとは

1. emptyメソッドとは
1. emptyメソッドとは

JavaのStream APIには、空のストリームを作成するためのemptyメソッドが用意されています。パッケージはjava.util.streamで、クラスはStreamです。emptyメソッドは要素を一件も持たないストリームを生成します。

Java初心者の方は、空のストリームを作る意味が分からないかもしれません。しかし実際のシステム開発では、検索結果が存在しない場合や、条件によって処理対象が存在しない場合がよくあります。そのようなときに空のストリームを利用すると、プログラムを安全に実行できます。

Stream APIは、filter、map、sorted、distinct、forEach、collectなどの便利な機能を提供しています。emptyメソッドはそれらの処理と組み合わせて利用されることが多く、Javaプログラミングでは基本知識の一つとして覚えておきたいメソッドです。

2. 基本的な使い方

2. 基本的な使い方
2. 基本的な使い方

まずは最もシンプルなサンプルを見てみましょう。emptyメソッドを使って空のストリームを作成し、forEachで出力しています。要素が存在しないため何も表示されません。


import java.util.stream.Stream;

public class StreamEmptySample {
    public static void main(String[] args) {

        Stream<String> stream = Stream.empty();

        stream.forEach(System.out::println);
    }
}

(出力なし)

この例ではストリームは存在していますが、中にデータが入っていません。そのためforEachが実行されても出力される値はありません。

3. 空のストリームとnullの違い

3. 空のストリームとnullの違い
3. 空のストリームとnullの違い

Java学習者がよく混同するのが、空のストリームとnullの違いです。nullはオブジェクトそのものが存在しない状態です。一方で空のストリームは、ストリームオブジェクトは存在しているものの、要素が一件も存在しない状態です。

nullを返してしまうと、呼び出し側では毎回nullチェックが必要になります。しかしemptyメソッドで作成した空のストリームを返せば、通常のストリームとして扱うことができます。


import java.util.stream.Stream;

public class StreamCountSample {
    public static void main(String[] args) {

        Stream<String> stream = Stream.empty();

        long count = stream.count();

        System.out.println(count);
    }
}

0

このように空のストリームでもcountメソッドを安全に実行できます。結果は要素数がゼロなので〇が返されます。

4. 条件によって空のストリームを返す方法

4. 条件によって空のストリームを返す方法
4. 条件によって空のストリームを返す方法

実務では条件によってデータが存在する場合と存在しない場合があります。そのようなケースではemptyメソッドが活躍します。


import java.util.List;
import java.util.stream.Stream;

public class ConditionalStreamSample {
    public static void main(String[] args) {

        List<String> names = List.of();

        Stream<String> stream =
                names.isEmpty()
                ? Stream.empty()
                : names.stream();

        stream.forEach(System.out::println);
    }
}

(出力なし)

このサンプルではリストが空の場合にStream.emptyを返しています。これにより呼び出し側はデータの有無を意識せずにストリーム処理を続けることができます。

5. filterやmapと組み合わせる例

5. filterやmapと組み合わせる例
5. filterやmapと組み合わせる例

Stream APIの魅力は複数の処理を連続して実行できることです。emptyメソッドで作成したストリームでも、filterやmapを安全に利用できます。


import java.util.stream.Stream;

public class StreamFilterSample {
    public static void main(String[] args) {

        Stream<String> stream = Stream.empty();

        stream
            .filter(name -> name.length() > 3)
            .map(String::toUpperCase)
            .forEach(System.out::println);
    }
}

(出力なし)

要素が存在しないため処理結果はありませんが、エラーは発生しません。この特徴によってJavaプログラムの可読性や保守性を向上できます。

6. 実務で使われる場面

6. 実務で使われる場面
6. 実務で使われる場面

Javaの業務システムでは、会員管理システム、商品管理システム、在庫管理システム、予約管理システムなどさまざまな場面で検索処理を行います。しかし検索結果が必ず存在するとは限りません。

例えば商品検索を実行しても該当商品が見つからないことがあります。その場合にnullを返すよりも、空のストリームを返した方が安全です。後続の処理ではそのままfilterやmapやcollectを利用できます。

Spring BootやJakartaを利用したWebアプリケーション開発でも、Repositoryから取得したデータをStreamに変換して利用するケースがあります。そのためemptyメソッドは実務でも非常に重要な知識です。

7. emptyメソッドのメリット

7. emptyメソッドのメリット
7. emptyメソッドのメリット

emptyメソッドを利用する最大のメリットは、nullチェックを減らせることです。Java開発ではNullPointerExceptionを防ぐことが重要ですが、空のストリームを利用することでそのリスクを軽減できます。

また、コードが読みやすくなる点も大きな利点です。ストリーム処理を途中で分岐させる必要がなくなり、統一された書き方で実装できます。チーム開発では可読性が高いコードが求められるため、emptyメソッドは非常に役立ちます。

JavaのStream.emptyは、空のストリームを生成するための便利なメソッドです。nullの代わりに利用することで、安全で読みやすいJavaプログラムを作成できます。

8. 初心者が覚えておきたいポイント

8. 初心者が覚えておきたいポイント
8. 初心者が覚えておきたいポイント

Java初心者の方は、まず空のストリームという考え方を理解することが大切です。ストリームが存在しないのではなく、ストリームの中にデータが入っていない状態であることを覚えておきましょう。

また、Stream APIではデータが存在する場合だけでなく、存在しない場合も考慮してプログラムを書く必要があります。emptyメソッドを活用することで、より堅牢なJavaアプリケーションを作成できるようになります。

JavaのStreamクラスにはmap、filter、sorted、distinct、limit、skip、collectなど多くの便利なメソッドがあります。emptyメソッドはそれらの処理を安全に利用するための土台となる機能です。Java資格学習やJava研修、Spring Boot学習を進める際にも頻繁に登場するため、しっかり理解しておきましょう。

まとめ

まとめ
まとめ

JavaのStream.emptyメソッドは、要素を一件も持たない空のストリームを作成するための基本的なメソッドです。パッケージはjava.util.streamで、クラスはStreamです。Stream APIを学習するときは、データがある場合の処理だけでなく、データが存在しない場合の処理も理解しておくことが大切です。実際のJavaプログラムでは、検索結果が見つからない場合、条件に合うデータが存在しない場合、初期状態としてまだ値がない場合など、空のデータを扱う場面がよくあります。そのようなときにnullを返すのではなく、Stream.emptyを使って空のストリームを返すことで、より安全で読みやすいコードを書くことができます。

空のストリームは、ストリームそのものが存在しない状態ではありません。ストリームという入れ物は存在しているものの、中に要素が入っていない状態です。そのため、forEach、filter、map、count、collectなどのStream APIのメソッドを呼び出しても、NullPointerExceptionが発生しにくくなります。Java初心者にとっては、nullと空のストリームの違いを理解することが非常に重要です。nullはオブジェクトが存在しない状態ですが、Stream.emptyで作成した空のストリームは、処理できる対象として存在しています。

Javaの実務開発では、会員管理システム、商品管理システム、在庫管理システム、予約管理システム、検索機能、一覧表示機能などで、データが一件も取得できない場面があります。たとえば、商品検索で条件に一致する商品がない場合や、ユーザーがまだ注文履歴を持っていない場合などです。このようなときにnullを返してしまうと、呼び出し側では毎回nullチェックが必要になります。しかし、Stream.emptyを返しておけば、呼び出し側は通常のストリーム処理と同じ書き方で処理を続けることができます。

Stream.emptyメソッドは、Javaの関数型プログラミングやラムダ式の学習とも相性がよいメソッドです。filterで条件に合うデータを絞り込み、mapで値を変換し、forEachで順番に処理する流れは、Stream APIの基本です。空のストリームを使うことで、データがない場合でも同じ流れで処理を書けます。これはコードの分岐を減らし、保守しやすいプログラムにつながります。

Stream.emptyは、空のデータを安全に扱うための便利なメソッドです。nullを避けたい場合や、条件によってデータが存在しない場合に活用できます。

次のサンプルでは、空のストリームを作成してcountメソッドで要素数を確認しています。要素が一件もないため、結果はゼロになります。


import java.util.stream.Stream;

public class StreamEmptyReview {
    public static void main(String[] args) {
        Stream<String> stream = Stream.empty();

        long count = stream.count();

        System.out.println(count);
    }
}

0

このように、空のストリームでもcountメソッドを安全に呼び出すことができます。もしstreamがnullであれば、countメソッドを呼び出した時点でエラーになる可能性があります。しかしStream.emptyで作成されたストリームは正常なオブジェクトなので、安心してStream APIの操作を続けられます。

また、条件によって空のストリームを返す書き方もよく使われます。データがある場合は通常のストリームを返し、データがない場合はStream.emptyを返すことで、呼び出し側の処理を統一できます。


import java.util.List;
import java.util.stream.Stream;

public class StreamEmptyUseCase {
    public static Stream<String> getNames(List<String> names) {
        if (names.isEmpty()) {
            return Stream.empty();
        }

        return names.stream();
    }

    public static void main(String[] args) {
        List<String> names = List.of();

        getNames(names)
                .filter(name -> name.length() >= 3)
                .forEach(System.out::println);
    }
}

(出力なし)

このサンプルでは、リストが空の場合にStream.emptyを返しています。呼び出し側では、リストが空かどうかを意識せずにfilterやforEachを使えます。これにより、Javaのコードが自然で読みやすくなります。特にチーム開発では、誰が読んでも処理の流れが分かりやすいことが大切です。Stream.emptyを使うことで、例外を避けながら、統一感のある実装にできます。

Java初心者がStream.emptyを学ぶときは、空のストリームは失敗ではなく、正常な結果の一つであると考えると理解しやすくなります。検索結果がゼロ件であることは、プログラムの異常ではありません。条件に一致するデータがなかったという正常な結果です。その正常な結果を安全に表現する方法の一つがStream.emptyです。

Spring Bootを使ったWebアプリケーション開発でも、Stream.emptyの考え方は役立ちます。RepositoryやServiceで取得したデータを処理するとき、データがない場合にnullを返すよりも、空のコレクションや空のストリームを返す方が扱いやすくなります。JavaのStream API、ラムダ式、メソッド参照、コレクション処理を理解するうえでも、emptyメソッドは基礎として押さえておきたい内容です。

Stream.emptyは、短いコードで使えるため簡単に見えますが、設計の考え方としてはとても大切です。nullを避ける、安全に処理する、呼び出し側のコードを分かりやすくする、Stream APIのチェーン処理を保つという複数のメリットがあります。Javaの基礎文法を学んだあと、実務に近い書き方を身につけたい方は、空のストリームの使いどころを意識しておくとよいでしょう。

先生と生徒の振り返り会話

生徒

「先生、Stream.emptyは要素が一件もないストリームを作るメソッドなんですね。」

先生

「はい。データがない場合でも、Stream APIの処理を安全に続けられるようにするためのメソッドです。」

生徒

「nullとは違って、ストリーム自体は存在しているという理解でよいですか。」

先生

「その理解で大丈夫です。nullはオブジェクトが存在しない状態ですが、Stream.emptyは中身が空のストリームです。」

生徒

「だからcountを呼び出すとゼロが返り、forEachを使ってもエラーにならないんですね。」

先生

「その通りです。空のストリームは正常に処理できるので、呼び出し側のコードをすっきり書けます。」

生徒

「検索結果がない場合や、リストが空の場合に使うと便利そうです。」

先生

「実務でもよく使われます。商品検索、会員検索、注文履歴、在庫確認など、データが存在しないケースはたくさんあります。」

生徒

「Stream.emptyを返しておけば、filterやmapやforEachを同じように書けるので、分岐が少なくなりますね。」

先生

「はい。JavaのStream APIでは、処理の流れを止めずに書けることが大切です。空のストリームを上手に使うと、読みやすく安全なプログラムになります。」

生徒

「Java初心者でも、nullを返すよりStream.emptyを返す方がよい場面があると覚えておきます。」

先生

「とても大切なポイントです。すべての場面で必ず使うわけではありませんが、Streamを返す設計ではStream.emptyを選ぶことで、保守しやすいコードになります。」

生徒

「Stream.emptyは短いメソッドですが、Javaの安全な書き方を学ぶうえで重要なんですね。」

先生

「その通りです。JavaのStream、emptyメソッド、空のストリーム、null対策、Stream APIの基本をセットで理解しておくと、実務でも学習でも役立ちます。」

生成AIを基礎から学びたい方へ

ChatGPTなどの生成AIをこれから学びたい方に向けて、AIスキルアカデミーの口コミ・評判、料金、無料セミナーの内容を詳しくまとめています。

AIスキルアカデミーの口コミ・評判を詳しく見る
カテゴリの一覧へ
新着記事
New1
Spring
Spring Data JPAのJpaRepositoryインターフェースの使い方を完全ガイド!初心者でも安心
更新記事
New2
Java
JavaのVectorクラスの使い方を完全ガイド!初心者でもわかるコレクションの基本
更新記事
New3
JSP
JSPのEL式で論理演算を行う方法を完全解説 初心者でもわかるAND OR NOTの使い方と条件分岐
新規投稿
New4
Java
JavaのHashMapクラスを完全ガイド!初心者でもわかる連想配列の使い方
更新記事
人気記事
No.1
Java&Spring記事人気No1
Servlet
JavaのGenericServletクラスの使い方を徹底解説!初心者でもわかるServletの基本とHttpServletとの違い
No.2
Java&Spring記事人気No2
Servlet
JavaのHttpServletRequestWrapperとauthenticateメソッドとは?初心者にもわかりやすく解説!
No.3
Java&Spring記事人気No3
Servlet
JavaのHttpServletRequestWrapperとlogoutメソッドを完全ガイド!初心者でもわかるログアウト処理の方法
No.4
Java&Spring記事人気No4
Servlet
JavaのHttpServletRequestWrapperとgetMethodメソッドの使い方を徹底解説!初心者向けHTTPリクエストメソッド取得ガイド
No.5
Java&Spring記事人気No5
Servlet
JavaのHttpServletRequestWrapperとgetUserPrincipalメソッドを徹底解説!初心者でもわかる認証ユーザー情報の取得方法
No.6
Java&Spring記事人気No6
Servlet
JavaのHttpServletRequestWrapperとupgradeメソッドを徹底解説!初心者でもわかるプロトコルアップグレードの基本
No.7
Java&Spring記事人気No7
Java
Java Streamのgenerateメソッド完全ガイド!初心者でもわかる乱数と定数ストリーム生成
No.8
Java&Spring記事人気No8
Servlet
JavaのサーブレットのdoGetメソッドとは?GETリクエストの仕組みと使い方を初心者向けに徹底解説