効率な集合変換と Stream API

Java 8 で導入された Stream API を活用すると、コレクションデータの変換処理が宣言的で簡潔になります。特に、リスト（List）からのキー・バリューペア生成は、従来のループ処理と比較して可読性が向上します。

基本実装：List から Map への変換

従来の明示的な反復処理を行う代わりに、`Collectors.toMap` を使用することで、数行のコードで同様の結果を得ることができます。

class Item {
    private String code;
    private String category;
    // getter/setter
}

List<Item> itemList = Arrays.asList(
    new Item("001", "Electronics"),
    new Item("002", "Furniture")
);

// Streamを用いた簡易変換
Map<String, String> itemMap = itemList.stream()
    .collect(Collectors.toMap(Item::getCode, Item::getCategory));

オブジェクト自体を値として保存したい場合は、関数型インターフェース `Function.identity()` を利用するのが一般的です。

Map<String, Item> fullItemMap = itemList.stream()
    .collect(Collectors.toMap(Item::getCode, Function.identity()));

重複キーへの対応とマージ戦略

`Collectors.toMap` の基本的なメソッドには 2 つの引数版しかありません。もしソースデータに重複するキーが含まれている場合、実行時に `IllegalStateException` がスローされます。

このリスクを防ぐためには、第三引数として結合関数（BinaryOperator）を指定する必要があります。これにより、重複発生時の振る舞いをカスタマイズできます。

// 重複した場合、新しい値で上書きする戦略
Map<String, Double> priceMap = items.stream().collect(
    Collectors.toMap(
        Item::getSku, 
        Item::getPrice, 
        (oldVal, newVal) -> newVal
    )
);

上記の例では、同じ SKU が見つかった際、後から来た価格情報を優先しています。必要に応じて、既存の値を維持するなどのロジックに変更することも可能です。

特定の Map 実装型の指定

第四引数を提供することで、生成される Map のインスタンスタイプを変更することが可能です。キーの順序制御や並行処理への対応が必要である場合などに役立ちます。

キー順ソート済みの TreeMap を返す場合：

List<Item> sortedItems = Arrays.asList(...);
Map<String, String> orderedMap = sortedItems.stream()
    .collect(Collectors.toMap(
        Item::getCode, 
        Item::getCategory, 
        (a, b) -> a, 
        TreeMap::new
    ));

マルチスレッド環境向けの ConcurrentMap を返す場合：

ConcurrentMap<String, Item>> concurrentMap = items.parallelStream()
    .collect(Collectors.toMap(
        Item::getId, 
        i -> i, 
        (v1, v2) -> v1, 
        ConcurrentHashMap::new
    ));

null 値に関する注意点

実装上留意すべき点として、マップの値に `null` が含まれる可能性があります。しかし、`Collectors.toMap` は内部的に `HashMap.merge` メソッドを使用しており、値が `null` であると判定された場合は `NullPointerException` が発生します。

したがって、入力ストリームが空文字列やヌル値を含む可能性があり、かつそれを許容する必要がある場合には、事前にフィルタリングを行うか、別の収集方法を検討する必要があります。特に業務ロジックにおいて `null` が特別な意味を持つ場合、この挙動は予期せぬエラーの原因となるため注意が必要です。