compact1、compact2、compact3

java.lang.reflect

クラスAccessibleObject

java.lang.Object

java.lang.reflect.AccessibleObject

すべての実装されたインタフェース:

AnnotatedElement

直系の既知のサブクラス:

Executable, Field

public class AccessibleObject
extends Object
implements AnnotatedElement

AccessibleObjectクラスは、Fieldオブジェクト、Methodオブジェクト、およびConstructorオブジェクトの基底クラスです。このクラスを使うと、リフレクトされたオブジェクトの使用時に、デフォルトのJava言語アクセス制御チェックを抑制するかどうかのフラグ設定を行えます。アクセス・チェックは、次の場合にpublic、デフォルト(package)アクセス、protected、およびprivateメンバーに対して実行されます。つまり、フィールドの設定または取得にFieldが使用される場合、メソッドの呼出しにMethodが使用される場合、あるいはクラスの新しいインスタンスの生成および初期化にConstructorが使用される場合です。

リフレクトされたオブジェクトでaccessibleフラグを設定すると、十分な特権を持つ高度なアプリケーション(Javaのオブジェクトの直列化やその他の持続性メカニズムなど)は、通常は禁止されている方法でオブジェクトを操作できます。

デフォルトでは、リフレクトされたオブジェクトはアクセス可能ではありません。

導入されたバージョン:

1.2

関連項目:

Field, Method, Constructor, ReflectPermission

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

コンストラクタ

修飾子	コンストラクタと説明
protected	AccessibleObject() コンストラクタで、Java仮想マシン(JVM)だけが使用します。

メソッドのサマリー

修飾子と型	メソッドと説明
<T extends Annotation> T	getAnnotation(Class<T> annotationClass) 存在する場合は、この要素の指定された型の注釈を返し、そうでない場合はnullを返します。
Annotation[]	getAnnotations() この要素に存在する注釈を返します。
<T extends Annotation> T[]	getAnnotationsByType(Class<T> annotationClass) この要素に関連付けられている注釈を返します。
<T extends Annotation> T	getDeclaredAnnotation(Class<T> annotationClass) 直接存在する場合は、この要素の指定された型の注釈を返し、そうでない場合はnullを返します。
Annotation[]	getDeclaredAnnotations() この要素に直接存在する注釈を返します。
<T extends Annotation> T[]	getDeclaredAnnotationsByType(Class<T> annotationClass) 直接存在するか間接的に存在する場合は、この要素の指定された型の注釈を返します。
boolean	isAccessible() このオブジェクトのaccessibleフラグの値を取得します。
boolean	isAnnotationPresent(Class<? extends Annotation> annotationClass) 指定された型の注釈がこの要素に存在する場合はtrueを返し、そうでない場合はfalseを返します。
static void	setAccessible(AccessibleObject[] array, boolean flag) 効率を良くするために、単一のセキュリティ・チェックにより、オブジェクトの配列のaccessibleフラグを設定する簡易メソッドです。
void	setAccessible(boolean flag) このオブジェクトのaccessibleフラグを、指定されたboolean値に設定します。

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

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

コンストラクタの詳細

AccessibleObject

protected AccessibleObject()

コンストラクタで、Java仮想マシン(JVM)だけが使用します。

メソッドの詳細

setAccessible

public static void setAccessible(AccessibleObject[] array,
                                 boolean flag)
                          throws SecurityException

効率を良くするために、単一のセキュリティ・チェックにより、オブジェクトの配列のaccessibleフラグを設定する簡易メソッドです。

まず、セキュリティ・マネージャが存在する場合は、そのcheckPermissionメソッドがReflectPermission("suppressAccessChecks")アクセス権で呼び出されます。

flagがtrueの場合、SecurityExceptionがスローされますが、入力arrayの要素のアクセス可能性は変わらないことがあります(たとえば、要素オブジェクトがClassクラスのConstructorオブジェクトである場合)。このようなSecurityExceptionのイベントの場合、オブジェクトへのアクセス可能性は、例外が生じた要素の直前までの配列要素についてはflagに設定されます。例外が生じた要素以降の要素へのアクセシビリティは変更されません。

パラメータ:

array - AccessibleObjectの配列

flag - 各オブジェクトのaccessibleフラグの新しい値

例外:

SecurityException - 要求が拒否された場合。

関連項目:

SecurityManager.checkPermission(java.security.Permission), RuntimePermission

setAccessible

public void setAccessible(boolean flag)
                   throws SecurityException

このオブジェクトのaccessibleフラグを、指定されたboolean値に設定します。値trueは、リフレクトされたオブジェクトの使用時に、Java言語アクセス・チェックが抑制されることを示します。値falseは、リフレクトされたオブジェクトがJava言語アクセス・チェックを実施することを示します。

まず、セキュリティ・マネージャが存在する場合は、そのcheckPermissionメソッドがReflectPermission("suppressAccessChecks")アクセス権で呼び出されます。

flagがtrueの場合、SecurityExceptionがスローされますが、このオブジェクトのアクセス可能性は変わらないことがあります(たとえば、この要素オブジェクトがClassクラスのConstructorオブジェクトである場合)。

このオブジェクトがjava.lang.ClassクラスのConstructorオブジェクトであり、flagがtrueである場合、SecurityExceptionがスローされます。

パラメータ:

flag - accessibleフラグの新しい値

例外:

SecurityException - 要求が拒否された場合。

関連項目:

SecurityManager.checkPermission(java.security.Permission), RuntimePermission

isAccessible

public boolean isAccessible()

このオブジェクトのaccessibleフラグの値を取得します。

戻り値:

オブジェクトのaccessibleフラグの値

getAnnotation

public <T extends Annotation> T getAnnotation(Class<T> annotationClass)

インタフェースからコピーされた説明: AnnotatedElement

存在する場合は、この要素の指定された型の注釈を返し、そうでない場合はnullを返します。

定義:

getAnnotation、インタフェース: AnnotatedElement

型パラメータ:

T - 照会し、存在する場合に返す注釈の型。

パラメータ:

annotationClass - 注釈型に対応するClassオブジェクト

戻り値:

存在する場合は、この要素の指定された注釈型の注釈。そうでない場合はnull

例外:

NullPointerException - 指定された注釈クラスがnullの場合

導入されたバージョン:

1.5

isAnnotationPresent

public boolean isAnnotationPresent(Class<? extends Annotation> annotationClass)

指定された型の注釈がこの要素に存在する場合はtrueを返し、そうでない場合はfalseを返します。このメソッドは、主にマーカー注釈への簡易アクセスを目的に設計されています。

このメソッドによって返されるtrue値は、getAnnotation(annotationClass) != nullと同等です。

デフォルト・メソッドの本体は、前述のコードとして指定されています。

定義:

isAnnotationPresent、インタフェース: AnnotatedElement

パラメータ:

annotationClass - 注釈型に対応するClassオブジェクト

戻り値:

指定された注釈型の注釈がこの要素に存在する場合はtrue、そうでない場合はfalse

例外:

NullPointerException - 指定された注釈クラスがnullの場合

導入されたバージョン:

1.5

getAnnotationsByType

public <T extends Annotation> T[] getAnnotationsByType(Class<T> annotationClass)

インタフェースからコピーされた説明: AnnotatedElement

この要素に関連付けられている注釈を返します。この要素に関連付けられている注釈がない場合、戻り値は長さ0の配列です。このメソッドとAnnotatedElement.getAnnotation(Class)の違いは、このメソッドではその引数が繰返し可能な注釈型 (JLS 9.6)であるかどうかが検出され、繰返し可能な注釈型である場合は、コンテナ注釈を調べることで、その型の1つ以上の注釈の検索が試みられることです。このメソッドの呼出し元は、返された配列を自由に変更することができ、これはほかの呼出し元に返された配列に影響を及ぼしません。

定義:

getAnnotationsByType、インタフェース: AnnotatedElement

型パラメータ:

T - 照会し、存在する場合に返す注釈の型。

パラメータ:

annotationClass - 注釈型に対応するClassオブジェクト

戻り値:

この要素に関連付けられている場合は、この要素の指定された注釈型のすべての注釈。そうでない場合は長さ0の配列

例外:

NullPointerException - 指定された注釈クラスがnullの場合

導入されたバージョン:

1.8

getAnnotations

public Annotation[] getAnnotations()

インタフェースからコピーされた説明: AnnotatedElement

この要素に存在する注釈を返します。この要素に存在する注釈がない場合、戻り値は長さ0の配列です。このメソッドの呼出し元は、返された配列を自由に変更することができ、これはほかの呼出し元に返された配列に影響を及ぼしません。

定義:

getAnnotations、インタフェース: AnnotatedElement

戻り値:

この要素に存在する注釈

導入されたバージョン:

1.5

getDeclaredAnnotation

public <T extends Annotation> T getDeclaredAnnotation(Class<T> annotationClass)

インタフェースからコピーされた説明: AnnotatedElement

直接存在する場合は、この要素の指定された型の注釈を返し、そうでない場合はnullを返します。このメソッドは継承された注釈を無視します。(この要素に直接存在する注釈がない場合は、nullを返します。)

定義:

getDeclaredAnnotation、インタフェース: AnnotatedElement

型パラメータ:

T - 照会し、直接存在する場合に返す注釈の型。

パラメータ:

annotationClass - 注釈型に対応するClassオブジェクト

戻り値:

直接存在する場合は、この要素の指定された注釈型の注釈。そうでない場合はnull

例外:

NullPointerException - 指定された注釈クラスがnullの場合

導入されたバージョン:

1.8

getDeclaredAnnotationsByType

public <T extends Annotation> T[] getDeclaredAnnotationsByType(Class<T> annotationClass)

インタフェースからコピーされた説明: AnnotatedElement

直接存在するか間接的に存在する場合は、この要素の指定された型の注釈を返します。このメソッドは継承された注釈を無視します。この要素に直接または間接的に存在する指定された注釈がない場合、戻り値は長さ0の配列です。このメソッドとAnnotatedElement.getDeclaredAnnotation(Class)の違いは、このメソッドではその引数が繰返し可能な注釈型 (JLS 9.6)であるかどうかが検出され、繰返し可能な注釈型である場合は、コンテナ注釈(存在する場合)を調べることで、その型の1つ以上の注釈の検索が試みられることです。このメソッドの呼出し元は、返された配列を自由に変更することができ、これはほかの呼出し元に返された配列に影響を及ぼしません。

定義:

getDeclaredAnnotationsByType、インタフェース: AnnotatedElement

型パラメータ:

T - 照会し、直接または間接的に存在する場合に返す注釈の型。

パラメータ:

annotationClass - 注釈型に対応するClassオブジェクト

戻り値:

この要素に直接または間接的に存在する場合は、この要素の指定された注釈型のすべての注釈。そうでない場合は長さ0の配列

例外:

NullPointerException - 指定された注釈クラスがnullの場合

導入されたバージョン:

1.8

getDeclaredAnnotations

public Annotation[] getDeclaredAnnotations()

インタフェースからコピーされた説明: AnnotatedElement

この要素に直接存在する注釈を返します。このメソッドは継承された注釈を無視します。この要素に直接存在する注釈がない場合、戻り値は長さ0の配列です。このメソッドの呼出し元は、返された配列を自由に変更することができ、これはほかの呼出し元に返された配列に影響を及ぼしません。

定義:

getDeclaredAnnotations、インタフェース: AnnotatedElement

戻り値:

この要素に直接存在する注釈

導入されたバージョン:

1.5