JavaでUnsupportedOperationExceptionが発生する原因と回避方法を解説

UnsupportedOperationExceptionは、JavaにおけるRuntimeExceptionのサブクラスの一つで、要求された操作がサポートされていないことを示すためにスローされる例外です。この例外クラスはJava Collections Frameworkの一部であり、List、Queue、Set、Mapといった具象コレクションクラスのほとんどからスローされる可能性があります。

UnsupportedOperationExceptionの構文

public class UnsupportedOperationException extends RuntimeException

UnsupportedOperationExceptionが発生するコード例

import java.util.*;
public class UnsupportedOperationExceptionTest {
    public static void main(String[] args) {
        List aList = new ArrayList();
        aList.add('a');
        aList.add('b');
        List newList = Collections.unmodifiableList(aList);
        newList.add('c');
    }
}

上記の例では、Collections.unmodifiableList()によって生成された「変更不可能なビュー」に対してadd()メソッドを呼び出しているため、UnsupportedOperationExceptionが発生します。

この例外を回避するためには、変更不可能なビューオブジェクトではなく、元のコレクションオブジェクトそのものに対して変更操作を行う必要があります。

実行結果（出力）

Exception in thread "main" java.lang.UnsupportedOperationException
  at java.util.Collections$UnmodifiableCollection.add(Collections.java:1055)
      at UnsupportedOperationExceptionTest.main(UnsupportedOperationExceptionTest.java:9)

UnsupportedOperationExceptionが発生しやすい主な場面

この例外は、変更を許可しないコレクションに変更操作を加えたときによく発生します。代表的なケースは以下の通りです。

• Arrays.asList()で生成した固定長リストへの要素の追加・削除
• List.of()やMap.of()などで生成したイミュータブル（不変）コレクションへの変更操作
• Collections.unmodifiableMap()やCollections.unmodifiableSet()などのラッパー経由でのコレクション変更

コレクションを外部に公開する際は意図的に変更不可能なビューを返すことが有効ですが、その場合は呼び出し側で変更操作を行わないよう設計段階で注意しましょう。