アノテーションインターフェース HttpExchange
@TargetSE({TYPESE,METHODSE})
@RetentionSE(RUNTIMESE)
@DocumentedSE
@Reflective(org.springframework.web.service.annotation.HttpExchangeReflectiveProcessor.class)
public @interface HttpExchange
HTTP サービスインターフェースのメソッドを HTTP エンドポイントとして宣言するためのアノテーション。エンドポイントの詳細は、アノテーションの属性と入力メソッドの引数の型によって静的に定義されます。
ベース URL パスなど、すべてのメソッドによって継承される共通の属性を表現するために型レベルでサポートされています。
メソッドレベルでは、次の HTTP メソッド固有のショートカットアノテーションのいずれかを使用するのがより一般的です。各アノテーション自体に HttpExchange
でメタアノテーションが付けられています。
サポートされているメソッド引数:
メソッド引数 | 説明 | リゾルバー |
---|---|---|
URI SE | アノテーションの url() 属性をオーバーライドして、リクエストの URL を動的に設定します | UrlArgumentResolver |
HttpMethod | アノテーションの method() 属性をオーバーライドして、リクエストの HTTP メソッドを動的に設定する | HttpMethodArgumentResolver |
@RequestHeader | リクエストヘッダーを追加する | RequestHeaderArgumentResolver |
@PathVariable | URI テンプレートのパス変数を追加する | PathVariableArgumentResolver |
@RequestBody | リクエストの本文を設定する | RequestBodyArgumentResolver |
@RequestParam | リクエストパラメーターを追加します。"Content-Type" が "application/x-www-form-urlencoded" の場合はフォームデータ、それ以外の場合はクエリパラメーターのいずれかです。 | RequestParamArgumentResolver |
@RequestPart | String (フォームフィールド)、Resource (ファイルパーツ)、Object (JSON などのようにエンコードされるエンティティ)、HttpEntity (コンテンツとヘッダーの一部)、Part 、いずれかの Publisher のいずれかのリクエストパーツを追加します。上記。( | RequestPartArgumentResolver |
@CookieValue | クッキーを追加する | CookieValueArgumentResolver |
- 導入:
- 6.0
- 作成者:
- Rossen Stoyanchev
オプション要素の概要
オプション要素
要素の詳細
value
これはurl()
の別名です。- デフォルト:
- ""
url
リクエストの URL。型レベルの@HttpExchange
で宣言された URL に相対する完全な URL またはパスのみ、および / またはグローバルに構成されたベース URL。デフォルトでは、これは空です。
- デフォルト:
- ""
method
StringSE method使用する HTTP メソッド。型 レベルとメソッドレベルでサポートされます。型 レベルで使用すると、すべてのメソッドレベルのマッピングがこの値を継承します。
デフォルトでは、これは空です。
- デフォルト:
- ""
contentType
StringSE contentType"Content-Type"
ヘッダーのメディア型。型 レベルとメソッドレベルでサポートされます。この場合、メソッドレベルの値が型 レベルの値をオーバーライドします。
デフォルトでは、これは空です。
- デフォルト:
- ""
accept
StringSE[] accept"Accept"
ヘッダーのメディア型。型 レベルとメソッドレベルでサポートされます。この場合、メソッドレベルの値が型 レベルの値をオーバーライドします。
デフォルトでは、これは空です。
- デフォルト:
- {}