クラス FormattingConversionServiceFactoryBean
- 実装されたすべてのインターフェース:
Aware
、FactoryBean<FormattingConversionService>
、InitializingBean
、EmbeddedValueResolverAware
FormattingConversionService
への便利なアクセスを提供するファクトリ。setConverters(Set)
および setFormatters(Set)
を使用して、追加のコンバーターおよびフォーマッターを宣言的に登録できます。別のオプションは、FormatterRegistrar
インターフェースを実装することにより、コンバーターとフォーマッターをコードに登録することです。次に、setFormatterRegistrars(Set)
を介して使用するレジストラのセットを提供するように構成できます。
コードにコンバーターとフォーマッターを登録する良い例は、JodaTimeFormatterRegistrar
です。これは、日付に関連する多くのフォーマッターとコンバーターを登録します。ケースのより詳細なリストについては、setFormatterRegistrars(Set)
を参照してください
すべての FactoryBean
実装と同様に、このクラスは、Spring <beans>
XML を使用して Spring アプリケーションコンテキストを構成するときに使用するのに適しています。コンテナーを @Configuration
クラスで構成するときは、@Bean
メソッドから適切な FormattingConversionService
オブジェクトをインスタンス化して構成し、返すだけです。
- 導入:
- 3.0
- 作成者:
- Keith Donald, Juergen Hoeller, Rossen Stoyanchev, Chris Beams
フィールドサマリー
インターフェース org.springframework.beans.factory.FactoryBean から継承されたフィールド
OBJECT_TYPE_ATTRIBUTE
コンストラクターのサマリー
コンストラクターメソッドのサマリー
修飾子と型メソッド説明void
このファクトリによって管理されるオブジェクトのインスタンス(おそらく共有または独立)を返します。ClassSE<? extends FormattingConversionService>
この FactoryBean が作成するオブジェクトの型、または事前に不明な場合はnull
を返します。boolean
このファクトリによって管理されるオブジェクトはシングルトンですか? つまり、FactoryBean.getObject()
は常に同じオブジェクト(キャッシュ可能な参照)を返しますか?void
setConverters
(SetSE<?> converters) 追加する必要があるカスタムコンバーターオブジェクトのセットを構成します。void
setEmbeddedValueResolver
(StringValueResolver embeddedValueResolver) StringValueResolver を設定して、埋め込まれた定義値の解決に使用します。void
setFormatterRegistrars
(SetSE<FormatterRegistrar> formatterRegistrars) setConverters(Set)
およびsetFormatters(Set)
を介して宣言的に追加されたものに加えて、コンバーターおよびフォーマッターを登録するために呼び出す FormatterRegistrars のセットを構成します。void
setFormatters
(SetSE<?> formatters) 追加する必要があるカスタムフォーマッタオブジェクトのセットを構成します。void
setRegisterDefaultFormatters
(boolean registerDefaultFormatters) デフォルトのフォーマッターを登録するかどうかを指定します。
コンストラクターの詳細
FormattingConversionServiceFactoryBean
public FormattingConversionServiceFactoryBean()
メソッドの詳細
setConverters
追加する必要があるカスタムコンバーターオブジェクトのセットを構成します。- パラメーター:
converters
- 次のいずれかのインスタンス:Converter
、ConverterFactory
、GenericConverter
setFormatters
追加する必要があるカスタムフォーマッタオブジェクトのセットを構成します。- パラメーター:
formatters
-Formatter
またはAnnotationFormatterFactory
のインスタンス
setFormatterRegistrars
setConverters(Set)
およびsetFormatters(Set)
を介して宣言的に追加されたものに加えて、コンバーターおよびフォーマッターを登録するために呼び出す FormatterRegistrars のセットを構成します。FormatterRegistrars は、日付の書式設定など、書式設定カテゴリに関連する複数のコンバーターおよびフォーマッタを登録するときに役立ちます。書式カテゴリをサポートするために必要なすべての関連型を 1 か所から登録できます。
FormatterRegistrars を使用して、独自の <T> とは異なる特定のフィールド型でインデックスが付けられたフォーマッターを登録したり、プリンター / パーサーのペアからフォーマッターを登録したりすることもできます。
setRegisterDefaultFormatters
public void setRegisterDefaultFormatters(boolean registerDefaultFormatters) デフォルトのフォーマッターを登録するかどうかを指定します。デフォルトでは、組み込みフォーマッタが登録されています。このフラグを使用して、これをオフにし、明示的に登録されたフォーマッターのみに依存することができます。
setEmbeddedValueResolver
インターフェースからコピーされた説明:EmbeddedValueResolverAware
StringValueResolver を設定して、埋め込まれた定義値の解決に使用します。- 次で指定:
- インターフェース
EmbeddedValueResolverAware
のsetEmbeddedValueResolver
afterPropertiesSet
public void afterPropertiesSet()インターフェースからコピーされた説明:InitializingBean
すべての Bean プロパティを設定し、BeanFactoryAware
、ApplicationContextAware
などを満たした後、包含BeanFactory
によって呼び出されます。このメソッドにより、Bean インスタンスは、すべての Bean プロパティが設定されたときに、その全体的な構成の検証と最終的な初期化を実行できます。
- 次で指定:
- インターフェース
InitializingBean
のafterPropertiesSet
getObject
インターフェースからコピーされた説明:FactoryBean
このファクトリによって管理されるオブジェクトのインスタンス(おそらく共有または独立)を返します。BeanFactory
と同様に、これにより、シングルトンとプロトタイプの両方のデザインパターンをサポートできます。この FactoryBean が呼び出し時にまだ完全に初期化されていない場合(たとえば、循環参照に関係しているため)、対応する
FactoryBeanNotInitializedException
をスローします。Spring 2.0 以降、FactoryBeans は
null
オブジェクトを返すことができます。ファクトリはこれを通常の値として使用します。この場合、FactoryBeanNotInitializedException はスローされません。FactoryBean の実装では、必要に応じて FactoryBeanNotInitializedException 自体をすぐにスローすることをお勧めします。- 次で指定:
- インターフェース
FactoryBean<FormattingConversionService>
のgetObject
- 戻り値:
- Bean のインスタンス (
null
にすることができます) - 関連事項:
getObjectType
インターフェースからコピーされた説明:FactoryBean
この FactoryBean が作成するオブジェクトの型、または事前に不明な場合はnull
を返します。これにより、たとえばオートワイヤーなどで、オブジェクトをインスタンス化せずに特定の型の Bean を確認できます。
シングルトンオブジェクトを作成している実装の場合、このメソッドはシングルトンの作成を可能な限り回避しようとします。むしろ、事前に型を推定する必要があります。プロトタイプの場合、ここで意味のある型を返すこともお勧めします。
このメソッドは、この FactoryBean が完全に初期化される前に呼び出すことができます。初期化中に作成された状態に依存しないでください。もちろん、利用可能な場合はそのような状態を引き続き使用できます。
注意 : オートワイヤーは、ここで
null
を返す FactoryBeans を単に無視します。FactoryBean の現在の状態を使用して、このメソッドを適切に実装することを強くお勧めします。- 次で指定:
- インターフェース
FactoryBean<FormattingConversionService>
のgetObjectType
- 戻り値:
- この FactoryBean が作成するオブジェクトの型、または呼び出し時に不明な場合は
null
- 関連事項:
isSingleton
public boolean isSingleton()インターフェースからコピーされた説明:FactoryBean
このファクトリによって管理されるオブジェクトはシングルトンですか? つまり、FactoryBean.getObject()
は常に同じオブジェクト(キャッシュ可能な参照)を返しますか?注意 : FactoryBean がシングルトンオブジェクトを保持することを示す場合、
getObject()
から返されたオブジェクトは所有 BeanFactory によってキャッシュされる可能性があります。FactoryBean が常に同じ参照を公開しない限り、true
を返さないでください。FactoryBean 自体のシングルトンステータスは、通常、所有する BeanFactory によって提供されます。通常、そこではシングルトンとして定義する必要があります。
注意 :
false
を返すこのメソッドは、返されるオブジェクトが独立したインスタンスであることを必ずしも示しません。拡張SmartFactoryBean
インターフェースの実装は、SmartFactoryBean.isPrototype()
メソッドを通じて独立したインスタンスを明示的に示す場合があります。この拡張インターフェースを実装しないプレーンなFactoryBean
実装は、isSingleton()
実装がfalse
を返す場合、常に独立したインスタンスを返すと単純に想定されます。FactoryBean
は通常シングルトンインスタンスを管理するため、デフォルトの実装ではtrue
が返されます。- 次で指定:
- インターフェース
FactoryBean<FormattingConversionService>
のisSingleton
- 戻り値:
- 公開されたオブジェクトがシングルトンかどうか
- 関連事項: