クラス FormattingConversionServiceFactoryBean

java.lang.ObjectSE
org.springframework.format.support.FormattingConversionServiceFactoryBean
実装されたすべてのインターフェース:
AwareFactoryBean<FormattingConversionService>InitializingBeanEmbeddedValueResolverAware

public class FormattingConversionServiceFactoryBean extends ObjectSE implements FactoryBean<FormattingConversionService>, EmbeddedValueResolverAware, InitializingBean
数値や日時などの一般的な型のコンバーターおよびフォーマッターで構成された 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
  • コンストラクターの詳細

    • FormattingConversionServiceFactoryBean

      public FormattingConversionServiceFactoryBean()
  • メソッドの詳細

    • setConverters

      public void setConverters(SetSE<?> converters)
      追加する必要があるカスタムコンバーターオブジェクトのセットを構成します。
      パラメーター:
      converters - 次のいずれかのインスタンス: ConverterConverterFactoryGenericConverter
    • setFormatters

      public void setFormatters(SetSE<?> formatters)
      追加する必要があるカスタムフォーマッタオブジェクトのセットを構成します。
      パラメーター:
      formatters - Formatter または AnnotationFormatterFactory のインスタンス
    • setFormatterRegistrars

      public void setFormatterRegistrars(SetSE<FormatterRegistrar> formatterRegistrars)

      setConverters(Set) および setFormatters(Set) を介して宣言的に追加されたものに加えて、コンバーターおよびフォーマッターを登録するために呼び出す FormatterRegistrars のセットを構成します。

      FormatterRegistrars は、日付の書式設定など、書式設定カテゴリに関連する複数のコンバーターおよびフォーマッタを登録するときに役立ちます。書式カテゴリをサポートするために必要なすべての関連型を 1 か所から登録できます。

      FormatterRegistrars を使用して、独自の <T> とは異なる特定のフィールド型でインデックスが付けられたフォーマッターを登録したり、プリンター / パーサーのペアからフォーマッターを登録したりすることもできます。

      関連事項:
    • setRegisterDefaultFormatters

      public void setRegisterDefaultFormatters(boolean registerDefaultFormatters)
      デフォルトのフォーマッターを登録するかどうかを指定します。

      デフォルトでは、組み込みフォーマッタが登録されています。このフラグを使用して、これをオフにし、明示的に登録されたフォーマッターのみに依存することができます。

      関連事項:
    • setEmbeddedValueResolver

      public void setEmbeddedValueResolver(StringValueResolver embeddedValueResolver)
      インターフェースからコピーされた説明: EmbeddedValueResolverAware
      StringValueResolver を設定して、埋め込まれた定義値の解決に使用します。
      次で指定:
      インターフェース EmbeddedValueResolverAwaresetEmbeddedValueResolver 
    • afterPropertiesSet

      public void afterPropertiesSet()
      インターフェースからコピーされた説明: InitializingBean
      すべての Bean プロパティを設定し、BeanFactoryAwareApplicationContextAware などを満たした後、包含 BeanFactory によって呼び出されます。

      このメソッドにより、Bean インスタンスは、すべての Bean プロパティが設定されたときに、その全体的な構成の検証と最終的な初期化を実行できます。

      次で指定:
      インターフェース InitializingBeanafterPropertiesSet 
    • getObject

      インターフェースからコピーされた説明: FactoryBean
      このファクトリによって管理されるオブジェクトのインスタンス(おそらく共有または独立)を返します。

      BeanFactory と同様に、これにより、シングルトンとプロトタイプの両方のデザインパターンをサポートできます。

      この FactoryBean が呼び出し時にまだ完全に初期化されていない場合(たとえば、循環参照に関係しているため)、対応する FactoryBeanNotInitializedException をスローします。

      Spring 2.0 以降、FactoryBeans は null オブジェクトを返すことができます。ファクトリはこれを通常の値として使用します。この場合、FactoryBeanNotInitializedException はスローされません。FactoryBean の実装では、必要に応じて FactoryBeanNotInitializedException 自体をすぐにスローすることをお勧めします。

      次で指定:
      インターフェース FactoryBean<FormattingConversionService>getObject 
      戻り値:
      Bean のインスタンス (null にすることができます)
      関連事項:
    • getObjectType

      public ClassSE<? extends FormattingConversionService> 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 
      戻り値:
      公開されたオブジェクトがシングルトンかどうか
      関連事項: