15.8.4. インターセプター優先ファミリー
15.8.4.1. インターセプター優先ファミリーについて
概要
インターセプターは、呼び出される順序に敏感になる可能性があります。RESTEasy は、インターセプターをファミリーにグループ化して、順序付けを簡単にします。このリファレンストピックでは、組み込みのインターセプター優先順位ファミリーとそれぞれに関連付けられたインターセプターについて説明します。
5 つの事前定義されたファミリーがあります。これらは次の順序で呼び出されます。
- セキュリティー
- SECURITY インターセプターは通常 PreProcessInterceptors です。呼び出しが許可される前に実行する必要があるのは可能な限り少ないため、最初に呼び出されます。
- HEADER_DECORATOR
- HEADER_DECORATOR インターセプターは、応答または送信要求にヘッダーを追加します。追加されたヘッダーが他のインターセプターファミリーの動作に影響を与える可能性があるため、これらはセキュリティーインターセプターに従います。
- エンコーダー
- ENCODER インターセプターは OutputStream を変更します。たとえば、GZIP インターセプターは GZIPOutputStream を作成して、圧縮のために実際の OutputStream をラップします。
- REDIRECT
- REDIRECT インターセプターは、リクエストを再ルーティングして JAX-RS メソッドを完全にバイパスする可能性があるため、通常 PreProcessInterceptors で使用されます。
- デコーダ
- DECODER インターセプターは InputStream をラップします。たとえば、GZIP インターセプターデコーダーは InputStream を GzipInputStream インスタンスにラップします。
完全な型の安全性のために、便利な注釈があります
org.jboss.resteasy.annotations.interceptionパッケージ:@DecoredPrecedence、@EncoderPrecedence、@HeaderDecoratorPrecedence、@RedirectPrecedence、@SecurityPrecedence。の代わりにこれらを使用してください@Precedence注釈。詳細は、「RESTEasy で定義された注釈」 を参照してください。
