org.seasar.doma.copy
クラス CopyUtil

java.lang.Object
  org.seasar.doma.copy.CopyUtil

public final class CopyUtil
extends Object

コピーに関するユーティリティです。

サポートする形式

次の形式のコピーをサポートしています。

• エンティティからエンティティへのコピー
• エンティティから JavaBeans へのコピー
• エンティティから Map へのコピー
• JavaBeans からエンティティへのコピー
• JavaBeans から JavaBeans へのコピー
• JavaBeans から Map へのコピー
• Map から エンティティへのコピー
• Map から JavaBeans へのコピー

エンティティであるかどうかは、 Object が Entity のサブタイプであるかどうかで判断されます。 エンティティでない Object は、 JavaBeans とみなされます。Map はパラメータの型により自ずから Map と判定されます。

コピーの仕様

同じ名前のプロパティをコピーします。 Map は、キーがプロパティ名とみなされます。

JavaBeansへのアクセス方法

JavaBeans へのアクセス方法は、変更可能です。次の2つの手段があります。

• copy メソッドの呼び出しだけに閉じた局所的な方法。 CopyOptions.beanWrapperFactory(org.seasar.doma.bean.BeanWrapperFactory) に任意の実装を設定し、 CopyOptions オブジェクトをパラメータに copy を呼び出します。
• 全スレッドで共有するグローバルな変更方法。 BeanUtilDelegate.wrap(Object) を実装し、そのインスタンスを BeanUtil.setDelegate(org.seasar.doma.bean.BeanUtilDelegate)に設定します。

振る舞いの変更

このクラスの振る舞いは、 setDelegate(CopyUtilDelegate) に任意の実装を設定することより変更できます。

作成者:

taedium

コンストラクタの概要

CopyUtil()

メソッドの概要

static void	copy(Map<String,Object> src, Object dest) Map をオブジェクトにコピーします。
static void	copy(Map<String,Object> src, Object dest, CopyOptions copyOptions) オプションを指定してMap をオブジェクトにコピーします。
static void	copy(Object src, Map<String,Object> dest) オブジェクトを Map にコピーします。
static void	copy(Object src, Map<String,Object> dest, CopyOptions copyOptions) オプションを指定してオブジェクトを Map にコピーします。
static void	copy(Object src, Object dest) オブジェクトをコピーします。
static void	copy(Object src, Object dest, CopyOptions copyOptions) オプションを指定してオブジェクトをコピーします。
static void	setDelegate(CopyUtilDelegate delegate) 委譲先を設定します。

クラス java.lang.Object から継承されたメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

コンストラクタの詳細

CopyUtil

public CopyUtil()

メソッドの詳細

setDelegate

public static void setDelegate(CopyUtilDelegate delegate)

委譲先を設定します。

パラメータ:

delegate - 委譲先

例外:

DomaNullPointerException - delegate が null の場合

copy

public static void copy(Object src,
                        Object dest)

オブジェクトをコピーします。

次の形式のコピーを行います。

• エンティティからエンティティへのコピー
• エンティティから JavaBeans へのコピー
• JavaBeans からエンティティへのコピー
• JavaBeans から JavaBeans へのコピー

パラメータ:

src - コピー元

dest - コピー先

例外:

DomaNullPointerException - 引数のいずれかが null の場合

CopyException - コピーに失敗した場合

関連項目:

CopyUtilDelegate.copy(Object, Object, CopyOptions)

copy

public static void copy(Object src,
                        Object dest,
                        CopyOptions copyOptions)

オプションを指定してオブジェクトをコピーします。

次の形式のコピーを行います。

• エンティティからエンティティへのコピー
• エンティティから JavaBeans へのコピー
• JavaBeans からエンティティへのコピー
• JavaBeans から JavaBeans へのコピー

パラメータ:

src - コピー元

dest - コピー先

copyOptions - オプション

例外:

DomaNullPointerException - 引数のいずれかが null の場合

CopyException - コピーに失敗した場合

関連項目:

CopyUtilDelegate.copy(Object, Object, CopyOptions)

copy

public static void copy(Object src,
                        Map<String,Object> dest)

オブジェクトを Map にコピーします。

次の形式のコピーを行います。

• エンティティから Map へのコピー
• JavaBeans から Map へのコピー

パラメータ:

src - コピー元

dest - コピー先

例外:

DomaNullPointerException - 引数のいずれかが null の場合

CopyException - コピーに失敗した場合

関連項目:

CopyUtilDelegate.copy(Map, Object, CopyOptions)

copy

public static void copy(Object src,
                        Map<String,Object> dest,
                        CopyOptions copyOptions)

オプションを指定してオブジェクトを Map にコピーします。

次の形式のコピーを行います。

• エンティティから Map へのコピー
• JavaBeans から Map へのコピー

パラメータ:

src - コピー元

dest - コピー先

copyOptions - オプション

例外:

DomaNullPointerException - 引数のいずれかが null の場合

CopyException - コピーに失敗した場合

関連項目:

CopyUtilDelegate.copy(Map, Object, CopyOptions)

copy

public static void copy(Map<String,Object> src,
                        Object dest)

Map をオブジェクトにコピーします。

次の形式のコピーを行います。

• Map からエンティティへのコピー
• Map からJavaBeans へのコピー

パラメータ:

src - コピー元

dest - コピー先

例外:

DomaNullPointerException - 引数のいずれかが null の場合

CopyException - コピーに失敗した場合

関連項目:

CopyUtilDelegate.copy(Object, Map, CopyOptions)

copy

public static void copy(Map<String,Object> src,
                        Object dest,
                        CopyOptions copyOptions)

オプションを指定してMap をオブジェクトにコピーします。

次の形式のコピーを行います。

• Map からエンティティへのコピー
• Map からJavaBeans へのコピー

パラメータ:

src - コピー元

dest - コピー先

copyOptions - オプション

例外:

DomaNullPointerException - 引数のいずれかが null の場合

CopyException - コピーに失敗した場合

関連項目:

CopyUtilDelegate.copy(Object, Map, CopyOptions)