【Java】ClassCastExceptionの原因と対策をする方法

はじめに

今回は、Javaでよく遭遇する例外のひとつ。「java.lang.ClassCastException」について記載していきたいと思います。

他にも、体系的にJavaを学びたい方には以下の教材がおすすめです：

ClassCastExceptionとは、「互換性のない型にキャスト（変換）しようとしたときに発生する例外」です。

StringはIntegerに変換できないためエラーになります。

Object obj = "Hello World";
Integer num = (Integer) obj; // ここでエラー

java.lang.ClassCastException: class java.lang.String cannot be cast to class java.lang.Integer

ClassCastExceptionの原因はシンプルで、見た目の型と実際の型を勘違いして、キャストした際に発生します。「文字列」思ってキャストしたら違ったというのが発生する主な原因です。

戻り値の型が曖昧な「Object」に対して、呼び出し側が勝手に決めつけて型変換をかけるとExceptionが発生します。

Object data = getData();

// 実はStringなのに
Integer num = (Integer) data;

キャストする前に明示的に型チェックを実施するとエラーを防ぐことができます。

Object obj = getData();

if (obj instanceof Integer) {
    Integer num = (Integer) obj;
}

ジェネリクス未使用で型が確定していない変数は、中にどの型の値が入っているかわからないため、安全にキャストすることができません。

List list = new ArrayList();
list.add("test");

Integer num = (Integer) list.get(0); // エラー

ジェネリクスを使用し、型なしListは使わない用にしましょう。ジェネリクスはを指定すれば、キャスト時に間違った指定をしていた場合、コンパイルのタイミングで防ぐことができます。

List<String> list = new ArrayList<>();
list.add("Hello");

// コンパイル時に防げる
String str = list.get(0);

親クラスの型だからといって、子クラスの型に戻せるとは限らないという誤解から生まれるキャストのエラーとなります。

class Animal {}
class Dog extends Animal {}
class Cat extends Animal {}

Animal animal = new Cat();
Dog dog = (Dog) animal; // ←ここでエラー

実体のクラスを正しく理解し、変換を行うこと。

Animal animal = new Dog(); // 実体がDog

Dog dog = (Dog) animal; // OK

ClassCastExceptionは、「型の認識ミスによって発生する例外」です。問題を解決するために以下を心がけましょう。

以上、ログになります。
これからも継続していきましょう！！