oscana.s2n.seasar.framework.util.tiger

クラス ReflectionUtil

java.lang.Object

oscana.s2n.seasar.framework.util.tiger.ReflectionUtil

public abstract class ReflectionUtil
extends Object

Java5のgenericsや可変長を活用する、リフレクションのためのユーティリティクラス。

作成者:

koichik

コンストラクタのサマリー

コンストラクタ

修飾子	コンストラクタと説明
protected	ReflectionUtil() インスタンスを構築する。

メソッドのサマリー

修飾子とタイプ	メソッドと説明
static <T> Class<T>	forName(String className) 現在のスレッドのコンテキストクラスローダを使って、 指定された文字列名を持つクラスまたはインタフェースに関連付けられた、 Classオブジェクトを返却する。
static <T> Class<T>	forName(String className, ClassLoader loader) 指定されたクラスローダを使って、 指定された文字列名を持つクラスまたはインタフェースに関連付けられたClassオブジェクトを返却する。
static <T> Class<T>	forNameNoException(String className) 現在のスレッドのコンテキストクラスローダを使って、 指定された文字列名を持つクラスまたはインタフェースに関連付けられた、 Classオブジェクトを返却する。
static <T> Class<T>	forNameNoException(String className, ClassLoader loader) 指定されたクラスローダを使って、 指定された文字列名を持つクラスまたはインタフェースに関連付けられた、 Classオブジェクトを返却する。
static <T> Constructor<T>	getConstructor(Class<T> clazz, Class<?>... argTypes) Classオブジェクトが表すクラスの指定されたpublicコンストラクタをリフレクトするConstructorオブジェクトを返却する。
static <T> Constructor<T>	getDeclaredConstructor(Class<T> clazz, Class<?>... argTypes) Classオブジェクトが表すクラスまたはインタフェースの指定されたコンストラクタをリフレクトするConstructorオブジェクトを返却する。
static Field	getDeclaredField(Class<?> clazz, String name) Classオブジェクトが表すクラスまたはインタフェースの指定された宣言フィールドをリフレクトするFieldオブジェクトを返却する。
static Method	getDeclaredMethod(Class<?> clazz, String name, Class<?>... argTypes) Classオブジェクトが表すクラスまたはインタフェースの指定されたメンバメソッドをリフレクトするMethodオブジェクトを返却する。
static Field	getField(Class<?> clazz, String name) Classオブジェクトが表すクラスまたはインタフェースの指定されたpublicメンバフィールドをリフレクトするFieldオブジェクトを返却する。
static Method	getMethod(Class<?> clazz, String name, Class<?>... argTypes) Classオブジェクトが表すクラスまたはインタフェースの指定されたpublicメンバメソッドをリフレクトするMethodオブジェクトを返却する。
static <T> T	getStaticValue(Field field) 指定されたオブジェクトについて、Fieldによって表されるstaticフィールドの値を返却する。
static <T> T	getValue(Field field, Object target) 指定されたオブジェクトについて、Fieldによって表されるフィールドの値を返却する。
static <T> T	invoke(Method method, Object target, Object... args) Methodオブジェクトによって表される基本となるメソッドを、指定したオブジェクトに対して指定したパラメータの処理を行う。
static <T> T	invokeStatic(Method method, Object... args) Methodオブジェクトによって表される基本となるstaticメソッドを、指定したパラメータの処理を行う。
static <T> T	newInstance(Class<T> clazz) 指定されたクラスのデフォルトコンストラクタで、クラスの新しいインスタンスを作成および初期化する。
static <T> T	newInstance(Constructor<T> constructor, Object... args) 指定された初期化パラメータで、コンストラクタの宣言クラスの新しいインスタンスを作成および初期化する。
static void	setStaticValue(Field field, Object value) Fieldオブジェクトによって表されるstaticフィールドを、指定された新しい値に設定する。
static void	setValue(Field field, Object target, Object value) Fieldオブジェクトによって表される指定されたオブジェクト引数のフィールドを、指定された新しい値に設定する。

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

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

コンストラクタの詳細

ReflectionUtil

protected ReflectionUtil()

インスタンスを構築する。

メソッドの詳細

forName

public static <T> Class<T> forName(String className)

現在のスレッドのコンテキストクラスローダを使って、 指定された文字列名を持つクラスまたはインタフェースに関連付けられた、 Classオブジェクトを返却する。

型パラメータ:

T - Classオブジェクトが表すクラス

パラメータ:

className - 要求するクラスの完全修飾名

戻り値:

指定された名前を持つクラスのClassオブジェクト

関連項目:

Class.forName(String)

forName

public static <T> Class<T> forName(String className,
                                   ClassLoader loader)

指定されたクラスローダを使って、 指定された文字列名を持つクラスまたはインタフェースに関連付けられたClassオブジェクトを返却する。

型パラメータ:

T - Classオブジェクトが表すクラス

パラメータ:

className - 要求するクラスの完全修飾名

loader - クラスのロード元である必要があるクラスローダ

戻り値:

指定された名前を持つクラスのClassオブジェクト

関連項目:

Class.forName(String, boolean, ClassLoader)

forNameNoException

public static <T> Class<T> forNameNoException(String className)

現在のスレッドのコンテキストクラスローダを使って、 指定された文字列名を持つクラスまたはインタフェースに関連付けられた、 Classオブジェクトを返却する。

クラスが見つからなかった場合はnullを返却する。

型パラメータ:

T - Classオブジェクトが表すクラス

パラメータ:

className - 要求するクラスの完全修飾名

戻り値:

指定された名前を持つクラスのClassオブジェクト

関連項目:

Class.forName(String)

forNameNoException

public static <T> Class<T> forNameNoException(String className,
                                              ClassLoader loader)

指定されたクラスローダを使って、 指定された文字列名を持つクラスまたはインタフェースに関連付けられた、 Classオブジェクトを返却する。

クラスが見つからなかった場合はnullを返却する。

型パラメータ:

T - Classオブジェクトが表すクラス

パラメータ:

className - 要求するクラスの完全修飾名

loader - クラスのロード元である必要があるクラスローダ

戻り値:

指定された名前を持つクラスのClassオブジェクト

関連項目:

Class.forName(String)

getConstructor

public static <T> Constructor<T> getConstructor(Class<T> clazz,
                                                Class<?>... argTypes)

Classオブジェクトが表すクラスの指定されたpublicコンストラクタをリフレクトするConstructorオブジェクトを返却する。

型パラメータ:

T - Classオブジェクトが表すクラス

パラメータ:

clazz - クラスのClassオブジェクト

argTypes - パラメータ配列

戻り値:

指定されたargTypesと一致するpublicコンストラクタのConstructorオブジェクト

関連項目:

Class.getConstructor(Class[])

getDeclaredConstructor

public static <T> Constructor<T> getDeclaredConstructor(Class<T> clazz,
                                                        Class<?>... argTypes)

Classオブジェクトが表すクラスまたはインタフェースの指定されたコンストラクタをリフレクトするConstructorオブジェクトを返却する。

型パラメータ:

T - Classオブジェクトが表すクラス

パラメータ:

clazz - クラスのClassオブジェクト

argTypes - パラメータ配列

戻り値:

指定されたargTypesと一致するコンストラクタのConstructorオブジェクト

関連項目:

Class.getDeclaredConstructor(Class[])

getField

public static Field getField(Class<?> clazz,
                             String name)

Classオブジェクトが表すクラスまたはインタフェースの指定されたpublicメンバフィールドをリフレクトするFieldオブジェクトを返却する。

パラメータ:

clazz - クラスのClassオブジェクト

name - フィールド名

戻り値:

nameで指定されたこのクラスのFieldオブジェクト

関連項目:

Class.getField(String)

getDeclaredField

public static Field getDeclaredField(Class<?> clazz,
                                     String name)

Classオブジェクトが表すクラスまたはインタフェースの指定された宣言フィールドをリフレクトするFieldオブジェクトを返却する。

パラメータ:

clazz - クラスのClassオブジェクト

name - フィールド名

戻り値:

nameで指定されたこのクラスのFieldオブジェクト

関連項目:

Class.getDeclaredField(String)

getMethod

public static Method getMethod(Class<?> clazz,
                               String name,
                               Class<?>... argTypes)

Classオブジェクトが表すクラスまたはインタフェースの指定されたpublicメンバメソッドをリフレクトするMethodオブジェクトを返却する。

パラメータ:

clazz - クラスのClassオブジェクト

name - メソッドの名前

argTypes - パラメータのリスト

戻り値:

指定されたnameおよびargTypesと一致するMethodオブジェクト

関連項目:

Class.getMethod(String, Class[])

getDeclaredMethod

public static Method getDeclaredMethod(Class<?> clazz,
                                       String name,
                                       Class<?>... argTypes)

Classオブジェクトが表すクラスまたはインタフェースの指定されたメンバメソッドをリフレクトするMethodオブジェクトを返却する。

パラメータ:

clazz - クラスのClassオブジェクト

name - メソッドの名前

argTypes - パラメータのリスト

戻り値:

指定されたnameおよびargTypesと一致するMethodオブジェクト

関連項目:

Class.getDeclaredMethod(String, Class[])

newInstance

public static <T> T newInstance(Class<T> clazz)

指定されたクラスのデフォルトコンストラクタで、クラスの新しいインスタンスを作成および初期化する。

型パラメータ:

T - Classオブジェクトが表すクラス

パラメータ:

clazz - クラスを表すClassオブジェクト

戻り値:

このオブジェクトが表すコンストラクタを呼び出すことで作成される新規オブジェクト

関連項目:

Constructor.newInstance(Object[])

newInstance

public static <T> T newInstance(Constructor<T> constructor,
                                Object... args)

指定された初期化パラメータで、コンストラクタの宣言クラスの新しいインスタンスを作成および初期化する。

型パラメータ:

T - コンストラクタの宣言クラス

パラメータ:

constructor - コンストラクタ

args - コンストラクタ呼び出しに引数として渡すオブジェクトの配列

戻り値:

コンストラクタを呼び出すことで作成される新規オブジェクト

関連項目:

Constructor.newInstance(Object[])

getValue

public static <T> T getValue(Field field,
                             Object target)

指定されたオブジェクトについて、Fieldによって表されるフィールドの値を返却する。

型パラメータ:

T - フィールドの型

パラメータ:

field - フィールド

target - 表現されるフィールド値の抽出元オブジェクト

戻り値:

オブジェクトobj内で表現される値

関連項目:

Field.get(Object)

getStaticValue

public static <T> T getStaticValue(Field field)

指定されたオブジェクトについて、Fieldによって表されるstaticフィールドの値を返却する。

型パラメータ:

T - フィールドの型

パラメータ:

field - フィールド

戻り値:

staticフィールドで表現される値

関連項目:

Field.get(Object)

setValue

public static void setValue(Field field,
                            Object target,
                            Object value)

Fieldオブジェクトによって表される指定されたオブジェクト引数のフィールドを、指定された新しい値に設定する。

パラメータ:

field - フィールド

target - フィールドを変更するオブジェクト

value - 変更中のtargetの新しいフィールド値

関連項目:

Field.set(Object, Object)

setStaticValue

public static void setStaticValue(Field field,
                                  Object value)

Fieldオブジェクトによって表されるstaticフィールドを、指定された新しい値に設定する。

パラメータ:

field - フィールド

value - staticフィールドの新しい値

関連項目:

Field.set(Object, Object)

invoke

public static <T> T invoke(Method method,
                           Object target,
                           Object... args)

Methodオブジェクトによって表される基本となるメソッドを、指定したオブジェクトに対して指定したパラメータの処理を行う。

型パラメータ:

T - メソッドの戻り値の型

パラメータ:

method - メソッド

target - 基本となるメソッドの呼び出し元のオブジェクト

args - メソッド呼び出しに使用される引数

戻り値:

このオブジェクトが表すメソッドを、パラメータargsを使用してobjにディスパッチした結果

関連項目:

Method.invoke(Object, Object[])

invokeStatic

public static <T> T invokeStatic(Method method,
                                 Object... args)

Methodオブジェクトによって表される基本となるstaticメソッドを、指定したパラメータの処理を行う。

型パラメータ:

T - メソッドの戻り値の型

パラメータ:

method - メソッド

args - メソッド呼び出しに使用される引数

戻り値:

このオブジェクトが表すstaticメソッドを、パラメータargsを使用してディスパッチした結果

関連項目:

Method.invoke(Object, Object[])