Java：List型からMap型への変換方法

Javaプログラムにおいて、ある型の List<Bean> を Map<Key, Value> に変換したい場面はしばしば発生します。例えば、リスト内の各要素（Bean）が持つ「識別子（ID）」「値（Data）」をキー・バリューとしてマップ化したい場合です。
本記事では、典型的なパターンを紹介しつつ、実装例・ユニットテスト例・最新の Java Stream API を使った方法も解説します。

想定するデータ構造

ここでは下記のような Bean クラスを想定します。public class SampleBean {

    private Integer id;
    private String data;

    // コンストラクタ
    public SampleBean(Integer id, String data) {
        this.id = id;
        this.data = data;
    }

    // getter／setter
    public Integer getId() {
        return id;
    }
    public void setId(Integer id) {
        this.id = id;
    }
    public String getData() {
        return data;
    }
    public void setData(String data) {
        this.data = data;
    }
}

private Integer id;

private String data;

// コンストラクタ

public SampleBean(Integer id, String data) {

this.id = id;

this.data = data;

}

// getter／setter

public Integer getId() {

return id;

}

public void setId(Integer id) {

this.id = id;

}

public String getData() {

return data;

}

public void setData(String data) {

this.data = data;

}

この List<SampleBean> を、例えば Map<Integer, String> のように「id → data」のマップに変換する方法を解説します。

基本的な for-ループによる変換

最もシンプルな方法が、 for ループを使って１つずつマップに格納していくやり方です。null チェックや空リストチェックも入れましょう。

public static Map<Integer, String> convertListToMap(List<SampleBean> list) {
    Map<Integer, String> result = new HashMap<>();
    if (list == null || list.isEmpty()) {
        return result;
    }
    for (SampleBean bean : list) {
        if (bean == null) {
            continue;
        }
        Integer key = bean.getId();
        String value = bean.getData();
        // key または value に null を許さない設計ならチェックや例外化を考慮
        result.put(key, value);
    }
    return result;
}

public static Map<Integer, String> convertListToMap(List<SampleBean> list) {

Map<Integer, String> result = new HashMap<>();

if (list == null || list.isEmpty()) {

return result;

}

for (SampleBean bean : list) {

if (bean == null) {

continue;

}

Integer key = bean.getId();

String value = bean.getData();

// key または value に null を許さない設計ならチェックや例外化を考慮

result.put(key, value);

}

return result;

}

解説ポイント

引数が null の場合も空のマップを返すことで呼び出し側の null チェックを軽減しています。
リストが空でも正常終了。
各 Bean が null の可能性がある場合は continue でスキップ。
key に重複がある場合（例えば同じ id の Bean が複数ある）は、後勝ちで上書きされます。要件によっては例外を投げる、重複チェックを入れるといった拡張が必要です。

応用：キー／値に複雑なロジックを使う

上記の基本形では「Bean の id をキー」「Bean の data を値」にしていますが、実際の業務ではもう少し柔軟な変換を求められます。

例１：キーを Bean の別フィールド＋加工値にする

public static Map<String, SampleBean> convertByCompositeKey(List<SampleBean> list) {
    if (list == null) {
        return Collections.emptyMap();
    }
    return list.stream()
        .filter(Objects::nonNull)
        .collect(Collectors.toMap(
            bean -> "KEY_" + bean.getId(),   // キーを文字列加工
            Function.identity(),            // 値は Bean 自体
            (oldVal, newVal) -> newVal      // 重複時は新しい方を採用
        ));
}

public static Map<String, SampleBean> convertByCompositeKey(List<SampleBean> list) {

if (list == null) {

return Collections.emptyMap();

}

return list.stream()

.filter(Objects::nonNull)

.collect(Collectors.toMap(

bean -> "KEY_" + bean.getId(), // キーを文字列加工

Function.identity(), // 値は Bean 自体

(oldVal, newVal) -> newVal // 重複時は新しい方を採用

));

}

例２：値を List にマッピング（つまり 1→多の関係を Map に）

public static Map<Integer, List<String>> convertGroupingToMap(List<SampleBean> list) {
    if (list == null) {
        return Collections.emptyMap();
    }
    return list.stream()
        .filter(Objects::nonNull)
        .collect(Collectors.groupingBy(
            SampleBean::getId,
            LinkedHashMap::new,
            Collectors.mapping(
                SampleBean::getData,
                Collectors.toList()
            )
        ));
}

public static Map<Integer, List<String>> convertGroupingToMap(List<SampleBean> list) {

if (list == null) {

return Collections.emptyMap();

}

return list.stream()

.filter(Objects::nonNull)

.collect(Collectors.groupingBy(

SampleBean::getId,

LinkedHashMap::new,

Collectors.mapping(

SampleBean::getData,

Collectors.toList()

)

));

}

この例では、 id が同一の Bean をグループ化し、 data 値を List<String> としてまとめたマップを作成しています。

ユニットテスト例（JUnit を想定）

基本変換メソッドに対して、以下のような単体テストを用意できます。

@Test
public void testConvertListToMap_NormalCase() {
    SampleBean bean1 = new SampleBean(1, "A");
    SampleBean bean2 = new SampleBean(2, "B");
    SampleBean bean3 = new SampleBean(3, "C");
    List<SampleBean> list = Arrays.asList(bean1, bean2, bean3);

    Map<Integer, String> result = MyUtil.convertListToMap(list);

    assertEquals(3, result.size());
    assertEquals("A", result.get(1));
    assertEquals("B", result.get(2));
    assertEquals("C", result.get(3));
}

@Test
public void testConvertListToMap_EmptyList() {
    List<SampleBean> list = Collections.emptyList();

    Map<Integer, String> result = MyUtil.convertListToMap(list);

    assertNotNull(result);
    assertTrue(result.isEmpty());
}

@Test
public void testConvertListToMap_NullList() {
    Map<Integer, String> result = MyUtil.convertListToMap(null);

    assertNotNull(result);
    assertTrue(result.isEmpty());
}

@Test
public void testConvertListToMap_DuplicateKey() {
    SampleBean bean1 = new SampleBean(1, "A");
    SampleBean bean2 = new SampleBean(1, "B");  // 同じキー１
    List<SampleBean> list = Arrays.asList(bean1, bean2);

    Map<Integer, String> result = MyUtil.convertListToMap(list);

    // 上書き仕様なら
    assertEquals("B", result.get(1));
}

@Test

public void testConvertListToMap_NormalCase() {

SampleBean bean1 = new SampleBean(1, "A");

SampleBean bean2 = new SampleBean(2, "B");

SampleBean bean3 = new SampleBean(3, "C");

List<SampleBean> list = Arrays.asList(bean1, bean2, bean3);

Map<Integer, String> result = MyUtil.convertListToMap(list);

assertEquals(3, result.size());

assertEquals("A", result.get(1));

assertEquals("B", result.get(2));

assertEquals("C", result.get(3));

}

@Test

public void testConvertListToMap_EmptyList() {

List<SampleBean> list = Collections.emptyList();

Map<Integer, String> result = MyUtil.convertListToMap(list);

assertNotNull(result);

assertTrue(result.isEmpty());

}

@Test

public void testConvertListToMap_NullList() {

Map<Integer, String> result = MyUtil.convertListToMap(null);

assertNotNull(result);

assertTrue(result.isEmpty());

}

@Test

public void testConvertListToMap_DuplicateKey() {

SampleBean bean1 = new SampleBean(1, "A");

SampleBean bean2 = new SampleBean(1, "B"); // 同じキー１

List<SampleBean> list = Arrays.asList(bean1, bean2);

Map<Integer, String> result = MyUtil.convertListToMap(list);

// 上書き仕様なら

assertEquals("B", result.get(1));

}

このように「正常系」「空リスト」「null」「重複キー」という典型的なパターンを網羅しておけば安心です。

注意点とベストプラクティス

キーのユニーク性を設計段階で確認：重複キーをどう扱うか（例外／上書き／スキップ）を明確に。
Bean の getId() や getData() が null を返す可能性があるか、そしてそれをマップのキーや値に置いて良いかを検討。
大量データを扱う場合、 toMap や groupingBy による変換でもメモリや並列処理の観点で注意が必要。特に並列ストリーム使用時はスレッドセーフなマップ生成が重要。
可読性・保守性を考えるなら、変換ロジックはユーティリティメソッドに切り出し、呼び出し側では「何を変換しているか」が直感的に分かるようにしましょう。
Java 9 以降では Map.ofEntries(...) 等を使った不変マップ生成、あるいは Collectors.toUnmodifiableMap(...) を使って「変換後マップを変更不可にする」設計も検討できます。

まとめ

List<Bean> から Map<Key, Value> への変換は、Java における典型的な処理パターンです。
基本的には for‐ループで手続き的に書けますが、Java 8 以降では Stream API によって簡潔に書くことも可能です。
キーの重複、null 要素、空リスト・null 引数などの例外パターンを予め考慮することが重要です。
また、設計段階で「値は Bean のフィールドか？それとも Bean 自体か？」「キーはどのフィールドか？」「同じキーが複数あるか？」といった点を明確にしておくと、後続のメンテナンス性が高まります。
実装・テストともにシンプル且つ明快な設計を心がけましょう。

日	月	火	水	木	金	土
	1	2	3	4	5	6
7	8	9	10	11	12	13
14	15	16	17	18	19	20
21	22	23	24	25	26	27
28	29	30	31

「駑馬十駕」を信念に IT系情報を中心に調べた事をコツコツ綴っています。

Java：List型からMap型への変換方法

想定するデータ構造

基本的な for-ループによる変換

解説ポイント

最新の Java Stream API を使った変換（Java 8以降）

ポイント

応用：キー／値に複雑なロジックを使う

例１：キーを Bean の別フィールド＋加工値にする

例２：値を List にマッピング（つまり 1→多の関係を Map に）

ユニットテスト例（JUnit を想定）

注意点とベストプラクティス

まとめ

Ads by Google