WebRequestDataBinder (Spring Framework API)

java.lang.ObjectSE
- org.springframework.validation.DataBinder
- - org.springframework.web.bind.WebDataBinder
  - - org.springframework.web.bind.support.WebRequestDataBinder

実装されているすべてのインターフェース:
PropertyEditorRegistry, TypeConverter
```
public class WebRequestDataBinder
extends WebDataBinder
```
マルチパートファイルのサポートを含む、Web リクエストパラメーターから JavaBeans へのデータバインディングを実行する特別な DataBinder。
警告 : データバインディングは、外部クライアントによるアクセスや変更を目的としていないオブジェクトグラフの部分を公開することにより、セキュリティの課題を引き起こす可能性があります。データバインディングの設計と使用は、セキュリティに関して慎重に検討する必要があります。詳細については、リファレンスマニュアルの Spring Web MVC および Spring WebFlux のデータバインディングに関する専用セクションを参照してください。
許可 / 必須フィールドの指定、カスタムプロパティエディターの登録などのカスタマイズオプションについては、DataBinder/WebDataBinder スーパークラスを参照してください。
Spring の WebRequest 抽象化上に構築されたカスタム Web コントローラーやインターセプターの手動データバインディングにも使用できます (たとえば WebRequestInterceptor の実装)。各バインディングプロセスのために WebRequestDataBinder をインスタンス化し、現在の WebRequest を引数として bind を起動するだけです。
```
 MyBean myBean = new MyBean();
 // apply binder to custom target object
 WebRequestDataBinder binder = new WebRequestDataBinder(myBean);
 // register custom editors, if desired
 binder.registerCustomEditor(...);
 // trigger actual binding of request parameters
 binder.bind(request);
 // optionally evaluate binding errors
 Errors errors = binder.getErrors();
 ...
```
導入:
2.5.2
作成者:
Juergen Hoeller, Brian Clozel
関連事項:
bind(org.springframework.web.context.request.WebRequest), DataBinder.registerCustomEditor(java.lang.Class<?>, java.beans.PropertyEditor), DataBinder.setAllowedFields(java.lang.String...), DataBinder.setRequiredFields(java.lang.String...), WebDataBinder.setFieldMarkerPrefix(java.lang.String)

フィールドのサマリー
- クラス org.springframework.web.bind.WebDataBinder から継承されたフィールド
  DEFAULT_FIELD_DEFAULT_PREFIX, DEFAULT_FIELD_MARKER_PREFIX
- クラス org.springframework.validation.DataBinder から継承されたフィールド
  DEFAULT_AUTO_GROW_COLLECTION_LIMIT, DEFAULT_OBJECT_NAME, logger

コンストラクターの概要

コンストラクター
コンストラクターと説明
`WebRequestDataBinder(ObjectSE target)` デフォルトのオブジェクト名で、新しい WebRequestDataBinder インスタンスを作成します。
`WebRequestDataBinder(ObjectSE target, StringSE objectName)` 新しい WebRequestDataBinder インスタンスを作成します。

メソッドのサマリー

すべてのメソッドインスタンスメソッド具象メソッド
修飾子と型	メソッドと説明
`void`	`bind(WebRequest request)` 指定されたリクエストのパラメーターをこのバインダーのターゲットにバインドし、マルチパートリクエストの場合はマルチパートファイルもバインドします。
`void`	`closeNoCatch()` エラーを致命的として扱います。

クラス org.springframework.web.bind.WebDataBinder から継承されたメソッド
adaptEmptyArrayIndices, bindMultipart, checkFieldDefaults, checkFieldMarkers, doBind, getEmptyValue, getEmptyValue, getFieldDefaultPrefix, getFieldMarkerPrefix, isBindEmptyMultipartFiles, setBindEmptyMultipartFiles, setFieldDefaultPrefix, setFieldMarkerPrefix

クラス org.springframework.validation.DataBinder から継承されたメソッド
addCustomFormatter, addCustomFormatter, addCustomFormatter, addValidators, applyPropertyValues, bind, checkAllowedFields, checkRequiredFields, close, convertIfNecessary, convertIfNecessary, convertIfNecessary, convertIfNecessary, createBeanPropertyBindingResult, createDirectFieldBindingResult, findCustomEditor, getAllowedFields, getAutoGrowCollectionLimit, getBindingErrorProcessor, getBindingResult, getConversionService, getDisallowedFields, getInternalBindingResult, getObjectName, getPropertyAccessor, getPropertyEditorRegistry, getRequiredFields, getSimpleTypeConverter, getTarget, getTypeConverter, getValidator, getValidators, initBeanPropertyAccess, initDirectFieldAccess, isAllowed, isAutoGrowNestedPaths, isIgnoreInvalidFields, isIgnoreUnknownFields, registerCustomEditor, registerCustomEditor, replaceValidators, setAllowedFields, setAutoGrowCollectionLimit, setAutoGrowNestedPaths, setBindingErrorProcessor, setConversionService, setDisallowedFields, setIgnoreInvalidFields, setIgnoreUnknownFields, setMessageCodesResolver, setRequiredFields, setValidator, validate, validate

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

- コンストラクターの詳細
  - WebRequestDataBinder
```
public WebRequestDataBinder(@Nullable
                            ObjectSE target)
```
    デフォルトのオブジェクト名で、新しい WebRequestDataBinder インスタンスを作成します。
    パラメーター:
    target - バインドするターゲットオブジェクト (または、バインダーが単なるパラメーター値の変換に使用される場合は null )
    関連事項:
    DataBinder.DEFAULT_OBJECT_NAME
  - WebRequestDataBinder
```
public WebRequestDataBinder(@Nullable
                            ObjectSE target,
                            StringSE objectName)
```
    新しい WebRequestDataBinder インスタンスを作成します。
    パラメーター:
    target - バインドするターゲットオブジェクト (または、バインダーが単なるパラメーター値の変換に使用される場合は null )
    objectName - ターゲットオブジェクトの名前
- メソッドの詳細
  - bind
```
public void bind(WebRequest request)
```
    指定されたリクエストのパラメーターをこのバインダーのターゲットにバインドし、マルチパートリクエストの場合はマルチパートファイルもバインドします。
    この呼び出しにより、必須フィールド (コード「必須」) などの基本的なバインディングエラーや、値と Bean プロパティ (コード "typeMismatch" ) の型の不一致を表すフィールドエラーが発生する可能性があります。
    マルチパートファイルは、通常の HTTP パラメーターと同様に、パラメーター名によってバインドされます。つまり、"uploadedFile" は "uploadedFile" Bean プロパティにバインドされ、"setUploadedFile" setter メソッドを呼び出します。
    マルチパートファイルのターゲットプロパティの型は、MultipartFile、byte[]、または String です。サーブレットパーツバインディングは、リクエストが MultipartResolver を介して MultipartRequest に解析されていない場合にもサポートされます。
    パラメーター:
    request - バインドするパラメーターを含むリクエスト (マルチパートにすることができます)
    関連事項:
    MultipartRequest, MultipartFile, PartEE, DataBinder.bind(org.springframework.beans.PropertyValues)
  - closeNoCatch
```
public void closeNoCatch()
                  throws BindException
```
    エラーを致命的として扱います。
    このメソッドは、入力が有効でない場合にエラーになる場合にのみ使用してください。これは、たとえばすべての入力がドロップダウンからのものである場合に適切です。
    例外:
    BindException - バインディングエラーが発生した場合

クラス WebRequestDataBinder

フィールドのサマリー

クラス org.springframework.web.bind.WebDataBinder から継承されたフィールド

クラス org.springframework.validation.DataBinder から継承されたフィールド

コンストラクターの概要

メソッドのサマリー

クラス org.springframework.web.bind.WebDataBinder から継承されたメソッド

クラス org.springframework.validation.DataBinder から継承されたメソッド

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

コンストラクターの詳細

WebRequestDataBinder

WebRequestDataBinder

メソッドの詳細

bind

closeNoCatch