Java Stream map応用！型変換やネスト・オブジェクト加工の実践テクニック

1. Java Stream APIのmapメソッドとは何か

1. Java Stream APIのmapメソッドとは何か

JavaのStream APIにおけるmapメソッドは、ストリーム内の各要素に対して特定の処理を行い、その結果を新しいストリームとして生成するための「中間操作」です。関数型プログラミングの考え方を取り入れており、元のデータを壊さずに加工できるのが大きな特徴です。

初心者の方が最初につまずきやすいのは、「mapは書き換えるためのもの」という誤解です。実際には、元のリストの内容を書き換えるのではなく、元の値を「入力」として受け取り、加工した後の「新しい値」を流す工場のような役割を果たします。これにより、副作用の少ない安全なコードを書くことが可能になります。

基本的な使い方としては、文字列を大文字に変換したり、数値のリストを二倍にしたりといった単純なものから始まりますが、実務では「オブジェクトの特定のフィールドだけを取り出す」「別のクラスに詰め替える」といった使い方が主流です。まずはこの「変換」という概念をしっかりと掴むことが、Stream APIを使いこなす第一歩となります。

2. 基本的な型変換：文字列から数値へのマッピング

2. 基本的な型変換：文字列から数値へのマッピング

まずは、最もシンプルな「型変換」の例を見てみましょう。例えば、外部のファイルやAPIから取得したデータの多くは文字列形式です。これらを計算で使うためには数値型に変換する必要があります。従来のforループでは、空のリストを用意して一つずつパースして追加していましたが、mapを使えば一行で記述できます。

ここでは、数字が含まれる文字列のリストを、整数のリストに変換するプログラムを紹介します。メソッド参照（Integer::parseInt）を使うことで、より簡潔に記述できる点に注目してください。この手法はデータクリーニングやバリデーション後の数値化によく利用されます。

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

public class TypeConversionExample {
    public static void main(String[] args) {
        List<String> stringNumbers = Arrays.asList("10", "20", "30", "40");

        // mapを使ってString型をInteger型に変換する
        List<Integer> intNumbers = stringNumbers.stream()
            .map(Integer::parseInt)
            .collect(Collectors.toList());

        System.out.println("変換後のリスト: " + intNumbers);
    }
}

変換後のリスト: [10, 20, 30, 40]

このように、mapメソッドの中で型を変換する処理を書くだけで、ストリームの中を流れるデータの型が動的に変化します。これを「データパイプラインの構築」と呼びます。

3. オブジェクトの加工：EntityからDTOへの詰め替え

3. オブジェクトの加工：EntityからDTOへの詰め替え

システム開発において頻繁に登場するのが、データベースのテーブルに対応するクラス（Entity）から、画面に表示するための専用クラス（DTO: Data Transfer Object）への変換です。セキュリティの観点から、パスワードなどの機密情報を隠したり、氏名をフルネームに結合して表示したりする際に応用されます。

以下の例では、Userオブジェクトのリストを、表示用のUserDTOに加工して変換する流れを確認します。ラムダ式の中で新しいオブジェクトを生成（new）するのがポイントです。これにより、ビジネスロジックと表示ロジックをきれいに分離でき、保守性の高いコードになります。

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

class User {
    String firstName;
    String lastName;
    String email;
    User(String f, String l, String e) { this.firstName = f; this.lastName = l; this.email = e; }
}

class UserDTO {
    String fullName;
    UserDTO(String fullName) { this.fullName = fullName; }
    @Override
    public String toString() { return "UserDTO{fullName='" + fullName + "'}"; }
}

public class ObjectMappingExample {
    public static void main(String[] args) {
        List<User> users = Arrays.asList(
            new User("田中", "太郎", "tanaka@example.com"),
            new User("佐藤", "花子", "sato@example.com")
        );

        // UserオブジェクトをUserDTOに加工・変換する
        List<UserDTO> dtos = users.stream()
            .map(user -> new UserDTO(user.firstName + " " + user.lastName))
            .collect(Collectors.toList());

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

UserDTO{fullName='田中 太郎'}
UserDTO{fullName='佐藤 花子'}

この手法をマスターすると、大量のデータ処理であっても、宣言的に「何をしたいか」を記述するだけで複雑な変換処理を実装できるようになります。

4. ネストされた構造の解消：flatMapによる平坦化

4. ネストされた構造の解消：flatMapによる平坦化

mapを応用する上で避けて通れないのが、ネスト（階層）構造の扱いです。例えば、「部署リストの中に、社員リストが入っている」という構造から、全社員のリストを一列に並べて取得したい場合があります。もしここで普通のmapを使ってしまうと、「リストのリスト」という扱いづらい形になってしまいます。

そこで登場するのがflatMapメソッドです。これは、各要素から生成されたストリームを一つの大きなストリームに繋ぎ合わせる（平坦化する）役割を持ちます。以下のサンプルでは、複数の注文に含まれる「商品アイテム」を一つのリストに集約する方法を示します。これこそがStream APIの真骨頂とも言える高度なテクニックです。

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

public class FlatMapExample {
    public static void main(String[] args) {
        List<List<String>> nestedList = Arrays.asList(
            Arrays.asList("りんご", "バナナ"),
            Arrays.asList("みかん", "ぶどう", "いちご"),
            Arrays.asList("スイカ")
        );

        // flatMapを使って二次元リストを一次元に平坦化する
        List<String> flatList = nestedList.stream()
            .flatMap(List::stream)
            .collect(Collectors.toList());

        System.out.println("平坦化されたリスト: " + flatList);
    }
}

平坦化されたリスト: [りんご, バナナ, みかん, ぶどう, いちご, スイカ]

このflatMapは、Optionalクラスと組み合わせたり、ファイル内の全行から単語を抽出したりといった場面でも非常に強力な力を発揮します。

5. 条件分岐を伴うマッピング：mapとifの組み合わせ

5. 条件分岐を伴うマッピング：mapとifの組み合わせ

mapの中では、単純な1対1の変換だけでなく、条件に応じた値の出し分けも可能です。例えば、スコアに応じて「合格」「不合格」の判定結果を流したり、特定の条件を満たす場合のみ値をnullに置き換えて後続の処理でフィルタリングしたりといった具合です。

三項演算子を使うと、map内を非常にスッキリと記述できます。ただし、ロジックが複雑になりすぎる場合は、無理に1行で書かずにメソッドを切り出すことが、読みやすいコード（クリーンコード）を保つコツです。以下のコードでは、数値のリストを奇数・偶数のラベルに変換する例を紹介します。

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

public class ConditionalMapExample {
    public static void main(String[] args) {
        List<Integer> scores = Arrays.asList(45, 80, 55, 90, 30);

        // 60点以上なら「PASS」、それ以外なら「FAIL」に変換
        List<String> results = scores.stream()
            .map(s -> s >= 60 ? "PASS" : "FAIL")
            .collect(Collectors.toList());

        System.out.println("判定結果: " + results);
    }
}

判定結果: [FAIL, PASS, FAIL, PASS, FAIL]

このように、データがストリームを流れる過程で「意味」を持たせることができるのが、mapメソッドによる加工の醍醐味です。

6. 複数のmapをチェーンさせて処理を分割する

6. 複数のmapをチェーンさせて処理を分割する

Stream APIの設計思想は「単一責任の原則」に似ており、一つのmapで複雑な加工をすべて行うよりも、小さな変換を複数回（チェーン）つなげる方が見通しが良くなります。例えば、「文字列の空白を取り除く」→「数値を2倍にする」→「文字列に戻して単位をつける」といった具合です。

このようにステップを分けることで、デバッグが容易になり、各工程で何が行われているかが一目で理解できるようになります。また、途中にfilterを挟んで不要なデータを除去するといった柔軟な設計も可能になります。読めるコードを書くことは、プログラミング初心者から中級者へステップアップするための重要なポイントです。

開発の現場では、一行に長く書くよりも、適切に改行を入れてドット（.）でつなぐ書き方が好まれます。流れるようなインターフェース（Fluent Interface）を活用して、論理的で美しいプログラムを目指しましょう。

7. 数値ストリームへの変換：mapToIntとmapToObj

7. 数値ストリームへの変換：mapToIntとmapToObj

通常のStream<Integer>はラッパークラスを使っているため、大量の数値計算を行う際にはメモリ効率や速度が気になることがあります。そんな時に便利なのが、基本データ型（プリミティブ型）に特化したIntStreamやDoubleStreamへの変換です。

mapToIntを使うと、オブジェクトのストリームから数値専用のストリームに切り替えることができ、合計値（sum）や平均値（average）といった集計処理が非常に高速かつ簡単に行えるようになります。逆に、数値ストリームからオブジェクトに戻すときはmapToObjを使います。これらの使い分けができるようになると、Javaのパフォーマンス特性を理解した高度なプログラミングができるようになります。

8. 実践的なエラーハンドリングとmapの注意点

8. 実践的なエラーハンドリングとmapの注意点

実務でmapを使う際に最も注意すべきなのは、変換中に発生する例外（エラー）の扱いです。例えば、文字列を数値に変換する際に、数字以外の文字が混じっているとNumberFormatExceptionが発生し、ストリーム全体の処理が止まってしまいます。

初心者のうちは、mapの中でtry-catchを書きたくなりますが、これはコードを非常に読みづらくします。対策としては、事前にfilterで不正なデータを除去しておくか、エラー時に特定のデフォルト値を返すようなユーティリティメソッドを用意しておくのが一般的です。データの整合性を保ちながら、いかに美しくエラーを回避するかを考えることも、ストリーム操作の重要な応用テクニックの一部と言えるでしょう。