はじめに
Mapは、一意のキー(Key)に対して単一の値(Value)をセットにして扱いたい時に有用なデータ構造です。
「Mapが何なのかよくわからない」「どうやって使えばいいの?」という方に向けて、基本概念からよく使う書き方、注意点までを解説します。
※この記事は、Java 17の環境で動作確認しています
Mapの重要ルール
・キーの重複はできない
同じキーを再度登録すると、値が新しいものに上書きされます。
・値の重複はできる
異なるキーに同じ値が紐づいていても問題ありません。
・キーを使用して値を取り出す
配列のようにインデックス番号(0, 1, 2...)で探すのではなく、キーを指定して値を取得できます。
基本的な操作
Mapを生成してデータを操作する基本コードです。
import java.util.HashMap;
import java.util.Map;
public class MapBasicExample {
public static void main(String[] args) {
// 1. Mapの宣言と生成(キー: 商品名(String), 値: 価格(Integer))
Map<String, Integer> priceMap = new HashMap<>();
// 2. データの追加 (put)
priceMap.put("りんご", 150);
priceMap.put("バナナ", 100);
priceMap.put("オレンジ", 120);
// 同じキーでputすると値が上書きされる
priceMap.put("りんご", 180);
// 3. データの取得 (get)
Integer applePrice = priceMap.get("りんご");
System.out.println("りんごの価格: " + applePrice); // 180
// 存在しないキーを指定すると null が返る
Integer grapePrice = priceMap.get("ぶどう");
System.out.println("ぶどうの価格: " + grapePrice); // null
// 4. キーや値の存在確認 (containsKey, containsValue)
if (priceMap.containsKey("バナナ")) {
System.out.println("バナナは登録されています");
}
// 5. データの削除 (remove)
priceMap.remove("オレンジ");
// 6. 要素数の確認 (size, isEmpty)
System.out.println("登録件数: " + priceMap.size()); // 2
System.out.println("空かどうか: " + priceMap.isEmpty()); // false
}
}
変更できないMapを作成する(Java 17)
「初期設定データ」や「固定の定数マップ」など、後から内容を変更したくないデータを扱う場合は、Javaの静的ファクトリメソッドを使うとシンプルに記述できます。
10組以下なら Map.of()
手軽に少量の固定データを作りたいときに最適です。
// キーと値を交互に並べて渡す(最大10組まで)
Map<String, String> statusMap = Map.of(
"200", "OK",
"404", "Not Found",
"500", "Internal Server Error"
);
11組以上なら Map.ofEntries()
エントリ数が多い場合や、キーと値のペアを明確に並べたい場合に使います。
Map<Integer, String> rankMap = Map.ofEntries(
Map.entry(1, "Gold"),
Map.entry(2, "Silver"),
Map.entry(3, "Bronze"),
Map.entry(4, "Iron")
);
注意点
- put() や remove() を呼び出すと例外(UnsupportedOperationException)が発生します。
- キーや値に null を含めると例外(NullPointerException)が発生します。
- 重複したキーを渡すとエラーになります。
ループ処理
Mapに登録された全データを1つずつ取り出したい場合、主に次の3つの方法があります。
方法1: forEach とラムダ式
キーと値の両方を同時に扱え、最も読みやすい書き方です。
Map<String, Integer> userScores = Map.of("佐藤", 85, "田中", 92, "鈴木", 78);
userScores.forEach((name, score) -> {
System.out.println(name + "さんの点数: " + score);
});
方法2: entrySet() を使う
「キー」と「値」をセットで取得してループ処理します。
for (Map.Entry<String, Integer> entry : userScores.entrySet()) {
System.out.println(entry.getKey() + " -> " + entry.getValue());
}
方法3: キーだけ、または値だけを取り出す
・キーだけ欲しいときは、 map.keySet() をループさせます。
・値だけ欲しいときは、 map.values() をループさせます。
キーと値の両方が必要な場合は entrySet() か forEach を使いましょう。
便利なメソッド
getOrDefault()
キーがないときのデフォルト値を決めておくメソッドです。
存在しないキーを指定した際に null ではなく、あらかじめ指定した初期値を返したい場合に便利です。
Map<String, Integer> stockMap = new HashMap<>();
stockMap.put("A001", 5);
// "B002" は未登録なので、デフォルト値の 0 が返る
int stock = stockMap.getOrDefault("B002", 0);
System.out.println("在庫: " + stock); // 在庫: 0
computeIfAbsent()
キーがない場合に新しく作って登録してくれます。
「カテゴリごとに複数のデータをリストでまとめたい(Map>)」という場合に便利です。
import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
public class GroupingExample {
public static void main(String[] args) {
Map<String, List<String>> departmentMembers = new HashMap<>();
// "開発部" のリストが存在しなければ新しく ArrayList を作り、そこへ追加する
departmentMembers.computeIfAbsent("開発部", k -> new ArrayList<>()).add("田中");
departmentMembers.computeIfAbsent("開発部", k -> new ArrayList<>()).add("佐藤");
departmentMembers.computeIfAbsent("営業部", k -> new ArrayList<>()).add("鈴木");
System.out.println(departmentMembers);
// 出力: {開発部=[田中, 佐藤], 営業部=[鈴木]}
}
}
間違えやすい書き方
ループ中に直接 map.remove() してしまう
拡張 for 文でループを回している最中に map.remove(key) を呼び出すと、実行時に例外エラーが発生します。
解決法
Java 8以降で利用できる removeIf は、安全に条件付き削除を行うことができます。
Map<String, Integer> scoreMap = new HashMap<>();
scoreMap.put("UserA", 90);
scoreMap.put("UserB", 45);
scoreMap.put("UserC", 55);
// 60点未満のデータを安全に削除する
scoreMap.entrySet().removeIf(entry -> entry.getValue() < 60);
System.out.println(scoreMap); // {UserA=90}
プリミティブ型で受けてエラー
値が Integer のMapから値を取得し、それを直接基本データ型の int に代入しようとすると、キーが存在しなかった場合に NullPointerException(NPE)が発生します。
Map<String, Integer> map = new HashMap<>();
// NG: キーが存在しないと null が返り、int への自動変換(アンボクシング)で NPE が発生!
// int count = map.get("unknown");
// OK: getOrDefault を使って安全に受け取る
int count = map.getOrDefault("unknown", 0);
まとめ
Mapの基本操作を押さえておくことで、データの集計やグルーピング、キャッシュ処理など、さまざまなプログラミング課題に柔軟に対応できるようになります。