アノテーションインターフェース RequestPart


@TargetSE(PARAMETERSE) @RetentionSE(RUNTIMESE) @DocumentedSE public @interface RequestPart
"multipart/form-data" リクエストの一部をメソッド引数に関連付けるために使用できるアノテーション。

サポートされるメソッド引数の型には、Spring の MultipartResolver 抽象化と組み合わせた MultipartFile、サーブレットマルチパートリクエストと組み合わせた jakarta.servlet.http.Part、またはその他のメソッド引数の場合は、パーツのコンテンツが 'Content-Type' ヘッダーを考慮して HttpMessageConverter 経由で渡されます。リクエスト部分。これは、@RequestBody が非マルチパートの通常のリクエストの内容に基づいて引数を解決するために行うことに似ています。

@RequestParam アノテーションを使用して、"multipart/form-data" リクエストの一部を同じメソッド引数型をサポートするメソッド引数に関連付けることもできることに注意してください。主な違いは、メソッド引数が文字列でない場合、または生の MultipartFile / Part@RequestParam は登録済みの Converter または PropertyEditorSE を介した型変換に依存するのに対し、RequestPart はリクエスト部分の "Content-Type" ヘッダーを考慮して HttpMessageConverters に依存することです。RequestParam は、名前と値のフォームフィールドで使用される可能性がありますが、RequestPart は、より複雑なコンテンツを含むパーツで使用される可能性があります。JSON、XML)。

導入:
3.1
作成者:
Rossen Stoyanchev, Arjen Poutsma, Sam Brannen
関連事項:
  • オプション要素のサマリー

    オプション要素
    修飾子と型
    オプションの要素
    説明
    バインドする "multipart/form-data" リクエスト内のパーツの名前。
    boolean
    パーツが必要かどうか。
    name() のエイリアス。
  • 要素の詳細

    • value

      @AliasFor("name") StringSE value
      name() のエイリアス。
      デフォルト:
      ""
    • name

      @AliasFor("value") StringSE name
      バインドする "multipart/form-data" リクエスト内のパーツの名前。
      導入:
      4.2
      デフォルト:
      ""
    • required

      boolean required
      パーツが必要かどうか。

      デフォルトは true であり、リクエストにパーツがない場合は例外がスローされます。パーツがリクエストに存在しない場合に null 値を使用したい場合は、これを false に切り替えます。

      デフォルト:
      true