FormHttpMessageConverter (Spring Framework 5.1.12.RELEASE API)

java.lang.ObjectSE
- org.springframework.http.converter.FormHttpMessageConverter

実装されているすべてのインターフェース:
HttpMessageConverter<MultiValueMap<StringSE,?>>
既知の直属サブクラス
AllEncompassingFormHttpMessageConverter
```
public class FormHttpMessageConverter
extends ObjectSE
implements HttpMessageConverter<MultiValueMap<StringSE,?>>
```
HttpMessageConverter の実装により、「通常の」HTML フォームの読み取りと書き込み、およびマルチパートデータの書き込み（読み取りは不可）（ファイルのアップロードなど）を行うことができます。
つまり、このコンバーターは、"application/x-www-form-urlencoded" メディア型を MultiValueMap<String, String> として読み書きでき、"multipart/form-data" メディア型を MultiValueMap<String, Object> として書き込むこともできます（ただし、読み取ることはできません）。
マルチパートデータを書き込むとき、このコンバーターは他の HttpMessageConverters を使用してそれぞれの MIME パートを書き込みます。デフォルトでは、基本コンバーターが登録されています（Strings および Resources の場合）。これらは、partConverters プロパティによってオーバーライドできます。
例: 次のスニペットは、HTML フォームを送信する方法を示しています。
```
 RestTemplate template = new RestTemplate();
 // AllEncompassingFormHttpMessageConverter is configured by default

 MultiValueMap<String, Object> form = new LinkedMultiValueMap<>();
 form.add("field 1", "value 1");
 form.add("field 2", "value 2");
 form.add("field 2", "value 3");
 form.add("field 3", 4);  // non-String form values supported as of 5.1.4
 template.postForLocation("https://example.com/myForm", form);
 
```
次のスニペットは、ファイルのアップロード方法を示しています。
```
 MultiValueMap<String, Object> parts = new LinkedMultiValueMap<>();
 parts.add("field 1", "value 1");
 parts.add("file", new ClassPathResource("myFile.jpg"));
 template.postForLocation("https://example.com/myFileUpload", parts);
 
```
このクラスの一部のメソッドは org.apache.commons.httpclient.methods.multipart.MultipartRequestEntity に触発されました。
導入:
3.0
作成者:
Arjen Poutsma, Rossen Stoyanchev, Juergen Hoeller
関連事項:
AllEncompassingFormHttpMessageConverter, MultiValueMap

フィールドのサマリー
フィールド
修飾子と型フィールドと説明
static CharsetSE DEFAULT_CHARSET
コンバーターが使用するデフォルトの文字セット。

フィールド
修飾子と型	フィールドと説明
`static CharsetSE`	`DEFAULT_CHARSET` コンバーターが使用するデフォルトの文字セット。

コンストラクターの概要
コンストラクター
コンストラクターと説明
FormHttpMessageConverter()

コンストラクター
コンストラクターと説明
`FormHttpMessageConverter()`

メソッドのサマリー

すべてのメソッドインスタンスメソッド具象メソッド
修飾子と型	メソッドと説明
`void`	`addPartConverter(HttpMessageConverter<?> partConverter)` メッセージ本文コンバーターを追加します。
`boolean`	`canRead(ClassSE<?> clazz, MediaType mediaType)` 指定されたクラスがこのコンバーターで読み取れるかどうかを示します。
`boolean`	`canWrite(ClassSE<?> clazz, MediaType mediaType)` 指定されたクラスをこのコンバーターで書き込めるかどうかを示します。
`protected byte[]`	`generateMultipartBoundary()` マルチパート境界を生成します。
`protected StringSE`	`getFilename(ObjectSE part)` 指定されたマルチパートパーツのファイル名を返します。
`protected HttpEntity<?>`	`getHttpEntity(ObjectSE part)` 指定されたパーツオブジェクトの `HttpEntity` を返します。
`ListSE<MediaType>`	`getSupportedMediaTypes()` このコンバーターがサポートする `MediaType` オブジェクトのリストを返します。
`MultiValueMap<StringSE, StringSE>`	`read(ClassSE<? extends MultiValueMap<StringSE,?>> clazz, HttpInputMessage inputMessage)` 指定された入力メッセージから指定された型のオブジェクトを読み取り、それを返します。
`protected StringSE`	`serializeForm(MultiValueMap<StringSE, ObjectSE> formData, CharsetSE charset)`
`void`	`setCharset(CharsetSE charset)` リクエストまたはレスポンスの Content-Type ヘッダーで明示的に指定されていない場合に、フォームデータの読み取りと書き込みに使用するデフォルトの文字セットを設定します。
`void`	`setMultipartCharset(CharsetSE charset)` ファイル名をエンコードするマルチパートデータを書き込むときに使用する文字セットを設定します。
`void`	`setPartConverters(ListSE<HttpMessageConverter<?>> partConverters)` 使用するメッセージ本文コンバーターを設定します。
`void`	`setSupportedMediaTypes(ListSE<MediaType> supportedMediaTypes)` このコンバーターによってサポートされる `MediaType` オブジェクトのリストを設定します。
`void`	`write(MultiValueMap<StringSE,?> map, MediaType contentType, HttpOutputMessage outputMessage)` 指定されたオブジェクトを指定された出力メッセージに書き込みます。

クラス java.lang.ObjectSE から継承されたメソッド
cloneSE, equalsSE, finalizeSE, getClassSE, hashCodeSE, notifySE, notifyAllSE, toStringSE, waitSE, waitSE, waitSE

- フィールドの詳細
  - DEFAULT_CHARSET
```
public static final CharsetSE DEFAULT_CHARSET
```
    コンバーターが使用するデフォルトの文字セット。
- コンストラクターの詳細
  - FormHttpMessageConverter
```
public FormHttpMessageConverter()
```
- メソッドの詳細
  - setSupportedMediaTypes
```
public void setSupportedMediaTypes(ListSE<MediaType> supportedMediaTypes)
```
    このコンバーターによってサポートされる MediaType オブジェクトのリストを設定します。
  - getSupportedMediaTypes
```
public ListSE<MediaType> getSupportedMediaTypes()
```
    インターフェースからコピーされた説明: HttpMessageConverter
    このコンバーターがサポートする MediaType オブジェクトのリストを返します。
    次で指定:
    インターフェース HttpMessageConverter<MultiValueMap<StringSE,?>> の getSupportedMediaTypes
    戻り値:
    サポートされているメディア型のリスト
  - setPartConverters
```
public void setPartConverters(ListSE<HttpMessageConverter<?>> partConverters)
```
    使用するメッセージ本文コンバーターを設定します。これらのコンバーターは、オブジェクトを MIME パーツに変換するために使用されます。
  - addPartConverter
```
public void addPartConverter(HttpMessageConverter<?> partConverter)
```
    メッセージ本文コンバーターを追加します。このようなコンバーターは、オブジェクトを MIME パーツに変換するために使用されます。
  - setCharset
```
public void setCharset(@Nullable
                       CharsetSE charset)
```
    リクエストまたはレスポンスの Content-Type ヘッダーで明示的に指定されていない場合に、フォームデータの読み取りと書き込みに使用するデフォルトの文字セットを設定します。
    4.3 の時点で、これはマルチパートリクエストのテキスト本文の変換のデフォルトの文字セットとしても使用されます。
    5.0 以降、これは「相互配置」（およびそのファイル名パラメーター）を含むパーツヘッダーにも使用されます（相互に排他的な）setMultipartCharset(java.nio.charset.Charset) も設定されていない場合、パーツヘッダーは ASCII としてエンコードされ、 ファイル名は「エンコードされた RFC 2047 の -word " 構文。
    デフォルトでは、これは "UTF-8" に設定されています。
  - setMultipartCharset
```
public void setMultipartCharset(CharsetSE charset)
```
    マルチパートデータを書き込んでファイル名をエンコードするときに使用する文字セットを設定します。エンコーディングは、RFC 2047 で定義されている "encoded-word" 構文に基づいており、"javax.mail" の MimeUtility に依存しています。
    5.0 以降、デフォルトでは、Content-Disposition（およびそのファイル名パラメーター）を含むパーツヘッダーは、デフォルトで setCharset(Charset) または UTF-8 の設定に基づいてエンコードされます。
    導入:
    4.1.1
    関連事項:
    エンコードされた単語
  - canRead
```
public boolean canRead(ClassSE<?> clazz,
                       @Nullable
                       MediaType mediaType)
```
    インターフェースからコピーされた説明: HttpMessageConverter
    指定されたクラスがこのコンバーターで読み取れるかどうかを示します。
    次で指定:
    インターフェース HttpMessageConverter<MultiValueMap<StringSE,?>> の canRead
    パラメーター:
    clazz - 読み込み可能性をテストするクラス
    mediaType - 読み取るメディア型（指定しない場合は null にできます）; 通常、Content-Type ヘッダーの値。
    戻り値:
    読み取り可能な場合は true。それ以外の場合は false
  - canWrite
```
public boolean canWrite(ClassSE<?> clazz,
                        @Nullable
                        MediaType mediaType)
```
    インターフェースからコピーされた説明: HttpMessageConverter
    指定されたクラスをこのコンバーターで書き込めるかどうかを示します。
    次で指定:
    インターフェース HttpMessageConverter<MultiValueMap<StringSE,?>> の canWrite
    パラメーター:
    clazz - 書き込み可能性をテストするクラス
    mediaType - 書き込むメディア型（指定しない場合は null にすることができます）; 通常、Accept ヘッダーの値。
    戻り値:
    書き込み可能な場合は true。それ以外の場合は false
  - read
```
public MultiValueMap<StringSE,StringSE> read(@Nullable
                                         ClassSE<? extends MultiValueMap<StringSE,?>> clazz,
                                         HttpInputMessage inputMessage)
                                  throws IOExceptionSE,
                                         HttpMessageNotReadableException
```
    インターフェースからコピーされた説明: HttpMessageConverter
    指定された入力メッセージから指定された型のオブジェクトを読み取り、それを返します。
    次で指定:
    インターフェース HttpMessageConverter<MultiValueMap<StringSE,?>> の read
    パラメーター:
    clazz - 返すオブジェクトの型。この型は、このインターフェースの canRead メソッドに事前に渡されている必要があります。このメソッドは true を返している必要があります。
    inputMessage - 読み込む HTTP 入力メッセージ
    戻り値:
    変換されたオブジェクト
    例外:
    IOExceptionSE - I/O エラーの場合
    HttpMessageNotReadableException - 変換エラーの場合
  - write
```
public void write(MultiValueMap<StringSE,?> map,
                  @Nullable
                  MediaType contentType,
                  HttpOutputMessage outputMessage)
           throws IOExceptionSE,
                  HttpMessageNotWritableException
```
    インターフェースからコピーされた説明: HttpMessageConverter
    指定されたオブジェクトを指定された出力メッセージに書き込みます。
    次で指定:
    インターフェース HttpMessageConverter<MultiValueMap<StringSE,?>> の write
    パラメーター:
    map - 出力メッセージに書き込むオブジェクト。このオブジェクトの型は、このインターフェースの canWrite メソッドに事前に渡されている必要があります。このメソッドは true を返している必要があります。
    contentType - 書き込み時に使用するコンテンツ型。コンバーターのデフォルトのコンテンツ型を使用する必要があることを示す null の場合があります。null でない場合、このメディア型は、このインターフェースの canWrite メソッドに事前に渡されている必要があり、true が返されている必要があります。
    outputMessage - 書き込むメッセージ
    例外:
    IOExceptionSE - I/O エラーの場合
    HttpMessageNotWritableException - 変換エラーの場合
  - serializeForm
```
protected StringSE serializeForm(MultiValueMap<StringSE,ObjectSE> formData,
                               CharsetSE charset)
```
  - generateMultipartBoundary
```
protected byte[] generateMultipartBoundary()
```
    マルチパート境界を生成します。
    この実装は MimeTypeUtils.generateMultipartBoundary() に委譲します。
  - getHttpEntity
```
protected HttpEntity<?> getHttpEntity(ObjectSE part)
```
    指定されたパーツオブジェクトの HttpEntity を返します。
    パラメーター:
    part - HttpEntity を返す部分
    戻り値:
    パーツオブジェクト自体は HttpEntity、またはそのパーツ用に新しく構築された HttpEntity ラッパー
  - getFilename
```
@Nullable
protected StringSE getFilename(ObjectSE part)
```
    指定されたマルチパートパーツのファイル名を返します。この値は Content-Disposition ヘッダーに使用されます。
    デフォルトの実装は、パーツが Resource の場合は Resource.getFilename() を返し、それ以外の場合は null を返します。サブクラスでオーバーライドできます。
    パラメーター:
    part - ファイル名を決定する部分
    戻り値:
    ファイル名、または不明の場合は null

クラス FormHttpMessageConverter

フィールドのサマリー

コンストラクターの概要

メソッドのサマリー

クラス java.lang.ObjectSE から継承されたメソッド

フィールドの詳細

DEFAULT_CHARSET

コンストラクターの詳細

FormHttpMessageConverter

メソッドの詳細

setSupportedMediaTypes

getSupportedMediaTypes

setPartConverters

addPartConverter

setCharset

setMultipartCharset

canRead

canWrite

read

write

serializeForm

generateMultipartBoundary

getHttpEntity

getFilename