LocalValidatorFactoryBean (Spring Framework API)

java.lang.ObjectSE
- org.springframework.validation.beanvalidation.SpringValidatorAdapter
- - org.springframework.validation.beanvalidation.LocalValidatorFactoryBean

実装されたすべてのインターフェース:
ValidatorEE, ValidatorFactoryEE, Aware, DisposableBean, InitializingBean, ApplicationContextAware, SmartValidator
既知の直属サブクラス
OptionalValidatorFactoryBean
```
public class LocalValidatorFactoryBean
extends SpringValidatorAdapter
implements ValidatorFactoryEE, ApplicationContextAware, InitializingBean, DisposableBean
```
これは、Spring アプリケーションコンテキストでの javax.validation （JSR-303）セットアップの中心的なクラスです。javax.validation.ValidationFactory をブートストラップし、Spring Validator インターフェースと、JSR-303 ValidatorEE インターフェースおよび ValidatorFactoryEE インターフェース自体を介して公開します。
Spring または JSR-303 Validator インターフェースを介してこの Bean のインスタンスと通信するときは、基礎となる ValidatorFactory のデフォルトの Validator と通信します。デフォルトのバリデーターをほとんど常に使用すると仮定すると、ファクトリでさらに別の呼び出しを実行する必要がないという点で、これは非常に便利です。これは、型 Validator のターゲット依存関係に直接挿入することもできます。
Spring 5.0 の時点で、このクラスには Bean 検証 1.1 + が必要であり、Hibernate バリデーター 5.x が特別にサポートされています（setValidationMessageSource(org.springframework.context.MessageSource) を参照）。このクラスは、Bean 検証 2.0 および Hibernate バリデーター 6.0 ともランタイム互換ですが、特筆すべき点が 1 つあります。BV 2.0 の getClockProvider() メソッドを呼び出す場合は、#unwrap(ValidatorFactory.class) を介してネイティブ ValidatorFactory を取得し、そこで返されたネイティブ参照で getClockProvider() メソッドを呼び出します。
このクラスは、javax.validation API は存在するが明示的な Validator が構成されていない場合に、Spring の MVC 構成名前空間でも使用されます。
導入:
3.0
作成者:
Juergen Hoeller
関連事項:
ValidatorFactoryEE, ValidatorEE, Validation.buildDefaultValidatorFactory()EE, ValidatorFactory.getValidator()EE

コンストラクターのサマリー
コンストラクター
コンストラクターと説明
LocalValidatorFactoryBean()

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

メソッドのサマリー

すべてのメソッドインスタンスメソッド具象メソッド
修飾子と型	メソッドと説明
`void`	`afterPropertiesSet()` すべての Bean プロパティを設定し、`BeanFactoryAware`、`ApplicationContextAware` などを満たした後、包含 `BeanFactory` によって呼び出されます。
`void`	`close()`
`void`	`destroy()` Bean の破棄時に、包含 `BeanFactory` によって呼び出されます。
`ConstraintValidatorFactoryEE`	`getConstraintValidatorFactory()`
`MessageInterpolatorEE`	`getMessageInterpolator()`
`ParameterNameProviderEE`	`getParameterNameProvider()`
`TraversableResolverEE`	`getTraversableResolver()`
`MapSE<StringSE, StringSE>`	`getValidationPropertyMap()` 特定のエントリを追加またはオーバーライドするオプションを使用して、マップが Bean 検証プロパティへのアクセスを検証プロバイダーに渡すことを許可します。
`ValidatorEE`	`getValidator()`
`protected void`	`postProcessConfiguration(ConfigurationEE<?> configuration)` 指定された Bean 検証構成を後処理し、その設定を追加または上書きします。
`void`	`setApplicationContext(ApplicationContext applicationContext)` このオブジェクトが実行される ApplicationContext を設定します。
`void`	`setConstraintValidatorFactory(ConstraintValidatorFactoryEE constraintValidatorFactory)` この ValidatorFactory に使用するカスタム ConstraintValidatorFactory を指定します。
`void`	`setMappingLocations(Resource... mappingLocations)` XML 制約マッピングファイルをロードするリソースの場所を指定します（ある場合）。
`void`	`setMessageInterpolator(MessageInterpolatorEE messageInterpolator)` この ValidatorFactory とその公開されたデフォルトバリデーターに使用するカスタム MessageInterpolator を指定します。
`void`	`setParameterNameDiscoverer(ParameterNameDiscoverer parameterNameDiscoverer)` メッセージの補間に必要な場合は、メソッドとコンストラクターのパラメーター名の解決に使用する ParameterNameDiscoverer を設定します。
`void`	`setProviderClass(ClassSE providerClass)` 必要に応じて、必要なプロバイダークラスを指定します。
`void`	`setTraversableResolver(TraversableResolverEE traversableResolver)` この ValidatorFactory とその公開されたデフォルトバリデーターに使用するカスタム TraversableResolver を指定します。
`void`	`setValidationMessageSource(MessageSource messageSource)` クラスパスの JSR-303 のデフォルトの "ValidationMessages.properties" バンドルに依存する代わりに、検証メッセージを解決するためのカスタム Spring MessageSource を指定します。
`void`	`setValidationProperties(PropertiesSE jpaProperties)` 検証プロバイダーに渡される Bean 検証プロパティを指定します。
`void`	`setValidationPropertyMap(MapSE<StringSE, StringSE> validationProperties)` 検証プロバイダーにマップとして渡される Bean 検証プロパティを指定します。
`void`	`setValidationProviderResolver(ValidationProviderResolverEE validationProviderResolver)` `META-INF` による解決の代わりに、選択したプロバイダーをブートストラップするための JSR-303 `ValidationProviderResolver`EE を指定します。
`<T> T`	`unwrap(ClassSE<T> type)`
`ValidatorContextEE`	`usingContext()`

クラス org.springframework.validation.beanvalidation.SpringValidatorAdapter から継承されたメソッド
determineErrorCode, determineField, forExecutables, getArgumentsForConstraint, getConstraintsForClass, getRejectedValue, getResolvableField, processConstraintViolations, requiresMessageFormat, supports, validate, validate, validate, validateProperty, validateValue, validateValue

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

- コンストラクターの詳細
  - LocalValidatorFactoryBean
```
public LocalValidatorFactoryBean()
```
- メソッドの詳細
  - setProviderClass
```
public void setProviderClass(ClassSE providerClass)
```
    必要に応じて、必要なプロバイダークラスを指定します。
    指定しない場合、JSR-303 のデフォルトの検索メカニズムが使用されます。
    関連事項:
    Validation.byProvider(Class)EE, Validation.byDefaultProvider()EE
  - setValidationProviderResolver
```
public void setValidationProviderResolver(ValidationProviderResolverEE validationProviderResolver)
```
    META-INF による解決の代わりに、選択したプロバイダーをブートストラップするための JSR-303 ValidationProviderResolverEE を指定します。
    導入:
    4.3
  - setMessageInterpolator
```
public void setMessageInterpolator(MessageInterpolatorEE messageInterpolator)
```
    この ValidatorFactory とその公開されたデフォルトバリデーターに使用するカスタム MessageInterpolator を指定します。
  - setValidationMessageSource
```
public void setValidationMessageSource(MessageSource messageSource)
```
    クラスパス内の JSR-303 のデフォルトの "ValidationMessages.properties" バンドルに依存する代わりに、検証メッセージを解決するためのカスタム Spring MessageSource を指定します。これは、Spring コンテキストの共有 "messageSource" Bean、または検証目的のみの特別な MessageSource セットアップを参照する場合があります。
    注意 : この機能には、クラスパスに Hibernate Validator 4.3 以上が必要です。それでも別の検証プロバイダーを使用することはできますが、Hibernate Validator の ResourceBundleMessageInterpolator クラスは構成中にアクセス可能でなければなりません。
    このプロパティまたは "messageInterpolator" のいずれかを指定します。両方を指定することはできません。カスタム MessageInterpolator を作成する場合は、Hibernate Validator の ResourceBundleMessageInterpolator から派生させ、補間器を構築するときに Spring ベースの ResourceBundleLocator を渡すことを検討してください。
    Hibernate のデフォルトの検証メッセージを引き続き解決するには、MessageSource をオプションの解決（通常はデフォルト）に構成する必要があります。特に、ここで指定された MessageSource インスタンスは "useCodeAsDefaultMessage" の動作を適用しないでください。それに応じて設定を再確認してください。
    関連事項:
    ResourceBundleMessageInterpolator
  - setTraversableResolver
```
public void setTraversableResolver(TraversableResolverEE traversableResolver)
```
    この ValidatorFactory とその公開されたデフォルトバリデーターに使用するカスタム TraversableResolver を指定します。
  - setConstraintValidatorFactory
```
public void setConstraintValidatorFactory(ConstraintValidatorFactoryEE constraintValidatorFactory)
```
    この ValidatorFactory に使用するカスタム ConstraintValidatorFactory を指定します。
    デフォルトは SpringConstraintValidatorFactory であり、オートワイヤーされた ConstraintValidator インスタンスを作成するために、それを含む ApplicationContext に委譲します。
  - setParameterNameDiscoverer
```
public void setParameterNameDiscoverer(ParameterNameDiscoverer parameterNameDiscoverer)
```
    メッセージの補間に必要な場合は、メソッドとコンストラクターのパラメーター名の解決に使用する ParameterNameDiscoverer を設定します。
    デフォルトは DefaultParameterNameDiscoverer です。
  - setMappingLocations
```
public void setMappingLocations(Resource... mappingLocations)
```
    XML 制約マッピングファイルをロードするリソースの場所を指定します（ある場合）。
  - setValidationProperties
```
public void setValidationProperties(PropertiesSE jpaProperties)
```
    検証プロバイダーに渡される Bean 検証プロパティを指定します。
    文字列 "value" （PropertiesEditor で解析）または XML Bean 定義の "props" 要素を入力できます。
    関連事項:
    Configuration.addProperty(String, String)EE
  - setValidationPropertyMap
```
public void setValidationPropertyMap(@Nullable
                                     MapSE<StringSE,StringSE> validationProperties)
```
    検証プロバイダーにマップとして渡される Bean 検証プロパティを指定します。
    XML Bean 定義の「マップ」または "props" 要素を取り込むことができます。
    関連事項:
    Configuration.addProperty(String, String)EE
  - getValidationPropertyMap
```
public MapSE<StringSE,StringSE> getValidationPropertyMap()
```
    特定のエントリを追加またはオーバーライドするオプションを使用して、マップが Bean 検証プロパティへのアクセスを検証プロバイダーに渡すことを許可します。
    たとえば "validationPropertyMap [myKey]" を介してエントリを直接指定するのに便利です。
  - setApplicationContext
```
public void setApplicationContext(ApplicationContext applicationContext)
```
    インターフェースからコピーされた説明: ApplicationContextAware
    このオブジェクトが実行される ApplicationContext を設定します。通常、この呼び出しはオブジェクトの初期化に使用されます。
    通常の Bean プロパティの設定後、ただし InitializingBean.afterPropertiesSet() またはカスタム init メソッドなどの init コールバックの前に呼び出されます。ResourceLoaderAware.setResourceLoader(org.springframework.core.io.ResourceLoader)、ApplicationEventPublisherAware.setApplicationEventPublisher(org.springframework.context.ApplicationEventPublisher) および MessageSourceAware の後に呼び出されます（該当する場合）。
    次で指定:
    インターフェース ApplicationContextAware の setApplicationContext
    パラメーター:
    applicationContext - このオブジェクトによって使用される ApplicationContext オブジェクト
    関連事項:
    BeanInitializationException
  - afterPropertiesSet
```
public void afterPropertiesSet()
```
    インターフェースからコピーされた説明: InitializingBean
    すべての Bean プロパティを設定し、BeanFactoryAware、ApplicationContextAware などを満たした後、包含 BeanFactory によって呼び出されます。
    このメソッドにより、Bean インスタンスは、すべての Bean プロパティが設定されたときに、その全体的な構成の検証と最終的な初期化を実行できます。
    次で指定:
    インターフェース InitializingBean の afterPropertiesSet
  - postProcessConfiguration
```
protected void postProcessConfiguration(ConfigurationEE<?> configuration)
```
    指定された Bean 検証構成を後処理し、その設定を追加または上書きします。
    ValidatorFactoryEE をビルドする直前に呼び出されます。
    パラメーター:
    configuration - LocalValidatorFactoryBean のプロパティによって駆動される設定が事前に入力された構成オブジェクト
  - getValidator
```
public ValidatorEE getValidator()
```
    次で指定:
    インターフェース ValidatorFactoryEE の getValidatorEE
  - usingContext
```
public ValidatorContextEE usingContext()
```
    次で指定:
    インターフェース ValidatorFactoryEE の usingContextEE
  - getMessageInterpolator
```
public MessageInterpolatorEE getMessageInterpolator()
```
    次で指定:
    インターフェース ValidatorFactoryEE の getMessageInterpolatorEE
  - getTraversableResolver
```
public TraversableResolverEE getTraversableResolver()
```
    次で指定:
    インターフェース ValidatorFactoryEE の getTraversableResolverEE
  - getConstraintValidatorFactory
```
public ConstraintValidatorFactoryEE getConstraintValidatorFactory()
```
    次で指定:
    インターフェース ValidatorFactoryEE の getConstraintValidatorFactoryEE
  - getParameterNameProvider
```
public ParameterNameProviderEE getParameterNameProvider()
```
    次で指定:
    インターフェース ValidatorFactoryEE の getParameterNameProviderEE
  - unwrap
```
public <T> T unwrap(@Nullable
                    ClassSE<T> type)
```
    次で指定:
    インターフェース ValidatorEE の unwrapEE
    次で指定:
    インターフェース ValidatorFactoryEE の unwrapEE
    オーバーライド:
    クラス SpringValidatorAdapter の unwrap
  - close
```
public void close()
```
    次で指定:
    インターフェース ValidatorFactoryEE の closeEE
  - destroy
```
public void destroy()
```
    インターフェースからコピーされた説明: DisposableBean
    Bean の破棄時に、包含 BeanFactory によって呼び出されます。
    次で指定:
    インターフェース DisposableBean の destroy

クラス LocalValidatorFactoryBean

コンストラクターのサマリー

メソッドのサマリー

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

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

コンストラクターの詳細

LocalValidatorFactoryBean

メソッドの詳細

setProviderClass

setValidationProviderResolver

setMessageInterpolator

setValidationMessageSource

setTraversableResolver

setConstraintValidatorFactory

setParameterNameDiscoverer

setMappingLocations

setValidationProperties

setValidationPropertyMap

getValidationPropertyMap

setApplicationContext

afterPropertiesSet

postProcessConfiguration

getValidator

usingContext

getMessageInterpolator

getTraversableResolver

getConstraintValidatorFactory

getParameterNameProvider

unwrap

close

destroy