org.seasar.extension.dxo.converter
インタフェース ConversionContext

既知の実装クラスの一覧:

ConversionContextImpl

public interface ConversionContext

変換中のコンテキストを表すインターフェースです。

変換コンテキストは評価済みのオブジェクトを持ちます。 評価済みのオブジェクトとは、 DxoConstants.CONVERSION_RULEアノテーションで 指定されたOGNL式の評価結果であるMapです。

作成者:

koichik

メソッドの概要

void	addConvertedObject(Object source, Object dest) 変換済みのオブジェクトを変換コンテキストに追加します。
void	addEvaluatedValue(String name, Object value) 評価済みのオブジェクトを追加します。
Object	getContextInfo(String key) コンテキスト情報からキーにマッピングされている値を返します。
Object	getConvertedObject(Object source) 変換元オブジェクトから変換済みのオブジェクトがあればそれを返します。
Converter	getConverter(Class destClass, String destPropertyName) 変換先クラスのdestPropertyNameで示されるプロパティにコンバータが指定されていれば返します。
ConverterFactory	getConverterFactory() コンバータファクトリを返します。
DateFormat	getDateFormat() コンテキスト情報から日付用のDateFormatを返します。
DateFormat	getDateFormat(String format) 現在のスレッドでフォーマット文字列を扱うDateFormatを返します。
DatePropertyInfo	getDatePropertyInfo(Class srcClass, String propertyName) 日時プロパティの情報を返します。
Object	getEvaluatedValue(String name) 名前に対応する評価済みのオブジェクトを返します。
NestedPropertyInfo	getNestedPropertyInfo(Class srcClass, String propertyName) ネストしたプロパティの情報を返します。
DateFormat	getTimeFormat() コンテキスト情報から時刻用のDateFormatを返します。
DateFormat	getTimestampFormat() コンテキスト情報から日時用のDateFormatを返します。
boolean	hasEvalueatedValue(String name) 名前に対応する評価済みのオブジェクトがあればtrueを返します。
boolean	isExcludeNull() 変換先のJavaBeansにnullの値を設定しない場合はtrueを返します。
boolean	isIncludeNull() 変換先のJavaBeansにnullの値を設定する場合はtrueを返します。

メソッドの詳細

getConverterFactory

public ConverterFactory getConverterFactory()

コンバータファクトリを返します。

戻り値:

コンバータファクトリ

getConverter

public Converter getConverter(Class destClass,
                              String destPropertyName)

変換先クラスのdestPropertyNameで示されるプロパティにコンバータが指定されていれば返します。 コンバータが指定されていない場合はnullを返します。

パラメータ:

destClass - 変換先のクラス

destPropertyName - 変換先クラスのプロパティ名

戻り値:

コンバータ

getConvertedObject

public Object getConvertedObject(Object source)

変換元オブジェクトから変換済みのオブジェクトがあればそれを返します。 変換済みのオブジェクトがない場合はnullを返します。

このメソッドは、 循環を含むオブジェクトグラフの変換で無限ループになることを防ぐために使用されます。 このメソッドがnullを返した場合は変換元の変換を行い、 変換したオブジェクトをaddConvertedObject(Object, Object)によりコンテキストに登録します。 次に同じソースオブジェクトでこのメソッドが呼び出された場合は変換済みのオブジェクトが返されます。

パラメータ:

source - 変換元のオブジェクト

戻り値:

変換済みのオブジェクト

addConvertedObject

public void addConvertedObject(Object source,
                               Object dest)

変換済みのオブジェクトを変換コンテキストに追加します。

パラメータ:

source - 変換元のオブジェクト

dest - 変換済みのオブジェクト

getContextInfo

public Object getContextInfo(String key)

コンテキスト情報からキーにマッピングされている値を返します。

パラメータ:

key - キー

戻り値:

値。キーにマッピングされている値がない場合はnull

関連項目:

DxoConstants

getDateFormat

public DateFormat getDateFormat()

コンテキスト情報から日付用のDateFormatを返します。

戻り値:

日付用のDateFormat。コンテキスト情報に日付用のフォーマットが指定されていない場合はnull

関連項目:

DxoConstants

getTimeFormat

public DateFormat getTimeFormat()

コンテキスト情報から時刻用のDateFormatを返します。

戻り値:

時刻用のDateFormat。コンテキスト情報に時刻用のフォーマットが指定されていない場合はnull

関連項目:

DxoConstants

getTimestampFormat

public DateFormat getTimestampFormat()

コンテキスト情報から日時用のDateFormatを返します。

戻り値:

日時用のDateFormat。コンテキスト情報に日時用のフォーマットが指定されていない場合はnull

関連項目:

DxoConstants

hasEvalueatedValue

public boolean hasEvalueatedValue(String name)

名前に対応する評価済みのオブジェクトがあればtrueを返します。

パラメータ:

name - 名前

戻り値:

評価済みのオブジェクトがあればtrue、そうでない場合はfalse

getEvaluatedValue

public Object getEvaluatedValue(String name)

名前に対応する評価済みのオブジェクトを返します。 評価結果がnullの場合もあります。

パラメータ:

name - 名前

戻り値:

評価済みのオブジェクト

addEvaluatedValue

public void addEvaluatedValue(String name,
                              Object value)

評価済みのオブジェクトを追加します。

パラメータ:

name - 名前

value - 評価済みのオブジェクト

isExcludeNull

public boolean isExcludeNull()

変換先のJavaBeansにnullの値を設定しない場合はtrueを返します。

この値はDxoインターフェースのDxoConstants.EXCLUDE_NULLアノテーションに trueが指定された場合にのみtrueとなります。 その場合、変換元のプロパティがnullだと変換先のプロパティには値を設定しません。

戻り値:

変換先のJavaBeansにnullの値を設定しない場合はtrue、そうでない場合はfalse

isIncludeNull

public boolean isIncludeNull()

変換先のJavaBeansにnullの値を設定する場合はtrueを返します。

この値はisExcludeNull()の否定です。

戻り値:

変換先のJavaBeansにnullの値を設定する場合はtrue、そうでない場合はfalse

getNestedPropertyInfo

public NestedPropertyInfo getNestedPropertyInfo(Class srcClass,
                                                String propertyName)

ネストしたプロパティの情報を返します。 該当するプロパティが存在しない場合はnullを返します。

パラメータ:

srcClass - 変換元のクラス

propertyName - 変換元のプロパティ名

戻り値:

ネストしたプロパティの情報

getDatePropertyInfo

public DatePropertyInfo getDatePropertyInfo(Class srcClass,
                                            String propertyName)

日時プロパティの情報を返します。 該当するプロパティが存在しない場合はnullを返します。

パラメータ:

srcClass - 変換元のクラス

propertyName - プロパティ名

戻り値:

日時プロパティの情報

getDateFormat

public DateFormat getDateFormat(String format)

現在のスレッドでフォーマット文字列を扱うDateFormatを返します。

パラメータ:

format - フォーマット文字列

戻り値:

フォーマット文字列を持つDateFormat