HOWTO · Java
Java の java.lang.ClassCastException
この記事は、Java で java.lang.ClassCastException を処理するのに役立ちます。
このページの内容
java.lang.ClassCastExceptionは、オブジェクトの実行時の型がキャスト先の型と互換性がないことを示します。修正するには、オブジェクトの実際の型とキャスト先を確認し、instanceofや型を指定したジェネリクスを使うか、キャストが有効になるよう設計を見直してください。プログラムに有効な回復処理がある場合に限り、この例外を捕捉します。
ClassCastExceptionとは?
Javaでは、実行時に有効となる可能性のある関係にある型同士であれば、キャストを記述できます。キャストによってオブジェクト自体の型が変わるわけではありません。実行時にJavaは、そのオブジェクトがキャスト先のクラスのインスタンスであるか、キャスト先のインターフェースを実装しているかを確認します。どちらにも当てはまらない場合、Javaはjava.lang.ClassCastExceptionをスローします。
たとえば、DogとCatがどちらもAnimalを継承している場合、Animal型の参照はどちらのオブジェクトも参照できます。Animal型の参照をDogにキャストできるのは、参照先が実際にDogである場合だけです。Catオブジェクトを、同じ階層にある別の型のDogへキャストすることはできません。一方、DogをAnimal型の参照に代入するアップキャストは安全です。すべてのDogはAnimalだからです。
JavaがClassCastExceptionをスローする理由
よくある原因は、広い型で宣言された参照が特定のサブクラスを指していると思い込むことです。コンパイラは、型の構造上ダウンキャストが可能かどうかを確認できますが、実行時にどのオブジェクトが格納されているかまでは常に把握できるとは限りません。実行時のチェックが型の不一致を検出します。
この問題は、値をObject型で受け取るコード、ジェネリクスを使わない古いコレクション、APIが返す具体的なクラスについての思い込みなどで起こりがちです。ポリモーフィズムそのものが問題なのではありません。親クラス型の参照を通じてオーバーライドされたメソッドを呼び出すのは安全です。失敗するのは、そのオブジェクトが持たないサブタイプへ参照を絞り込もうとしたときです。
raw型のコレクションや未チェックの変換も、ジェネリクスによる型チェックを迂回することがあります。後で値を取り出すときに暗黙のキャストが挿入され、その値を使う段階で失敗する場合があります。値をコレクションに追加した箇所と、その型を決めつけた箇所の両方を調べてください。例外が発生した行だけを変更すると、型の不一致の原因を見えにくくすることがあります。
ClassCastExceptionを防ぐ方法
参照やコレクションには、用途に合う範囲で最も具体的な型を指定してください。ジェネリクスを使うと、コンパイラがコレクションへの追加と取り出しをチェックできるため、キャストの必要性を減らせます。ただし、任意のオブジェクトへの明示的なキャストが安全になるわけではありません。raw型や未チェック操作を使うと、ジェネリクスによる保護も損なわれます。
ソース型とキャスト先の型に関係があれば、ダウンキャストはコンパイルできることがあります。それでも、オブジェクトが実際には兄弟サブタイプであれば実行時に失敗します。次の例では、その失敗を捕捉してプログラムを正常に終了させます。コードと出力に含まれるラベルはバイト単位で保持されるため英語のままです。
public class FailingCastExample {
static class Animal {}
static class Dog extends Animal {}
static class Cat extends Animal {}
public static void main(String[] args) {
Animal animal = new Cat();
try {
Dog dog = (Dog) animal;
System.out.println(dog);
} catch (ClassCastException exception) {
System.out.println(exception.getClass().getName());
}
}
}
java.lang.ClassCastException
java.lang.ClassCastExceptionが捕捉されるのは、オブジェクトがDogではなくCatだからです。JVMが生成するメッセージやスタックトレースは実行環境によって異なることがあります。不一致を調べるには、例外の型とキャストが行われた行を確認してください。サブタイプ固有の処理が不要なら、値はAnimal型のまま扱います。
値を意図的に広い型で扱う場合は、型を絞り込む前に実行時の型を確認します。次の自己完結した例は、安全なキャストを示しています。こちらのコードと出力に含まれるラベルも英語のままです。
public class CastExample {
static class Animal {
String name() { return "Milo"; }
}
static class Dog extends Animal {
String bark() { return "woof"; }
}
public static void main(String[] args) {
Animal animal = new Dog();
if (animal instanceof Dog) {
Dog dog = (Dog) animal;
System.out.println(dog.bark());
}
}
}
instanceofで確認してからキャストするため、オブジェクトがDogの場合にだけキャストが実行されます。サブタイプ固有の処理が不要なら、値をAnimal型のまま扱い、共通のAPIを使ってください。instanceofのパターンマッチングに対応するJavaのバージョンでは、型の確認と変数への束縛をまとめて記述できます。この例では、幅広いバージョンで使える従来の構文を示しています。
ClassCastExceptionの処理と原因の調べ方
例外メッセージとスタックトレースを読み、元の型、キャスト先の型、キャストが発生した行を特定します。次に、返されたオブジェクト、コレクションの内容、デシリアライズ時のマッピング、APIの契約などを調べ、値の出所をたどってください。型を決めつけた箇所で型チェックを追加するか、宣言されたデータモデルを修正します。
キャストの失敗が想定される入力条件であり、プログラムが回復できる場合は、try-catchブロックが適切です。たとえば、複数のレコードを処理する際に、不正なレコードを1件だけ拒否する場合が該当します。通常のアプリケーション処理でClassCastExceptionを捕捉し、型に関する思い込みを修正せずに処理を続けると、データが不完全になったり、バグが隠れたりするおそれがあります。tryブロックの範囲を狭くし、問題の値を特定できるだけの情報を記録してください。例外メッセージの表現はJavaの実装や実行環境のバージョンによって異なることがあるため、ここでは具体的なメッセージを示していません。
よくある質問
java.lang.ClassCastExceptionとは何ですか?
クラスへのキャストでは、オブジェクトがそのクラスのインスタンスでない場合にスローされます。インターフェースへのキャストでは、オブジェクトがそのインターフェースを実装していない場合にスローされます。オブジェクト自身のクラスや、互換性のあるスーパータイプのクラスまたはインターフェースへのキャストは成功します。
JavaでClassCastExceptionを避けるにはどうすればよいですか?
用途に合った具体的な型を宣言し、ジェネリクスを使ってください。実行時の型が保証されていない場合は、ダウンキャストの前にinstanceofで確認します。これらの方法で安全でないキャストを減らせますが、任意のキャストすべてが有効になるわけではありません。
捕捉しなかった場合はどうなりますか?
捕捉されなければ、例外は現在のスレッドの呼び出しスタックをさかのぼって伝播し、そのスレッドの処理を終了させることがあります。アプリケーション全体への影響は、そのスレッドと周囲のエラー処理によって異なります。
try-catchでClassCastExceptionを捕捉できますか?
はい。回復に意味がある場合は捕捉してください。それ以外の場合は、互換性のないキャスト、または型に関する誤った思い込みの原因を修正します。
instanceofを使うのはよい方法ですか?
オブジェクトの実行時のサブタイプに応じて処理を変える必要がある場合に使います。型チェックがコードのあちこちに増えているなら、サブタイプ固有の処理をポリモーフィックなメソッドに移すか、データモデルを見直すことを検討してください。