【Salesforce】Apex でエラーハンドリングとロールバックを行う方法

Salesforce

2023.12.24

この記事は約4分で読めます。

記事内に広告が含まれています。

この記事では、Salesforce Apex におけるエラーハンドリングとトランザクションロールバックを紹介します。

安定したアプリケーション開発のためには必要不可欠な要素です。

Apex のエラーハンドリングの基礎
トランザクションとロールバックの組み合わせ
参考
おわりに

Apex のエラーハンドリングの基礎

エラーハンドリングは、予期しないエラーや例外が発生した際にシステムが適切に対応できるようにするプロセスです。

Apexでは、try, catch, finallyブロックを使用して、エラーを捕捉し、処理します。適切なエラーハンドリングを行うことで、予期せぬエラーからアプリケーションを守り、ユーザーにフレンドリーなフィードバックを提供することができます。

例外が発生した場合には、ログにエラーを記録したり、ユーザーに適切なメッセージを表示したりすることが重要です。

try {
    // 例外が発生し得る操作
} catch (Exception e) {
    // 例外の種類に応じて、適切なエラー処理を行う
    System.debug('エラー発生: ' + e.getMessage());
    // ここでユーザーへの通知や、特定の回復処理を実装する
} finally {
    // エラーの有無に関わらず、最後に必ず実行する処理
    // リソースの解放や、状態のリセットなど
}

トランザクションとロールバックの組み合わせ

Apex でのトランザクション制御は、一連の操作が全て成功するか、あるいは一つでも失敗した場合には何も影響を与えずに元の状態に戻すために非常に重要です。

Database.setSavepoint()メソッドを使用してトランザクションの開始地点を設定し、Database.rollback()メソッドで元の状態に戻します。

特に、複数の関連するDML操作を一連のプロセスとして扱う場合に有効です。

エラーが発生したときにロールバックを行うことで、データの不整合を防ぎ、システムの信頼性を保つことができます。

また、エラーメッセージをユーザーに適切に表示することで、何が間違っていたのかを明確に伝え、ユーザーエクスペリエンスを向上させることができます。

final Savepoint sp = Database.setSavepoint();
try {
    // 複数のDML操作
    insert newAccount;
    update existingContact;
    delete oldOpportunity;
    // 他の複雑な処理
} catch (DmlException e) {
    // DML操作中にエラーが発生した場合、全ての変更をロールバック
    Database.rollback(sp);
    System.debug('エラーによりロールバック: ' + e.getMessage());
    // ここでユーザーに適切なエラーメッセージを提供
} finally {
    // 最終的なクリーンアップ処理
}

try の前に Savepoint sp を定義しておくことで、エラー発生時に、この時点での状態にロールバックできます。