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()
          コンバータファクトリを返します。
 DatePropertyInfo getDatePropertyInfo(Class srcClass, String propertyName)
          日時プロパティの情報を返します。
 Object getEvaluatedValue(String name)
          名前に対応する評価済みのオブジェクトを返します。
 NestedPropertyInfo getNestedProertyInfo(Class srcClass, String propertyName)
          ネストしたプロパティの情報を返します。
 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 - キー
戻り値:
関連項目:
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

getNestedProertyInfo

public NestedPropertyInfo getNestedProertyInfo(Class srcClass,
                                               String propertyName)
ネストしたプロパティの情報を返します。 該当するプロパティが存在しない場合はnullを返します。

パラメータ:
srcClass - 変換元のクラス
propertyName - 変換元のプロパティ名
戻り値:
ネストしたプロパティの情報

getDatePropertyInfo

public DatePropertyInfo getDatePropertyInfo(Class srcClass,
                                            String propertyName)
日時プロパティの情報を返します。 該当するプロパティが存在しない場合はnullを返します。

パラメータ:
srcClass - 変換元のクラス
propertyName - プロパティ名
戻り値:
日時プロパティの情報


Copyright © 2004-2007 The Seasar Foundation. All Rights Reserved.