組み込み例外および共通メソッド

Apex には、実行時にエラーが発生した場合にランタイムエンジンが生成する複数の組み込み例外種別が用意されています。前の例では DMLException が使用されていました。その他いくつかの組み込み例外の例を次に説明します。組み込み例外種別の完全なリストは、「Exception クラスおよび組み込み例外」を参照してください。

DmlException

insert ステートメントでレコードの必要な項目が欠落している場合など、DML ステートメントに関する問題を示す例外。

この例では DmlException を使用します。この例の insert DML ステートメントは、必須項目を設定せずに商品品目を挿入しているため、DMLException を発生させます。この例外は、catch ブロックでキャッチされ、System.debug ステートメントを使用して例外メッセージがデバッグログに出力されます。

ListException

範囲外のインデックスへのアクセスなど、リストに関する問題を示す例外。

この例では、リストを作成して 1 つの要素を追加します。続いて、2 つの要素にアクセスを試みました。一方の要素はインデックス 0 に存在し、もう一方の要素はインデックス 1 に存在しないために ListException が発生します。この例外は、catch ブロックでキャッチされます。catch ブロックの System.debug ステートメントは、デバッグログに「The following exception has occurred: List index out of bounds: 1」と出力します。

NullPointerException

null 変数の参照解決に関する問題を示す例外。

この例では、s という名前の String 変数を作成しますが、この変数は値で初期化されていないため null です。null 変数に対して contains メソッドをコールすると、NullPointerException が発生します。この例外は、catch ブロックでキャッチされ、デバッグログには「The following exception has occurred: Attempt to de-reference a null object」と出力されます。

QueryException

sObject の単一変数に対する、レコードを返さない、または複数のレコードを返すクエリの割り当てなど、SOQL クエリに関する問題を示す例外。

この例の 2 つ目の SOQL クエリでは、QueryException が発生します。この例では、クエリの戻り値に Merchandise オブジェクトを割り当てます。クエリでの LIMIT 1 の使用方法を見てください。ここでは、データベースから返されるオブジェクトは 1 つ以下であるため、割り当てることができるのは 1 つのオブジェクトであり、リストではありません。ただし、この場合、XYZ という名前の Merchandise はないため、何も返されず、戻り値を 1 つのオブジェクトに割り当てようとすると QueryException が発生します。例外は catch ブロックでキャッチされ、デバッグログには「The following exception has occurred: List has no rows for assignment to SObject」と表示されます。

SObjectException

insert の間のみ変更可能な update ステートメント内の項目の変更など、sObject レコードに関する問題を示す例外。

この例では、try ブロックで SObjectException が発生し、catch ブロックでキャッチされます。請求書明細を照会し、その Name 項目のみを選択します。次に、照会された sObject の Description__c 項目を取得しようとしますが、この項目は SELECT ステートメントで照会された項目リストに含まれていないため取得できません。その結果、SObjectException が発生します。この例外は catch ブロックでキャッチされ、デバッグログには「The following exception has occurred: SObject row was retrieved via SOQL without querying the requested field: Invoice_Statement__c.Description__c」と表示されます。