インターフェース ConversionService
- すべての既知のサブインターフェース:
ConfigurableConversionService
- すべての既知の実装クラス:
DefaultConversionService
、DefaultFormattingConversionService
、FormattingConversionService
、GenericConversionService
public interface ConversionService
型変換のためのサービスインターフェース。これは、変換システムへのエントリポイントです。
convert(Object, Class)
を呼び出して、このシステムを使用してスレッドセーフな型変換を実行します。- 導入:
- 3.0
- 作成者:
- Keith Donald, Phillip Webb
メソッドのサマリー
修飾子と型メソッド説明boolean
canConvert
(ClassSE<?> sourceType, ClassSE<?> targetType) sourceType
のオブジェクトをtargetType
に変換できる場合は、true
を返します。boolean
canConvert
(TypeDescriptor sourceType, TypeDescriptor targetType) sourceType
のオブジェクトをtargetType
に変換できる場合は、true
を返します。<T> T
指定されたsource
を指定されたtargetType
に変換します。convert
(ObjectSE source, TypeDescriptor sourceType, TypeDescriptor targetType) 指定されたsource
を指定されたtargetType
に変換します。
メソッドの詳細
canConvert
sourceType
のオブジェクトをtargetType
に変換できる場合は、true
を返します。このメソッドが
true
を返す場合、convert(Object, Class)
がsourceType
のインスタンスをtargetType
に変換できることを意味します。コレクション、配列、マップ型に関する特記事項: コレクション、配列、マップ型間の変換では、基礎となる要素が変換可能でない場合に変換呼び出しが
ConversionException
を生成する場合でも、このメソッドはtrue
を返します。呼び出し元は、コレクションとマップを操作するときにこの例外的なケースを処理することが期待されています。- パラメーター:
sourceType
- 変換元のソース型 (ソースがnull
の場合、null
になる場合があります)targetType
- 変換するターゲット型 (必須)- 戻り値:
- 変換を実行できる場合は
true
、そうでない場合はfalse
- 例外:
IllegalArgumentExceptionSE
-targetType
がnull
の場合
canConvert
sourceType
のオブジェクトをtargetType
に変換できる場合は、true
を返します。TypeDescriptors は、変換が発生するソースとターゲットの場所(多くの場合、オブジェクトフィールドまたはプロパティの場所)に関する追加のコンテキストを提供します。このメソッドが
true
を返す場合、convert(Object, TypeDescriptor, TypeDescriptor)
がsourceType
のインスタンスをtargetType
に変換できることを意味します。コレクション、配列、マップ型に関する特記事項: コレクション、配列、マップ型間の変換では、基礎となる要素が変換可能でない場合に変換呼び出しが
ConversionException
を生成する場合でも、このメソッドはtrue
を返します。呼び出し元は、コレクションとマップを操作するときにこの例外的なケースを処理することが期待されています。- パラメーター:
sourceType
- 変換元のソース型に関するコンテキスト (ソースがnull
の場合、null
になる場合があります)targetType
- 変換するターゲット型に関するコンテキスト (必須)- 戻り値:
- ソース型とターゲット型の間で変換を実行できる場合は
true
、そうでない場合はfalse
- 例外:
IllegalArgumentExceptionSE
-targetType
がnull
の場合
convert
指定されたsource
を指定されたtargetType
に変換します。- パラメーター:
source
- 変換するソースオブジェクト (null
の場合があります)targetType
- 変換するターゲット型 (必須)- 戻り値:
- 変換されたオブジェクト、targetType のインスタンス
- 例外:
ConversionException
- 変換例外が発生した場合IllegalArgumentExceptionSE
- targetType がnull
の場合
convert
@Nullable ObjectSE convert(@Nullable ObjectSE source, @Nullable TypeDescriptor sourceType, TypeDescriptor targetType) 指定されたsource
を指定されたtargetType
に変換します。TypeDescriptors は、変換が発生するソースおよびターゲットの場所(多くの場合、オブジェクトフィールドまたはプロパティの場所)に関する追加のコンテキストを提供します。- パラメーター:
source
- 変換するソースオブジェクト (null
の場合があります)sourceType
- 変換元のソース型に関するコンテキスト (ソースがnull
の場合、null
になる場合があります)targetType
- 変換するターゲット型に関するコンテキスト (必須)- 戻り値:
- 変換されたオブジェクト、
targetType
のインスタンス - 例外:
ConversionException
- 変換例外が発生した場合IllegalArgumentExceptionSE
- targetType がnull
、またはsourceType
がnull
であるが、ソースがnull
でない場合