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

Adobe Experience Manager(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.

Business.Adobe.com リソース

Multichannel Communication Embedded Charts Content As A Service Dynamic Media Digital Asset Management Content Management System