インターフェース 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()
現在のリクエスト / レスポンス交換コンテキストのコンテキスト内で使用可能なプロパティ名を含む不変のcollection
SE を返します。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()
現在のリクエスト / レスポンス交換コンテキストのコンテキスト内で使用可能なプロパティ名を含む不変のcollection
SE を返します。getProperty(java.lang.String)
メソッドとプロパティ名を使用して、プロパティの値を取得します。サーブレットコンテナーでは、プロパティは
ServletRequest
と同期され、ServletRequest
で利用可能なすべての属性を公開します。プロパティの変更は、関連するServletRequest
のプロパティセットにも反映されます。- 戻り値:
- プロパティ名の不変の
collection
SE。 - 関連事項:
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 エンティティの新しい型