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

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.jsp500. スクリプトは実行されません。

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