カテゴリ: Java 更新日: 2026/08/01

JavaのStreamインターフェースのflatMapを完全ガイド!初心者でもわかる入れ子データの展開と変換

StreamのflatMapメソッド
StreamのflatMapメソッド

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

生徒

「Javaで配列やリストの中にさらに別のリストが入っているとき、全部を一列に並べて処理したいのですが、どうやって書けばいいですか?」

先生

「そんなときに使えるのが、java.util.streamパッケージにあるStreamインターフェースのflatMapです。入れ子になったデータを平らに広げながら変換できます。」

生徒

「mapとは何が違うんですか?同じように見えるのですが、使い分けが難しいです。」

先生

「mapは一対一の変換、flatMapは一対多の展開と変換を同時に行うという考え方です。まず基本から順に確かめていきましょう。」

1. flatMapの基本を理解しよう

1. flatMapの基本を理解しよう
1. flatMapの基本を理解しよう

flatMapは、要素一つから複数の要素を生み出す処理を行い、その結果できた複数の要素を一つの流れに統合するための操作です。入れ子の構造を平らに整えるという意味合いがあり、二重三重に重なったリストや配列を扱うときに使うと、後続の処理がすっきり読みやすくなります。たとえば、文字列の配列が複数入ったリストを一列に並べ直したい、区切り文字で分割した語句を一つの一覧に統合したい、外部から取得した複数件の結果をまとめて扱いたい、といった場面で役立ちます。

処理の流れとしては、まず元の要素から新しいストリームを作り、すぐに平らに統合するイメージです。ひとつの要素がゼロ個の結果になることもあれば、複数個の結果になることもあります。flatMapはそのばらつきを自然に受け止めてくれるため、繰り返しや条件分岐を自分で細かく書かずに済み、初心者でも読みやすい表現で組み立てられます。

2. mapとの違いを直感でつかむ

2. mapとの違いを直感でつかむ
2. mapとの違いを直感でつかむ

mapは要素を一対一で変換します。たとえば文字列を大文字にする、数値を二倍にする、といった処理です。対してflatMapは、一つの要素を複数の要素へ展開してから統合します。たとえば一つの文章を単語へ分割し、すべての文章の単語を一つの一覧に集める、といった処理が代表例です。もし入れ子の構造をmapで処理すると、Stream<Stream<T>>のように二重の流れができてしまい、終端操作までに余分な段階が残ります。flatMapはこれを一度で平らにできるため、後続の絞り込みや集計が自然な形で書けます。

また、flatMapには数値版の操作もあり、flatMapToInt、flatMapToLong、flatMapToDoubleのように、数値専用のストリームへ直接展開できます。用途に応じて使い分けると、集計や統計の処理がさらに短く、読みやすくなります。

3. 入れ子のリストを一列に並べ替える基本例

3. 入れ子のリストを一列に並べ替える基本例
3. 入れ子のリストを一列に並べ替える基本例

複数のリストが入れ子になっているとき、flatMapを使うと簡単に一列にまとめられます。まずは最も基本的な例で感覚をつかみましょう。


import java.util.List;
import java.util.stream.Collectors;

public class FlatMapBasic {
    public static void main(String[] args) {
        List<List<String>> data = List.of(
                List.of("りんご", "みかん"),
                List.of("ぶどう", "もも")
        );

        List<String> flat = data.stream()
                .flatMap(list -> list.stream())
                .collect(Collectors.toList());

        System.out.println(flat);
    }
}

[りんご, みかん, ぶどう, もも]

ここでは、各リストからstream()で部分的な流れを作り、それらをflatMapで統合しています。二重構造のまま処理を続ける必要がなくなり、その後のfilterやsortedなどが自然に記述できます。

4. 文章を単語に分割して一覧化する例

4. 文章を単語に分割して一覧化する例
4. 文章を単語に分割して一覧化する例

文章の配列やリストを扱うとき、空白などの区切りで単語へ分割し、一つの一覧として扱いたい場面はよくあります。flatMapは分割の結果をすぐに統合できるため、後続の処理が読みやすくなります。


import java.util.Arrays;
import java.util.List;
import java.util.stream.Collectors;

public class FlatMapSplit {
    public static void main(String[] args) {
        List<String> lines = List.of("apple orange", "banana grape", "melon");

        List<String> words = lines.stream()
                .flatMap(line -> Arrays.stream(line.split("\\s+")))
                .collect(Collectors.toList());

        System.out.println(words);
    }
}

[apple, orange, banana, grape, melon]

分割の結果は要素数がまちまちですが、flatMapを使えば綺麗に一列へまとめられます。あとはdistinctで重複を消したり、sortedで並び替えたり、filterで条件を絞ったり、自由に組み合わせられます。

5. オブジェクトから子要素を取り出す設計

5. オブジェクトから子要素を取り出す設計
5. オブジェクトから子要素を取り出す設計

実務では、親オブジェクトが子オブジェクトのコレクションを持つという設計がよくあります。顧客と注文、学校と生徒、部署とメンバーなどの関係です。flatMapを使えば、親から子の一覧へまっすぐ到達でき、後続の処理が簡潔になります。


import java.util.List;
import java.util.stream.Collectors;

class Order {
    private final String name;
    Order(String name){ this.name = name; }
    public String getName(){ return name; }
}
class Customer {
    private final String customerName;
    private final List<Order> orders;
    Customer(String customerName, List<Order> orders){
        this.customerName = customerName; this.orders = orders;
    }
    public List<Order> getOrders(){ return orders; }
}

public class FlatMapNestedObject {
    public static void main(String[] args) {
        Customer a = new Customer("A", List.of(new Order("本"), new Order("文房具")));
        Customer b = new Customer("B", List.of(new Order("食品")));
        List<Customer> customers = List.of(a, b);

        List<String> allOrderNames = customers.stream()
                .flatMap(c -> c.getOrders().stream())
                .map(Order::getName)
                .collect(Collectors.toList());

        System.out.println(allOrderNames);
    }
}

[本, 文房具, 食品]

入れ子の設計を直接平らにできるため、余計な二重のループや一時的なリスト作成を避けられます。可読性と保守性の向上に直結します。

6. 空要素や欠損値を安全に扱う考え方

6. 空要素や欠損値を安全に扱う考え方
6. 空要素や欠損値を安全に扱う考え方

展開の対象が空の場合や、欠損値が含まれる場合にもflatMapは有効です。空のコレクションをそのまま流せば結果に影響を与えませんし、条件により要素をゼロ個にすることもできます。さらに、値の有無を表すOptionalと組み合わせると、安全で読みやすい記述になります。存在するものだけを平らに集めたいときに便利です。


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

public class FlatMapOptional {
    static Optional<String> findNick(String name){
        if(name.length() >= 2) return Optional.of(name.substring(0, 2));
        return Optional.empty();
    }
    public static void main(String[] args) {
        List<String> names = List.of("田中", "山", "佐藤");

        List<String> nicks = names.stream()
                .map(FlatMapOptional::findNick)
                .flatMap(opt -> opt.map(Stream::of).orElseGet(Stream::empty))
                .collect(Collectors.toList());

        System.out.println(nicks);
    }
}

[田中, 佐藤]

欠損を安全に無視しながら、存在する値だけを集められます。例外や特別なフラグに頼らず、読みやすい流れを保てます。

7. flatMapとfilterやmapの組み合わせ

7. flatMapとfilterやmapの組み合わせ
7. flatMapとfilterやmapの組み合わせ

flatMapは前後の操作と相性が良く、絞り込み、変換、集計の段階を明確に表現できます。展開したあとに条件で残す要素を決め、必要なら変換で形を整え、最後に集計や表示を行うという順序で書くと、流れの意図が読み取りやすくなります。処理コストの面でも、不要な要素を早めに捨てる設計にすることで効率を保ちやすくなります。


import java.util.Arrays;
import java.util.List;
import java.util.stream.Collectors;

public class FlatMapFilterMap {
    public static void main(String[] args) {
        List<String> lines = List.of("red,green", "blue,red", "yellow");

        List<String> reds = lines.stream()
                .flatMap(s -> Arrays.stream(s.split(",")))
                .map(String::trim)
                .filter(c -> c.equals("red"))
                .collect(Collectors.toList());

        System.out.println(reds);
    }
}

[red, red]

読みやすく、意図が明確で、あとから条件を追加しても破綻しにくい構造になります。

8. 二重ループをflatMapで置き換える考え方

8. 二重ループをflatMapで置き換える考え方
8. 二重ループをflatMapで置き換える考え方

二重の繰り返しをflatMapで書き換えると、段取りが明確なコードへ変わります。外側の要素から内側の要素を取り出して並べるという構造は、入れ子のループで書くよりもストリームの展開として表現したほうが理解しやすい場面が多くあります。可読性と保守性が求められる現場では、flatMapへの置き換えは有効な選択になります。


import java.util.List;
import java.util.stream.Collectors;

public class FlatMapFromNestedLoop {
    public static void main(String[] args) {
        List<List<Integer>> nums = List.of(
                List.of(1, 2),
                List.of(3, 4, 5)
        );

        List<Integer> all = nums.stream()
                .flatMap(l -> l.stream())
                .collect(Collectors.toList());

        System.out.println(all);
    }
}

[1, 2, 3, 4, 5]

入れ子を平らにする目的が先に見えるため、読む人にとって負担が少なくなります。追加要件にも対応しやすく、変更の影響範囲も読み取りやすくなります。

9. 大量データや外部データと向き合うときの注意点

9. 大量データや外部データと向き合うときの注意点
9. 大量データや外部データと向き合うときの注意点

大量の要素をflatMapで展開する場合、不要な展開を避ける工夫が大切です。先に必要十分な条件で絞り込みを行い、それから展開すると処理量を抑えられます。区切り文字の分割では、余計な空要素が生まれないように前後の空白を整えてから展開すると扱いやすくなります。外部データやファイルの内容を扱うときも、エンコードや改行の揺れに注意し、正しく分割できているかを小さなテストで確かめてから本番の処理へ進めると、原因調査の手間を減らせます。

また、展開の結果が非常に大きくなると、メモリ使用量が増えることがあります。必要に応じてページングや分割処理を取り入れ、段階的に集計する設計も検討しましょう。処理の順序を工夫するだけで実行時間が改善することも多く、現場では重要な観点になります。

10. 学習の進め方と練習のコツ

10. 学習の進め方と練習のコツ
10. 学習の進め方と練習のコツ

最初は単純な入れ子のリストを平らにするところから練習し、次に分割とトリムの組み合わせ、最後にオブジェクトの子要素を取り出す例へ進むと、flatMapの意図が自然に身につきます。filterやmap、distinct、sortedといった周辺の操作と組み合わせつつ、目的に合わせて順序を調整する練習を重ねると、読みやすさと性能の両立が図れます。入れ子の構造を平らにするという意識が定着すると、複雑な要件でも落ち着いて設計できるようになります。

まとめ

まとめ
まとめ

flatMapの本質と使いどころの整理

JavaのStreamインターフェースにおけるflatMapは、入れ子構造のデータを平らに展開しながら変換できる非常に重要な中間操作です。リストの中にリストが入っている構造や、文字列の分割結果、オブジェクトの子要素などを一つの流れにまとめることで、その後のfilterやmap、collectなどの処理を自然な形でつなげることができます。 特に実務では、データベース検索結果や外部APIレスポンス、ファイル読み込み結果など、階層構造のデータを扱う場面が多く、flatMapを理解しているかどうかでコードの可読性と保守性に大きな差が出ます。 mapとの違いとして、mapは一対一の変換であるのに対し、flatMapは一対多の展開と統合を同時に行う点が重要です。この違いを正しく理解することで、二重構造のストリームを回避し、シンプルで読みやすい処理が実現できます。

入れ子構造を扱う実践的な考え方

入れ子構造のデータを扱う際には、まず平らにするという意識を持つことが重要です。二重三重のループで処理を書くのではなく、flatMapを使って一度データを展開し、その後に必要な条件で絞り込むという流れを意識すると、処理の意図が明確になります。 また、Optionalや空リストを組み合わせることで、存在しない値を自然に除外しながら安全に処理を進めることもできます。これにより、例外処理を過剰に書かずに済み、コードの見通しが良くなります。

実務で役立つ設計ポイント

実務でflatMapを使う際には、処理順序を意識することが重要です。まず不要なデータをfilterで除外し、その後にflatMapで展開することで、無駄な処理を減らすことができます。 また、文字列分割では余計な空白や空要素が含まれないようにtrimを併用することも大切です。 さらに、大量データを扱う場合には、展開後の要素数が増えすぎないように設計し、必要に応じて分割処理や段階的な集計を取り入れることで、パフォーマンスを維持できます。

サンプルプログラム(応用例)


import java.util.Arrays;
import java.util.List;
import java.util.stream.Collectors;

public class FlatMapSummaryExample {
    public static void main(String[] args) {
        List<String> data = List.of("java spring", "stream api", "flatmap guide");

        List<String> result = data.stream()
                .flatMap(s -> Arrays.stream(s.split(" ")))
                .map(String::toUpperCase)
                .filter(word -> word.length() >= 5)
                .collect(Collectors.toList());

        System.out.println(result);
    }
}

実行結果


[SPRING, STREAM, FLATMAP, GUIDE]

初心者が意識すべき理解ポイント

flatMapを理解するためには、まず入れ子構造を平らにするというイメージをしっかり持つことが大切です。そのうえで、mapとの違いを意識しながら、どの場面で使うべきかを判断できるようになると、コードの品質が大きく向上します。 また、Stream API全体の流れとして、中間操作と終端操作の役割を理解することも重要です。flatMapは中間操作であり、collectやforEachなどの終端操作と組み合わせて初めて結果が得られる点も押さえておきましょう。 実際に手を動かしてコードを書くことで理解が深まるため、小さなサンプルから段階的に学習を進めることをおすすめします。

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

生徒

「flatMapは最初難しく感じましたが、入れ子を平らにするって考えると分かりやすいですね。」

先生

「その理解がとても大切です。mapとの違いを意識することで、使い分けも自然にできるようになります。」

生徒

「二重ループを書かなくても済むので、コードがすっきりしました。」

先生

「そうですね。可読性と保守性が大きく向上します。実務でもよく使われる重要なテクニックです。」

生徒

「filterやmapと組み合わせることで、いろいろな処理が書けそうです。」

先生

「その通りです。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リクエストの仕組みと使い方を初心者向けに徹底解説