HOWTO · Java
Java で Int が Null かどうかを確認する
Javaの int はプリミティブ型で null にはならず、null を表せるのはラッパークラス Integer だけです。Integer を null と比較するチェックを示し、アンボクシング時の NullPointerException を防ぐ一貫したチェック、デフォルト値、Optional の活用など実践策も扱います。
このページの内容
この記事では、ラッパークラス Integer を通じて、Java の int 型で null 値をチェックする方法を説明します。さらに、null 許容の整数を扱うときにコードの信頼性と堅牢性を保つベストプラクティスについても取り上げます。
Java で int は null になり得るか?
まず 1 つはっきりさせておく必要があるのは、int がプリミティブデータ型であることです。プリミティブ型は値を直接保持するため、int が null になることは決してありません — 常に何らかの数(デフォルトでは 0)を保持します。値が存在しないことは、オブジェクトが null になり得るラッパークラス Integer でしか表せません。
だからこそチェックが重要です。Integer を int として使う前 — 例えば計算のためにアンボクシングしたり、int が期待される場所に渡したりする前 — には、必ずチェックしなければなりません:null の Integer を int として使うと NullPointerException が発生します。プリミティブ値のラッパー形式が必要な場合は、int を Integer に変換する方法も参照してください。
Integer が null かどうかをチェックする
チェック自体は、null との単純な比較です。次の完全な例では、プリミティブな int、null 許容の Integer、そして実際のチェックを示します:
public class CheckIfIntIsNullExample {
public static void main(String[] args) {
// Part 1: Primitive int
int primitiveInt = 0;
System.out.println("Primitive int value: " + primitiveInt);
// Part 2: Nullable Integer
Integer nullableInt = null;
System.out.println("Nullable Integer value: " + nullableInt);
// Part 3: Checking for null
if (nullableInt != null) {
int intValue = nullableInt.intValue();
System.out.println("Value is: " + intValue);
} else {
System.out.println("Value is null");
}
}
}
出力:
Primitive int value: 0
Nullable Integer value: null
Value is null
コードの第 1 部では、primitiveInt を値 0 で初期化しています。これはプリミティブな整数の標準的な使い方を示すもので、常になんらかの値を保持します。第 2 部では、nullableInt を Integer オブジェクトとして宣言し、null を設定しています。これはラッパークラスでしかできません。第 3 部では、if 文が nullableInt を null と比較します:null でなければ intValue() で int 値を取り出して出力し、そうでなければ値が null であることを出力します。
null 許容の整数を扱うベストプラクティス
一貫した null チェック
Integer オブジェクトに対して操作を行ったり、その基になる int 値を取り出したりする前に、それが null かどうかをチェックし、それを一貫して行ってください。この実践により、NullPointerException に遭遇するリスクが最小化され、コード全体の安定性が向上します。
明確なドキュメント
null 許容の整数がどこで期待されるか、どのように扱うべきか、null 値が何を意味するかをドキュメントに残してください。明確なドキュメントは意図しない誤用を防ぎ、他の開発者がコードの動作を理解する助けになります。
デフォルト値と初期化
適切な場合は、null 許容の整数にデフォルト値を用意してください — 例えば値が存在しない場合に代替値を差し替えることで — それに依存する操作が予期せず失敗しないようにします。妥当なデフォルト値は、コードの動作をより予測可能にします。
Optional の使用(Java 8 以降)
Java 8 以降では、Optional クラスによって値が存在しない可能性を型自体で表すことができます。Optional<Integer> は、値が存在する場合と存在しない場合を明示的に扱うメソッドを提供し、コードの意図をより明確かつ簡潔に表現できます。
例外処理
値が存在しないことが例外的であるとみなされる場合は、それを意図的に処理してください — 明確なエラーで早期に失敗させるか、明示的に回復させるかして — 原因から遠く離れた場所で NullPointerException が表面化するような事態を避けます。堅牢な例外処理は、プログラムの予期しない終了を防ぎます。
結論
int が null になることは決してありません。なり得るのは、そのラッパークラス Integer だけです。チェックは null との単純な比較であり、それを一貫して適用し — 明確なドキュメント、妥当なデフォルト値、そして適した場面での Optional と組み合わせることで — NullPointerException を防ぎ、Java コードの信頼性と堅牢性を保てます。