インターフェース InterceptorContext
- すべての既知のサブインターフェース:
- ReaderInterceptorContext,- WriterInterceptorContext
 - public interface InterceptorContext- MessageBodyReader.readFrom(java.lang.Class<T>, java.lang.reflect.Type, java.lang.annotation.Annotation[], jakarta.ws.rs.core.MediaType, jakarta.ws.rs.core.MultivaluedMap<java.lang.String, java.lang.String>, java.io.InputStream)および- MessageBodyWriter.writeTo(T, java.lang.Class<?>, java.lang.reflect.Type, java.lang.annotation.Annotation[], jakarta.ws.rs.core.MediaType, jakarta.ws.rs.core.MultivaluedMap<java.lang.String, java.lang.Object>, java.io.OutputStream)への呼び出しをラップするために使用できるメッセージ本文インターセプターによって共有されるコンテキスト。このコンテキストクラスの getter と setter は、前述のメソッドのパラメーターに対応しています。- 導入:
- 2.0
- 作成者:
- Santiago Pericas-Geertsen, Bill Burke
- 関連事項:
- ReaderInterceptor,- WriterInterceptor,- ReaderInterceptorContext,- WriterInterceptorContext
 
- メソッドのサマリー- すべてのメソッド インスタンスメソッド 抽象メソッド デフォルトメソッド - 修飾子と型 - メソッド - 説明 - AnnotationSE[]- getAnnotations()インターセプトされたエンティティプロバイダーの呼び出しを開始したアーティファクトで正式に宣言されたアノテーションの配列を取得します。- TypeSE- getGenericType()生成または書き込まれるオブジェクトの型を取得します。- MediaType- getMediaType()HTTP エンティティのメディア型を取得します。- ObjectSE- getProperty(StringSE name)現在のリクエスト / レスポンス交換コンテキストに登録されている指定された名前のプロパティを返します。その名前のプロパティがない場合は- nullを返します。- CollectionSE<StringSE>- getPropertyNames()現在のリクエスト / レスポンス交換コンテキストのコンテキスト内で使用可能なプロパティ名を含む不変の- collectionSE を返します。- ClassSE<?>- getType()対応するメッセージ本文プロバイダーがサポートする Java 型を取得します。- default boolean- hasProperty(StringSE name)指定された名前のプロパティが現在のリクエスト / レスポンス交換コンテキストに登録されている場合は- trueを返し、その名前のプロパティが存在しない場合は- falseを返します。- void- removeProperty(StringSE name)現在のリクエスト / レスポンス交換コンテキストから、指定された名前のプロパティを削除します。- void- setAnnotations(AnnotationSE[] annotations)インターセプトされたエンティティプロバイダーの呼び出しを開始したアーティファクトの正式な宣言に関するアノテーションを更新します。- void- setGenericType(TypeSE genericType)生成または書き込まれるオブジェクトの更新型。- void- setMediaType(MediaType mediaType)HTTP エンティティのメディア型を更新します。- void- setProperty(StringSE name, ObjectSE object)現在のリクエスト / レスポンス交換コンテキスト内の指定されたプロパティ名にオブジェクトをバインドします。- void- setType(ClassSE<?> type)メッセージ本文プロバイダーを呼び出す前に Java 型を更新します。
 
- メソッドの詳細- getProperty- ObjectSE getProperty(StringSE name) 現在のリクエスト / レスポンス交換コンテキストに登録されている指定された名前のプロパティを返します。その名前のプロパティがない場合は- nullを返します。- プロパティを使用すると、JAX-RS フィルターとインターセプターがこのインターフェースでまだ提供されていない追加のカスタム情報を交換できます。 - サポートされているプロパティのリストは、 - getPropertyNames()を使用して取得できます。カスタムプロパティ名は、パッケージ名と同じ規則に従う必要があります。- サーバー側のサーブレットコンテナーでは、プロパティは - ServletRequestによってサポートされ、- ServletRequestで使用可能なすべての属性が含まれます。- パラメーター:
- name- プロパティの名前を指定する- String。
- 戻り値:
-  プロパティの値を含む Object、または指定された名前に一致するプロパティが存在しない場合はnull
- 関連事項:
- getPropertyNames()
 
 - hasProperty- default boolean hasProperty(StringSE name) 指定された名前のプロパティが現在のリクエスト / レスポンス交換コンテキストに登録されている場合は- trueを返し、その名前のプロパティが存在しない場合は- falseを返します。- getProperty(java.lang.String)メソッドとプロパティ名を使用して、プロパティの値を取得します。- パラメーター:
- name- プロパティの名前を指定する- String。
- 戻り値:
-  このプロパティがコンテキストに登録されている場合は true、指定された名前に一致するプロパティが存在しない場合はfalse。
- 関連事項:
- getPropertyNames()
 
 - getPropertyNames- CollectionSE<StringSE> getPropertyNames() 現在のリクエスト / レスポンス交換コンテキストのコンテキスト内で使用可能なプロパティ名を含む不変の- collectionSE を返します。- getProperty(java.lang.String)メソッドとプロパティ名を使用して、プロパティの値を取得します。- サーブレットコンテナーでは、プロパティは - ServletRequestと同期され、- ServletRequestで利用可能なすべての属性を公開します。プロパティの変更は、関連する- ServletRequestのプロパティセットにも反映されます。- 戻り値:
-  プロパティ名の不変の collectionSE。
- 関連事項:
- getProperty(java.lang.String)
 
 - setProperty- void setProperty(StringSE name, ObjectSE object) 現在のリクエスト / レスポンス交換コンテキスト内の指定されたプロパティ名にオブジェクトをバインドします。指定した名前がすでにプロパティに使用されている場合、このメソッドはプロパティの値を新しい値に置き換えます。- プロパティを使用すると、JAX-RS フィルターとインターセプターがこのインターフェースでまだ提供されていない追加のカスタム情報を交換できます。 - サポートされているプロパティのリストは、 - getPropertyNames()を使用して取得できます。カスタムプロパティ名は、パッケージ名と同じ規則に従う必要があります。- null値が渡される場合、効果は- removeProperty(String)メソッドを呼び出すのと同じです。- サーバー側のサーブレットコンテナーでは、プロパティは - ServletRequestによってサポートされ、- ServletRequestで使用可能なすべての属性が含まれます。- パラメーター:
- name- プロパティの名前を指定する- String。
- object- バインドされるプロパティを表す- Object
 
 - removeProperty- void removeProperty(StringSE name) 現在のリクエスト / レスポンス交換コンテキストから、指定された名前のプロパティを削除します。削除後、- getProperty(java.lang.String)を呼び出してプロパティ値を取得すると、- nullが返されます。- サーバー側のサーブレットコンテナーでは、プロパティは - ServletRequestによってサポートされ、- ServletRequestで使用可能なすべての属性が含まれます。- パラメーター:
- name- 削除するプロパティの名前を指定する- String
 
 - getAnnotations- AnnotationSE[] getAnnotations() インターセプトされたエンティティプロバイダの呼び出しを開始したアーティファクトで正式に宣言されたアノテーションの配列を取得します。例: メッセージ本文をメソッドパラメーターに変換する場合、これは- Method.getParameterAnnotations()によって返されるそのパラメーターのアノテーションになります。サーバー側のレスポンスエンティティインスタンスが出力ストリームに変換される場合、これは- Method.getAnnotations()によって返される一致したリソースメソッドのアノテーションになります。このメソッドは、特定のリソースメソッドのコンテキストで(たとえば、クライアント API の一部として)インターセプターが呼び出されない場合、空の配列を返すことがありますが、- nullを返すことはありません。- 戻り値:
- インターセプトされたエンティティプロバイダの呼び出しを開始したアーティファクトで宣言されたアノテーション。
 
 - setAnnotations- void setAnnotations(AnnotationSE[] annotations) インターセプトされたエンティティプロバイダの呼び出しを開始したアーティファクトの正式な宣言のアノテーションを更新します。このメソッドを呼び出しても、クライアント API には影響しません。- パラメーター:
- annotations- インターセプトされたエンティティプロバイダーの呼び出しを開始したアーティファクトの更新されたアノテーション宣言。- nullであってはなりません。
- 例外:
- NullPointerExceptionSE- 入力パラメーターが- nullの場合。
 
 - getType- ClassSE<?> getType() 対応するメッセージ本文プロバイダーがサポートする Java 型を取得します。- 戻り値:
- プロバイダーがサポートする java 型
 
 - setType- void setType(ClassSE<?> type) メッセージ本文プロバイダーを呼び出す前に Java 型を更新します。- パラメーター:
- type- プロバイダーの java 型
 
 - getGenericType- TypeSE getGenericType() 生成または書き込まれるオブジェクトの型を取得します。- 戻り値:
- 生成または書き込まれたオブジェクトの型
 
 - setGenericType- void setGenericType(TypeSE genericType) 生成または書き込まれるオブジェクトの更新型。- パラメーター:
- genericType- オブジェクトの新しい型
 
 - getMediaType- MediaType getMediaType() HTTP エンティティのメディア型を取得します。- 戻り値:
- HTTP エンティティのメディア型
 
 - setMediaType- void setMediaType(MediaType mediaType) HTTP エンティティのメディア型を更新します。- パラメーター:
- mediaType- HTTP エンティティの新しい型