java.lang.reflect

クラス AccessibleObject

java.lang.Object

java.lang.reflect.AccessibleObject

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

AnnotatedElement

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

Constructor、Field、Method

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() この要素に存在するすべての注釈を返します。
Annotation[]	getDeclaredAnnotations() この要素に直接存在するすべての注釈を返します。
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

パラメータ:

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

戻り値:

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

例外:

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

導入されたバージョン:

1.5

isAnnotationPresent

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

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

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

定義:

isAnnotationPresent、インタフェース: AnnotatedElement

パラメータ:

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

戻り値:

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

例外:

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

導入されたバージョン:

1.5

getAnnotations

public Annotation[] getAnnotations()

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

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

定義:

getAnnotations、インタフェース: AnnotatedElement

戻り値:

この要素に存在するすべての注釈

導入されたバージョン:

1.5

getDeclaredAnnotations

public Annotation[] getDeclaredAnnotations()

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

この要素に直接存在するすべての注釈を返します。このインタフェースにあるほかのメソッドとは異なり、このメソッドは継承された注釈を無視します。(この要素に注釈が直接存在しない場合は長さゼロの配列を返します。) このメソッドの呼び出し元は、返された配列を自由に変更することができ、これはほかの呼び出し元に返された配列に影響を及ぼしません。

定義:

getDeclaredAnnotations、インタフェース: AnnotatedElement

戻り値:

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

導入されたバージョン:

1.5