クラス ReflectionUtils
内部使用のみを目的としています。
- 導入:
- 1.2.2
- 作成者:
- Juergen Hoeller, Rob Harrop, Rod Johnson, Costin Leau, Sam Brannen, Chris Beams
-
ネストされたクラスのサマリー
ネストされたクラス修飾子と型クラス説明static interface階層内の各フィールドで呼び出されるコールバックインターフェース。static interfaceオプションでフィールドコールバックによって操作されるフィールドをフィルターするために使用されるコールバック。static interface各メソッドで実行するアクション。static interfaceオプションでメソッドコールバックによって操作されるメソッドをフィルターするために使用されるコールバック。 -
フィールドサマリー
フィールド修飾子と型フィールド説明static final ReflectionUtils.FieldFilterすべての非静的、非 final フィールドに一致する事前作成済みの FieldFilter。static final ReflectionUtils.MethodFilterjava.lang.Objectで宣言されていないすべての非ブリッジ非合成メソッドに一致するビルド済みのReflectionUtils.MethodFilter。 -
コンストラクターのサマリー
コンストラクター -
メソッドのサマリー
修飾子と型メソッド説明static <T> Constructor SE <T>accessibleConstructor( Class SE <T> clazz, Class SE <?>... parameterTypes) 指定されたクラスとパラメーターのアクセス可能なコンストラクターを取得します。static voidclearCache ()内部メソッド / フィールドキャッシュをクリアします。static booleandeclaresException( Method SE method, Class SE <?> exceptionType) 指定されたメソッドが指定された例外を明示的に宣言するか、そのスーパークラスの 1 つを明示的に宣言するかを決定します。つまり、その型の例外はリフレクション呼び出し内でそのまま伝播できます。static voiddoWithFields( Class SE <?> clazz, ReflectionUtils.FieldCallback fc) ターゲットクラスのすべてのフィールドで指定されたコールバックを呼び出し、クラス階層を上ってすべての宣言されたフィールドを取得します。static voiddoWithFields( Class SE <?> clazz, ReflectionUtils.FieldCallback fc, ReflectionUtils.FieldFilter ff) ターゲットクラスのすべてのフィールドで指定されたコールバックを呼び出し、クラス階層を上ってすべての宣言されたフィールドを取得します。static voiddoWithLocalFields( Class SE <?> clazz, ReflectionUtils.FieldCallback fc) 指定されたクラスでローカルに宣言されたすべてのフィールドで指定されたコールバックを呼び出します。static voiddoWithLocalMethods( Class SE <?> clazz, ReflectionUtils.MethodCallback mc) 指定されたクラスのすべての一致するメソッドに対して、ローカルに宣言されたメソッドまたはそれに相当するメソッド(指定されたクラスが実装する Java 8 ベースのインターフェースのデフォルトメソッドなど)で指定されたコールバック操作を実行します。static voiddoWithMethods( Class SE <?> clazz, ReflectionUtils.MethodCallback mc) 指定されたクラスとスーパークラスのすべての一致するメソッドで指定されたコールバック操作を実行します。static voiddoWithMethods( Class SE <?> clazz, ReflectionUtils.MethodCallback mc, ReflectionUtils.MethodFilter mf) 指定されたクラスとスーパークラス(または指定されたインターフェースとスーパーインターフェース)のすべての一致するメソッドで、指定されたコールバック操作を実行します。static Field SEstatic Field SEstatic Method SEfindMethod( Class SE <?> clazz, String SE name) 指定された名前でパラメーターなしで、指定されたクラスでMethodSE を見つけようとします。static Method SEfindMethod( Class SE <?> clazz, String SE name, Class SE <?>... paramTypes) 指定された名前とパラメーター型で、指定されたクラスでMethodSE を見つけようとします。static Method SE []getAllDeclaredMethods( Class SE <?> leafClass) リーフクラスおよびすべてのスーパークラスで宣言されたすべてのメソッドを取得します。static Method SE []getDeclaredMethods( Class SE <?> clazz) 新しいメソッドインスタンスを回避するためにローカルキャッシュを使用するClass.getDeclaredMethods()のバリアント。static Object SE指定されたtarget objectSE で提供されたfield objectSE によって表されるフィールドを取得します。static Method SE []getUniqueDeclaredMethods( Class SE <?> leafClass) リーフクラスおよびすべてのスーパークラスで宣言されたメソッドの一意のセットを取得します。static Method SE []getUniqueDeclaredMethods( Class SE <?> leafClass, ReflectionUtils.MethodFilter mf) リーフクラスおよびすべてのスーパークラスで宣言されたメソッドの一意のセットを取得します。static void指定された呼び出しターゲット例外を処理します。static void指定されたリフレクション例外を処理します。static Object SEinvokeMethod( Method SE method, Object SE target) 引数なしで指定されたターゲットオブジェクトに対して指定されたMethodSE を呼び出します。static Object SEinvokeMethod( Method SE method, Object SE target, Object SE ... args) 指定された引数を使用して、指定されたターゲットオブジェクトに対して指定されたMethodSE を呼び出します。static booleanisCglibRenamedMethod( Method SE renamedMethod) パターン "CGLIB$methodName$0" に従って、指定されたメソッドが CGLIB の「名前変更済み」メソッドであるかどうかを判別します。static booleanisEqualsMethod( Method SE method) 指定されたメソッドが「等しい」メソッドであるかどうかを判別します。static booleanisHashCodeMethod( Method SE method) 指定されたメソッドが "hashCode" メソッドであるかどうかを判別します。static booleanisObjectMethod( Method SE method) 指定されたメソッドが元々ObjectSE によって宣言されているかどうかを判別します。static booleanisPublicStaticFinal( Field SE field) 指定されたフィールドが "public static final" 定数かどうかを判別します。static booleanisToStringMethod( Method SE method) 指定されたメソッドが "toString" メソッドであるかどうかを判別します。static voidmakeAccessible( Constructor SE <?> ctor) 指定されたコンストラクターをアクセス可能にし、必要に応じて明示的にアクセス可能に設定します。static voidmakeAccessible( Field SE field) 指定されたフィールドをアクセス可能にし、必要に応じて明示的にアクセス可能に設定します。static voidmakeAccessible( Method SE method) 指定されたメソッドをアクセス可能にし、必要に応じて明示的にアクセス可能に設定します。static voidrethrowException( Throwable SE throwable) おそらくInvocationTargetExceptionSE の ターゲット例外 である、指定されたexceptionSE を再スローします。static voidおそらくInvocationTargetExceptionSE の ターゲット例外 である、指定されたexceptionSE を再スローします。static voidstatic voidshallowCopyFieldState( Object SE src, Object SE dest) 送信元オブジェクトと送信先(同じクラスまたはサブクラスでなければならない)を指定して、継承されたフィールドを含むすべてのフィールドをコピーします。
-
フィールドの詳細
-
USER_DECLARED_METHODS
java.lang.Objectで宣言されていないすべての非ブリッジ非合成メソッドに一致するビルド済みのReflectionUtils.MethodFilter。- 導入:
- 3.0.5
-
COPYABLE_FIELDS
すべての非静的、非 final フィールドに一致する事前作成済みの FieldFilter。
-
-
コンストラクターの詳細
-
ReflectionUtils
public ReflectionUtils ()
-
-
メソッドの詳細
-
handleReflectionException
指定されたリフレクション例外を処理します。チェックされた例外がターゲットメソッドによってスローされることが予期されていない場合、またはメソッドまたはフィールドへのアクセス中にエラーが発生した場合にのみ呼び出す必要があります。
このような根本原因を持つ InvocationTargetException の場合、基になる RuntimeException またはエラーをスローします。適切なメッセージを含む IllegalStateException またはそれ以外の場合は UndeclaredThrowableException をスローします。
- パラメーター:
-
ex- 処理するリフレクション例外
-
handleInvocationTargetException
指定された呼び出しターゲット例外を処理します。チェックされた例外がターゲットメソッドによってスローされることが予期されていない場合にのみ呼び出す必要があります。そのような根本原因の場合、基になる RuntimeException またはエラーをスローします。そうでない場合は、UndeclaredThrowableException をスローします。
- パラメーター:
-
ex- 処理する呼び出しターゲット例外
-
rethrowRuntimeException
おそらくInvocationTargetExceptionSE の ターゲット例外 である、指定されたexceptionSE を再スローします。チェックされた例外がターゲットメソッドによってスローされることが予期されていない場合にのみ呼び出す必要があります。必要に応じて、
RuntimeExceptionSE またはErrorSE への基になる例外キャストを再スローします。そうでなければ、UndeclaredThrowableExceptionSE をスローします。- パラメーター:
-
ex- 再スローの例外 - 例外:
-
RuntimeException SE- 再スローされた例外
-
rethrowException
おそらくInvocationTargetExceptionSE の ターゲット例外 である、指定されたexceptionSE を再スローします。チェックされた例外がターゲットメソッドによってスローされることが予期されていない場合にのみ呼び出す必要があります。必要に応じて、基になる例外を
ExceptionSE またはErrorSE にキャストし直します。そうでなければ、UndeclaredThrowableExceptionSE をスローします。- パラメーター:
-
throwable- 再スローの例外 - 例外:
-
Exception SE- 再スローされた例外 (チェック済み例外の場合)
-
accessibleConstructor
public static <T> Constructor SE <T> accessibleConstructor( Class SE <T> clazz, Class SE <?>... parameterTypes) throws NoSuchMethodException SE 指定されたクラスとパラメーターのアクセス可能なコンストラクターを取得します。- パラメーター:
-
clazz- チェックするクラズ -
parameterTypes- 目的のコンストラクターのパラメーター型 - 戻り値:
- コンストラクター参照
- 例外:
-
NoSuchMethodException SE- そのようなコンストラクターが存在しない場合 - 導入:
- 5.0
-
makeAccessible
指定されたコンストラクターをアクセス可能にし、必要に応じて明示的にアクセス可能に設定します。setAccessible(true)メソッドは、不必要な競合を避けるために、実際に必要な場合にのみ呼び出されます。- パラメーター:
-
ctor- アクセス可能にするコンストラクター - 関連事項:
-
findMethod
指定された名前でパラメーターなしで、指定されたクラスでMethodSE を見つけようとします。Objectまでのすべてのスーパークラスを検索します。MethodSE が見つからない場合、nullを返します。- パラメーター:
-
clazz- 内省するクラス -
name- メソッドの名前 - 戻り値:
-
Method オブジェクト。見つからない場合は
null
-
findMethod
@Nullable public static Method SE findMethod( Class SE <?> clazz, String SE name, @Nullable Class SE <?>... paramTypes) 指定された名前とパラメーター型で、指定されたクラスでMethodSE を見つけようとします。Objectまでのすべてのスーパークラスを検索します。MethodSE が見つからない場合、nullを返します。- パラメーター:
-
clazz- 内省するクラス -
name- メソッドの名前 -
paramTypes- メソッドのパラメーター型 (署名を示すnullの場合があります) - 戻り値:
-
Method オブジェクト。見つからない場合は
null
-
invokeMethod
引数なしで指定されたターゲットオブジェクトに対して指定されたMethodSE を呼び出します。静的MethodSE を呼び出す場合、ターゲットオブジェクトはnullになります。スローされた例外は、
handleReflectionException(java.lang.Exception)の呼び出しを介して処理されます。- パラメーター:
-
method- 呼び出すメソッド -
target- メソッドを呼び出すターゲットオブジェクト - 戻り値:
- 呼び出し結果(ある場合)
- 関連事項:
-
invokeMethod
@Nullable public static Object SE invokeMethod( Method SE method, @Nullable Object SE target, @Nullable Object SE ... args) 指定された引数を使用して、指定されたターゲットオブジェクトに対して指定されたMethodSE を呼び出します。静的MethodSE を呼び出す場合、ターゲットオブジェクトはnullになります。スローされた例外は、
handleReflectionException(java.lang.Exception)の呼び出しを介して処理されます。- パラメーター:
-
method- 呼び出すメソッド -
target- メソッドを呼び出すターゲットオブジェクト -
args- 呼び出し引数 (nullの場合があります) - 戻り値:
- 呼び出し結果(ある場合)
-
declaresException
指定されたメソッドが指定された例外を明示的に宣言するか、そのスーパークラスの 1 つを明示的に宣言するかを決定します。つまり、その型の例外はリフレクション呼び出し内でそのまま伝播できます。- パラメーター:
-
method- 宣言メソッド -
exceptionType- スローする例外 - 戻り値:
-
例外をそのままスローできる場合は
true。false(ラップする必要がある場合)
-
doWithLocalMethods
指定されたクラスのすべての一致するメソッドに対して、ローカルに宣言されたメソッドまたはそれに相当するメソッド(指定されたクラスが実装する Java 8 ベースのインターフェースのデフォルトメソッドなど)で指定されたコールバック操作を実行します。- パラメーター:
-
clazz- 内省するクラス -
mc- 各メソッドに対して呼び出すコールバック - 例外:
-
IllegalStateException SE- イントロスペクションが失敗した場合 - 導入:
- 4.2
- 関連事項:
-
doWithMethods
指定されたクラスとスーパークラスのすべての一致するメソッドで指定されたコールバック操作を実行します。ReflectionUtils.MethodFilterによって除外されない限り、サブクラスとスーパークラスで発生する同じ名前のメソッドが 2 回表示されます。- パラメーター:
-
clazz- 内省するクラス -
mc- 各メソッドに対して呼び出すコールバック - 例外:
-
IllegalStateException SE- イントロスペクションが失敗した場合 - 関連事項:
-
doWithMethods
public static void doWithMethods( Class SE <?> clazz, ReflectionUtils.MethodCallback mc, @Nullable ReflectionUtils.MethodFilter mf) 指定されたクラスとスーパークラス(または指定されたインターフェースとスーパーインターフェース)のすべての一致するメソッドで、指定されたコールバック操作を実行します。指定された
ReflectionUtils.MethodFilterによって除外されない限り、サブクラスとスーパークラスで発生する同じ名前のメソッドが 2 回表示されます。- パラメーター:
-
clazz- 内省するクラス -
mc- 各メソッドに対して呼び出すコールバック -
mf- コールバックを適用するメソッドを決定するフィルター - 例外:
-
IllegalStateException SE- イントロスペクションが失敗した場合
-
getAllDeclaredMethods
リーフクラスおよびすべてのスーパークラスで宣言されたすべてのメソッドを取得します。リーフクラスメソッドが最初に含まれます。- パラメーター:
-
leafClass- 内省するクラス - 例外:
-
IllegalStateException SE- イントロスペクションが失敗した場合
-
getUniqueDeclaredMethods
リーフクラスおよびすべてのスーパークラスで宣言されたメソッドの一意のセットを取得します。リーフクラスメソッドが最初に含まれ、スーパークラス階層を走査するときに、すでに含まれているメソッドと一致するシグネチャーで見つかったメソッドはすべて除外されます。- パラメーター:
-
leafClass- 内省するクラス - 例外:
-
IllegalStateException SE- イントロスペクションが失敗した場合
-
getUniqueDeclaredMethods
public static Method SE [] getUniqueDeclaredMethods( Class SE <?> leafClass, @Nullable ReflectionUtils.MethodFilter mf) リーフクラスおよびすべてのスーパークラスで宣言されたメソッドの一意のセットを取得します。リーフクラスメソッドが最初に含まれ、スーパークラス階層を走査するときに、すでに含まれているメソッドと一致するシグネチャーで見つかったメソッドはすべて除外されます。- パラメーター:
-
leafClass- 内省するクラス -
mf- 考慮する方法を決定するフィルター - 例外:
-
IllegalStateException SE- イントロスペクションが失敗した場合 - 導入:
- 5.2
-
getDeclaredMethods
新しいメソッドインスタンスを回避するためにローカルキャッシュを使用するClass.getDeclaredMethods()のバリアント。さらに、ローカルに実装されたインターフェースからの Java 8 デフォルトメソッドも含まれています。- パラメーター:
-
clazz- 内省するクラス - 戻り値:
- メソッドのキャッシュされた配列
- 例外:
-
IllegalStateException SE- イントロスペクションが失敗した場合 - 導入:
- 5.2
- 関連事項:
-
isEqualsMethod
指定されたメソッドが「等しい」メソッドであるかどうかを判別します。- 関連事項:
-
isHashCodeMethod
指定されたメソッドが "hashCode" メソッドであるかどうかを判別します。- 関連事項:
-
isToStringMethod
指定されたメソッドが "toString" メソッドであるかどうかを判別します。- 関連事項:
-
isObjectMethod
指定されたメソッドが元々ObjectSE によって宣言されているかどうかを判別します。 -
isCglibRenamedMethod
パターン "CGLIB$methodName$0" に従って、指定されたメソッドが CGLIB の「名前変更済み」メソッドであるかどうかを判別します。- パラメーター:
-
renamedMethod- チェックする方法
-
makeAccessible
指定されたメソッドをアクセス可能にし、必要に応じて明示的にアクセス可能に設定します。setAccessible(true)メソッドは、不必要な競合を避けるために、実際に必要な場合にのみ呼び出されます。- パラメーター:
-
method- アクセス可能にする方法 - 関連事項:
-
findField
- パラメーター:
-
clazz- 内省するクラス -
name- フィールドの名前 - 戻り値:
-
対応する Field オブジェクト、または見つからない場合は
null
-
findField
@Nullable public static Field SE findField( Class SE <?> clazz, @Nullable String SE name, @Nullable Class SE <?> type) 提供されたnameおよび / またはtypeSE を使用して、提供されたClassSE でfieldSE を見つけようとします。ObjectSE までのすべてのスーパークラスを検索します。- パラメーター:
-
clazz- 内省するクラス -
name- フィールドの名前 (型が指定されている場合、nullになる場合があります) -
type- フィールドの型 (名前が指定されている場合はnullになる場合があります) - 戻り値:
-
対応する Field オブジェクト、または見つからない場合は
null
-
setField
public static void setField( Field SE field, @Nullable Object SE target, @Nullable Object SE value) 指定された ターゲットオブジェクト SE 上の指定された フィールドオブジェクト SE によって表されるフィールドを、指定されたvalueに設定します。Field.set(Object, Object)SE のセマンティクスに従って、基礎となるフィールドにプリミティブ型がある場合、新しい値は自動的にラップ解除されます。このメソッドは、
static finalフィールドの設定をサポートしていません。スローされた例外は、
handleReflectionException(Exception)の呼び出しを介して処理されます。- パラメーター:
-
field- 設定するフィールド -
target- フィールドを設定する対象オブジェクト (または静的フィールドの場合はnull) -
value- 設定する値 (nullの場合があります)
-
getField
指定されたtarget objectSE で提供されたfield objectSE によって表されるフィールドを取得します。Field.get(Object)SE のセマンティクスに従って、基になるフィールドにプリミティブ型がある場合、戻り値は自動的にラップされます。スローされた例外は、
handleReflectionException(Exception)の呼び出しを介して処理されます。- パラメーター:
-
field- 取得するフィールド -
target- フィールドを取得するターゲットオブジェクト (または静的フィールドの場合はnull) - 戻り値:
- フィールドの現在の値
-
doWithLocalFields
-