【Java学習｜豆知識】メモリリークを防ぐ切り札！WeakHashMapの仕組みと使いどころ

導入：なぜWeakHashMapが必要なのか

Javaでキャッシュやメタデータの管理を行う際、通常のHashMapを使っていると、キーとして使ったオブジェクトが不要になってもMapが参照を持ち続けるため、ガベージコレクション（GC）が働かずメモリリークを引き起こすことがあります。この課題を解決するのがWeakHashMapです。WeakHashMapは、キーへの参照が「弱参照（Weak Reference）」であるため、他に強い参照がなくなった瞬間にGCの対象となり、メモリを自動的に解放してくれます。

基礎知識：弱参照とは何か

通常、変数はオブジェクトに対する「強い参照」を持っています。GCは強い参照が存在する限り、そのオブジェクトを削除しません。一方、WeakHashMapのキーは「弱参照」として保持されます。これは、「GCのタイミングで他に参照している場所がなければ、いつでも回収して良いですよ」という合図になります。この仕組みにより、開発者が明示的にremoveメソッドを呼ばなくても、キーが使われなくなれば自動的にエントリがMapから削除されます。

実装：WeakHashMapの挙動を理解する

WeakHashMapは、java.util.Mapインターフェースを実装しており、使い方はHashMapとほぼ同じです。しかし、内部的には「ReferenceQueue」という仕組みを用いて、GCによって回収されたキーのエントリを監視し、自動的にクリーンアップを行っています。非常に効率的ですが、スレッドセーフではないため、マルチスレッド環境ではCollections.synchronizedMapなどでラップする必要があります。

サンプルプログラム：WeakHashMapの自動削除を確認する

以下のコードでは、キーである文字列オブジェクトをnullにすることで、GC後にWeakHashMapからエントリが消える様子を確認できます。

import java.util.Map; import java.util.WeakHashMap;


public class WeakHashMapSample {

    public static void main(String[] args) throws InterruptedException {

        Map map = new WeakHashMap<>();
        // キーとなるオブジェクトを作成

        String key = new String("重要データ");

        map.put(key, "キャッシュ値");
        System.out.println("GC前: " + map);
        // キーへの強い参照を解除する

        key = null;
        // 強制的にGCを呼び出す（※実際には動作を保証するものではありません）

        System.gc();

        Thread.sleep(1000);

// キーが回収され、エントリが削除されているか確認 System.out.println("GC後: " + map); } }

応用・注意点：現場での活用ポイント

WeakHashMapを扱う上で最も注意すべき点は、「キーとして文字列リテラル（”key”など）を使わないこと」です。文字列リテラルはJavaの「文字列プール」に強く参照されているため、GCによって回収されることがなく、WeakHashMapを使ってもメモリが解放されません。また、値側にキーへの直接的な参照を含めてしまうと、循環参照が発生してGCが機能しない場合があります。

キャッシュ用途であれば、より高度な管理が可能なGoogle GuavaのCacheやCaffeineの使用も検討すべきですが、JDK標準の軽量な仕組みとして、一時的なメタデータ紐付けにはWeakHashMapが非常に有効です。適切に使いこなして、メモリ効率の良い堅牢なシステムを構築しましょう。