例外処理とロギングのベストプラクティス

はじめに

　システム開発において例外処理は重要なポイントですが、あまりに軽視されているのが現状ではないでしょうか。本稿では、これまでの著者の開発経験の中から培った汎用的な手法を説明します。

　この記事は「美しい設計」ではなく「現実的な設計」、現場に適用できる「できるだけ手間の少なく、汎用的な設計」を目指しています。

対象読者

　J2EE開発者・アーキテクト。特に業務システムの開発現場の方が対象です。

必要な環境

　概念の説明が中心ですので、開発環境は必要ありません。

エラーの分類

　実装時に考慮すべきエラーは2つに大別できます。

1. 想定内でトランザクションの実行開始前にチェックするエラー。主に入力エラー。
2. 異常な状態としてトランザクションの続行が不可能なエラー（例外）。

　前者については、例外を使うべきではありません。入力チェックエラーを表現するには、ステータスコードを使うべきです。理由は次のとおりです。

• 主にUIが絡むので、catch句にUI処理を書くことになってしまう。catch句には業務処理を書くべきではない。
• 例外は処理コストが高いので、正常処理に組み込むべきではない。
• 入力エラーは複数の発生原因を返す場合があるが、例外は一つの発生原因しか返せない。例外クラスを拡張すれば可能だが、例外処理を複雑化すべきではない。

　本稿で扱うのは、後者です。

　例外が発生する場合とは、例えば他システムとのデータ交換において、フォーマットチェックに引っかかった場合などです。このような例外は、開発者が任意で例外を生成しthrowします。このような例外にはユーザー定義例外を使うことで、例外処理を統一した形式で行えます。

例外クラスを定義する

　APIで定義されている例外は、以下の属性しか持ちません。

• メッセージ
• スタックトレース

　しかしシステム開発では、運用監視に必要なメッセージコード、ログレベルも必須でしょう。そこで新たにユーザー定義クラスを作成します。

ユーザー定義例外のクラス図

　RuntimeExceptionを継承したクラスは、メソッドのthrowsを記述する必要がありません。例外を一覧する以外には役に立たないthrowsが無くなることで、ソースが非常にすっきりします。

　ほとんどの場合はこのユーザー定義例外クラス一つで、事足ります。もし属性を追加したい場合は、ユーザー定義例外のサブクラスを作るとよいでしょう。

例外処理を基底クラスにまとめる

　例外処理となるtry～catchは、処理の実行を呼び出す「根っこ」の部分のみに実装します。一般的なJ2EEフレームワークを考えてみましょう。

一般的なJ2EEフレームワークの呼び出し階層の例

　業務ロジックや汎用処理で発生する例外は、まとめて基底クラスで処理します。これにより、各業務ロジック内で個別に例外処理を実装する必要はなくなります。また、例外処理が基底クラスにまとまることで、ロギングもまとまります。

ロギングのポイント

　一般的にログを出力するポイントは、次のとおりです。

　ロギングも基底クラスにまとまるので、業務ロジック内で開始メッセージなどをロギングする必要はありません。

ログに出力すべき内容

　ログに出力すべき項目は次のとおりです。

　マルチスレッド・複数ユーザーのシステム（特にWebアプリ）では、スレッド番号とユーザーIDは必ず出力してください。これがなければ、ユーザーごとの処理をログで追うことができません。

　以上の項目(スタックトレースを除く)を、1つのログファイルに出力します。スタックトレースは標準エラー出力に出力します。

最後に

　ここまでで、どのような感想をお持ちでしょうか？ よく考えて設計を行う開発者なら、「なんだ、当たり前のことばかりじゃないか」と思うでしょう。ですが、著者の経験では、こんなことがありました。

• ロジックの中にtry ～ catchが散りばめられ、例外処理が統一されていない。ログに例外を出力しない、誤ったフォーマットで出力する、一度の例外で複数回スタックトレースを出力する、など。
• すべてのクラスに開始・終了メッセージのロギングが実装され、大量にログを出力する。かつ、パフォーマンスが非常に悪い。
• ログにユーザーIDが出力されないので、誰の操作でエラーが発生したのかわからない。

　こんな初歩的な問題が、実はかなりの開発現場で発生しています。当たり前のことなのに意外とまとまった資料が無かったので、まとめて公開することにしました。

　例外処理とロギングは、設計・開発段階では手を抜きがちですが、ここのデキ次第で、運用開始後の障害の収束スピードと安定性が変わってきます。本稿で、サーバ管理者の睡眠時間を少しでも確保できれば、幸いです。

質問と回答

　皆様から寄せられた質問に回答したいと思います。