エラーハンドラーによって表示されるページのカスタマイズ

AEM には、HTTP エラーを処理するための標準的なエラーハンドラーが付属しています。例えば、次のようなメッセージが表示されます。

エラーコードに応答するためにシステムが提供するスクリプト（/libs/sling/servlet/errorhandlerの下）が存在します。デフォルトでは、次のスクリプトが標準のCQインスタンスで使用できます。

• 403.jsp
• 404.jsp

エラーハンドラーによって表示されるページのカスタマイズ方法

独自のスクリプトを作成して、エラーの発生時にエラーハンドラーで表示されるページをカスタマイズできます。カスタマイズしたページが/appsの下に作成され、（/libsの下の）デフォルトのページにオーバーレイされます。

1. リポジトリー内で、デフォルトスクリプトを次のようにコピーします。

   • コピー元：/libs/sling/servlet/errorhandler/
   • コピー先：/apps/sling/servlet/errorhandler/

   コピー先のパスはデフォルトでは存在しないので、最初は作成する必要があります。

2. /apps/sling/servlet/errorhandler に移動します。次のどちらかを実行します。

   • 該当する既存のスクリプトを編集し、必要な情報を追加します。
   • 必要とするコード用に新しいスクリプトを作成し、編集します。

3. 変更を保存し、テストします。

HTTP 500 エラーへの応答のカスタマイズ

HTTP 500 エラーはサーバー側の例外によって発生します。

• 500 内部サーバーエラー
  サーバーで予期しない状況が発生したので、要求を処理できません。

要求処理の結果例外が発生した場合、Apache Slingフレームワーク(AEMが構築されているフレームワーク):

• 例外をロギングします。

• 次を返します。

  • HTTP 応答コード 500
  • 例外スタックトレース

  これらは応答の本文内で返されます。

エラーハンドラーで表示されるページをカスタマイズすることで、500.jsp スクリプトを作成できます。ただし、このスクリプトが使用されるのは、HttpServletResponse.sendError(500) が明示的に（例外キャッチャーから）実行される場合に限ります。

それ以外の場合は、応答コードは 500 に設定されますが、500.jsp スクリプトは実行されません。

500 エラーを処理するには、エラーハンドラースクリプトのファイル名を例外クラス（またはスーパークラス）と同じにする必要があります。このような例外をすべて処理するには、スクリプト/apps/sling/servlet/errorhandler/Throwable.jspまたは/apps/sling/servlet/errorhandler/Exception.jspを作成します。