- すべての実装されたインタフェース:
AnnotatedElement
- 直系の既知のサブクラス:
Executable
,Field
AccessibleObject
クラスは、Field
、Method
、およびConstructor
オブジェクト(「リフレクトされたオブジェクト」と呼ばれる)の基本クラスです。 それは、Java言語のアクセス制御が使用されているときの抑制チェックとして、リフレクトされたオブジェクトにフラグを立てる機能を提供します。 これにより、通常は禁止されるような方法でオブジェクトを操作するのに十分な特権を持つ洗練されたアプリケーション(Java Object Serializationやその他の永続化メカニズムなど)が可能になります。
Java言語アクセス制御では、トップレベル・クラス外部のプライベート・メンバー、パッケージ・アクセス外部のメンバー、パッケージまたはサブクラス外の保護されたメンバー、およびそれらがexported
パッケージとユーザーreads
モジュールで宣言されていないかぎり、そのモジュール外のパブリック・メンバーを使用できません。 デフォルトでは、Field
の時(1つのバリエーションで)、Method
、またはConstructor
を使用して、フィールドを取得または設定したり、メソッドを呼び出したり、クラスの新しいインスタンスを作成して初期化したりするときに、Java言語のアクセス制御が(1つのバリエーションで)適用されます。 すべてのリフレクトされたオブジェクトは、それを使用するコードが適切なクラス、パッケージ、またはモジュールにあるかどうかをチェックします。 スタック上にJavaクラスがない「JNIコード」により起動された場合のチェックは、メンバーと宣言しているクラスがパブリックであり、すべてのモジュールにエクスポートされるパッケージ内にクラスがある場合にのみ成功します。
Java言語のアクセス制御からの1つのバリエーションは、リフレクトされたオブジェクトによるチェックが可読性を持つことです。 つまり、リフレクトされたオブジェクトの使用を含むモジュールは、基礎となるフィールド、メソッド、またはコンストラクタが宣言されているモジュールを読み込むとみなされます。
Java言語のアクセス制御のためのチェックが(アクセスを有効にできるかどうか)を抑制することができるかどうかは、リフレクトされたオブジェクトは、エクスポートまたはオープン・パッケージ(setAccessible(boolean)
を参照してください)のメンバーに対応するかどうかに依存します。
- Java言語仕様を参照してください:
-
6.6 アクセス制御
- 導入されたバージョン:
- 1.2
-
コンストラクタのサマリー
コンストラクタ -
メソッドのサマリー
修飾子と型メソッド説明final boolean
呼び出し元がこのリフレクトされたオブジェクトにアクセスできるかどうかをテストします。<T extends Annotation>
TgetAnnotation
(Class<T> annotationClass) 存在する場合は、この要素の指定された型の注釈を返し、そうでない場合はnullを返します。この要素に存在する注釈を返します。<T extends Annotation>
T[]getAnnotationsByType
(Class<T> annotationClass) この要素に関連付けられている注釈を返します。<T extends Annotation>
TgetDeclaredAnnotation
(Class<T> annotationClass) 直接存在する場合は、この要素の指定された型の注釈を返し、そうでない場合はnullを返します。この要素に直接存在する注釈を返します。<T extends Annotation>
T[]getDeclaredAnnotationsByType
(Class<T> annotationClass) 直接存在するか間接的に存在する場合は、この要素の指定された型の注釈を返します。boolean
非推奨。このメソッドは、Java言語のアクセス制御のチェックが抑制されているかどうかを実際に示しているときに、反映されたオブジェクトにアクセス可能かどうかを調べるというヒントを持つため、非推奨です。boolean
isAnnotationPresent
(Class<? extends Annotation> annotationClass) 指定された型の注釈がこの要素に存在する場合はtrueを返し、そうでない場合はfalseを返します。void
setAccessible
(boolean flag) このリフレクトされたオブジェクトのaccessible
フラグを、指定されたブール値に設定します。static void
setAccessible
(AccessibleObject[] array, boolean flag) 単一のセキュリティ・チェック(効率化のため)でリフレクトされたオブジェクトの配列のaccessible
フラグを設定する便利なメソッド。final boolean
可能であれば、このリフレクトされたオブジェクトのaccessible
フラグをtrue
に設定します。
-
コンストラクタの詳細
-
AccessibleObject
@Deprecated(since="17") protected AccessibleObject()非推奨。コンストラクタで、Java仮想マシンだけが使用します。
-
-
メソッドの詳細
-
setAccessible
public static void setAccessible(AccessibleObject[] array, boolean flag) 単一のセキュリティ・チェック(効率化のため)でリフレクトされたオブジェクトの配列のaccessible
フラグを設定する便利なメソッド。このメソッドは、各リフレクトされたオブジェクトへのアクセスを
setAccessible(boolean)
で指定されたとおりに有効にできるときに、配列内のすべてのリフレクトされたオブジェクトにアクセスできるようにするために使用できます。セキュリティ・マネージャがある場合、その
checkPermission
メソッドは最初にReflectPermission("suppressAccessChecks")
パーミッションで呼び出されます。入力
array
のいずれかの要素がクラスjava.lang.Class
のConstructor
オブジェクトであり、flag
がtrueである場合、SecurityException
もスローされます。- パラメータ:
array
- AccessibleObjectの配列flag
- 各オブジェクトのaccessible
フラグの新しい値- 例外:
InaccessibleObjectException
- アレイ内のすべてのオブジェクトに対してアクセスを有効にできない場合SecurityException
- リクエストがセキュリティ・マネージャによって拒否された場合、または配列内の要素がjava.lang.Class
のコンストラクタである場合- 関連項目:
-
setAccessible
public void setAccessible(boolean flag) このリフレクトされたオブジェクトのaccessible
フラグを、指定されたブール値に設定します。true
の値は、リフレクトされたオブジェクトが使用されたときに、Java言語のアクセス制御のチェックを抑制すべきであることを示します。false
の値は、リフレクトされたオブジェクトが、使用時にJava言語のアクセス制御をチェックし、クラスの説明に記載されているバリエーションを適用する必要があることを示します。このメソッドは、
C
クラスの呼び出し側がdeclaring class
D
のmember
へのアクセスを可能にするために使用されます:-
C
とD
は同じモジュールにあります。 - メンバーは
public
であり、D
はパッケージ内のpublic
であり、D
exports
を含むモジュールは少なくともC
を含むモジュールに含まれます。 - メンバーは
protected
static
、D
はパッケージ内のpublic
であり、D
を含むモジュールは少なくともC
を含むモジュールにエクスポートし、C
はD
のサブクラスです。 -
D
は、少なくともC
を含むモジュールにD
opens
を含むモジュールがパッケージされています。 名前のないモジュールとオープン・モジュールのすべてのパッケージはすべてのモジュールに対してオープンであるため、このメソッドは、D
が名前のないモジュールまたはオープン・モジュールにあるときには常に成功します。
このメソッドは、宣言クラスが呼び出し元とは異なるモジュールにあり、宣言クラスを含むパッケージが呼び出し元に対して開かれていない場合に、privateメンバー、デフォルト(package)アクセスを持つメンバー、保護されたインスタンス・メンバー、または保護されたコンストラクタ・モジュール。
このメソッドを使用して、non-modifiable最終フィールドへのwriteアクセスを有効にすることはできません。 次のフィールドは変更できません:
true
がJava言語アクセス制御チェックを抑制して、これらの変更不可能な最終フィールドへのreadアクセスのみを有効にする場合のaccessible
フラグ。セキュリティ・マネージャがある場合、その
checkPermission
メソッドは最初にReflectPermission("suppressAccessChecks")
パーミッションで呼び出されます。- パラメータ:
flag
-accessible
フラグの新しい値- 例外:
InaccessibleObjectException
- アクセスを有効にできない場合SecurityException
- リクエストがセキュリティ・マネージャによって拒否された場合- 関連項目:
-
-
trySetAccessible
public final boolean trySetAccessible()可能であれば、このリフレクトされたオブジェクトのaccessible
フラグをtrue
に設定します。 このメソッドは、accessible
フラグを、setAccessible(true)
を呼び出すように設定し、accessible
フラグのために更新された値を返します。 アクセスを有効にできない、つまりチェックやJava言語のアクセス制御を抑制できない場合、このメソッドはfalse
(setAccessible(true)
が失敗したときにInaccessibleObjectException
をスローするのではなく)を返します。このリフレクトされたオブジェクトの
accessible
フラグがtrue
の場合、このメソッドはno-opです。たとえば、呼び出し側は、
Method
オブジェクトが呼び出されたときにJava言語アクセス制御のチェックを抑制するために、Method
オブジェクトのtrySetAccessible
オブジェクトをプライベート・インスタンス・メソッドp.T::privateMethod
に対して呼び出すことができます。p.T
クラスが呼び出し元とは異なるモジュールにあり、パッケージp
が少なくとも呼び出し元モジュールに対して開いている場合、以下のコードはaccessible
フラグをtrue
に設定します。p.T obj = ....; // instance of p.T : Method m = p.T.class.getDeclaredMethod("privateMethod"); if (m.trySetAccessible()) { m.invoke(obj); } else { // package p is not opened to the caller to access private member of T ... }
セキュリティ・マネージャがある場合、その
checkPermission
メソッドは最初にReflectPermission("suppressAccessChecks")
パーミッションで呼び出されます。- 戻り値:
accessible
フラグがtrue
に設定されている場合、true
;false
アクセスを有効にできない場合false
。- 例外:
SecurityException
- リクエストがセキュリティ・マネージャによって拒否された場合- 導入されたバージョン:
- 9
- 関連項目:
-
isAccessible
@Deprecated(since="9") public boolean isAccessible()非推奨。このメソッドは、Java言語のアクセス制御のチェックが抑制されているかどうかを実際に示しているときに、反映されたオブジェクトにアクセス可能かどうかを調べるというヒントを持つため、非推奨です。 このメソッドは、呼び出し元がアクセス可能なリフレクトされたオブジェクトに対してfalse
を返します。 この反射オブジェクトがアクセス可能かどうかをテストするには、canAccess(Object)
を使用する必要があります。このリフレクトされたオブジェクトのaccessible
フラグの値を取得します。- 戻り値:
- オブジェクトの
accessible
フラグの値
-
canAccess
public final boolean canAccess(Object obj) 呼び出し元がこのリフレクトされたオブジェクトにアクセスできるかどうかをテストします。 このリフレクトされたオブジェクトがインスタンス・メソッドまたはフィールドに対応する場合、このメソッドは呼び出し元がリフレクトされたオブジェクトで指定されたobj
にアクセスできるかどうかをテストします。 例えばメソッドやフィールドの場合、obj
引数はdeclaring class
のインスタンスでなければなりません。 静的メンバーとコンストラクタの場合、obj
はnull
でなければなりません。このメソッドは、
accessible
フラグがtrue
に設定されている場合、つまりJava言語アクセス制御のチェックが抑制されている場合、または「Java言語仕様」で指定されているように呼出し側がメンバーにアクセスできる場合にtrue
を返します(クラスの説明にはバリエーションが記載されています)。- パラメータ:
obj
- インスタンス・メソッドまたはフィールドの場合、このリフレクトされたオブジェクトの宣言クラスのインスタンス・オブジェクト- 戻り値:
- 呼び出し元がこのリフレクトされたオブジェクトにアクセスできる場合は
true
。 - 例外:
IllegalArgumentException
-- このリフレクトされたオブジェクトが静的メンバーまたはコンストラクタであり、指定された
obj
が非null
の場合、または - このリフレクトされたオブジェクトがインスタンス・メソッドまたはフィールドであり、指定された
obj
がnull
であるか、メンバーのdeclaring class
のサブクラスではない型の場合。
- このリフレクトされたオブジェクトが静的メンバーまたはコンストラクタであり、指定された
- Java言語仕様を参照してください:
-
6.6 アクセス制御
- 導入されたバージョン:
- 9
- 関連項目:
-
getAnnotation
public <T extends Annotation> T getAnnotation(Class<T> annotationClass) 存在する場合は、この要素の指定された型の注釈を返し、そうでない場合はnullを返します。このメソッドによって返される注釈は宣言注釈であることに注意してください。
- 定義:
getAnnotation
、インタフェースAnnotatedElement
- 実装要件:
- デフォルトの実装では
UnsupportedOperationException
がスローされます。サブクラスはこのメソッドをオーバーライドする必要があります。 - 型パラメータ:
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) この要素に関連付けられている注釈を返します。 この要素に関連付けられている注釈がない場合、戻り値は長さ0の配列です。 このメソッドとAnnotatedElement.getAnnotation(Class)
の違いは、引数が「繰返し可能な注釈タイプ」 (JLS 9.6)であるかどうかをこのメソッドが検出し、その場合、"検索"がコンテナ注釈を使用してそのタイプの注釈を検索しようとすることです。 このメソッドの呼出し元は、返された配列を自由に変更することができ、これはほかの呼出し元に返された配列に影響を及ぼしません。このメソッドによって返される注釈は宣言注釈であることに注意してください。
- 定義:
getAnnotationsByType
、インタフェースAnnotatedElement
- 実装要件:
- デフォルトの実装では
UnsupportedOperationException
がスローされます。サブクラスはこのメソッドをオーバーライドする必要があります。 - 型パラメータ:
T
- 照会し、存在する場合に返す注釈の型。- パラメータ:
annotationClass
- 注釈型に対応するClassオブジェクト- 戻り値:
- この要素に関連付けられている場合は、この要素の指定された注釈型のすべての注釈。そうでない場合は長さ0の配列
- 例外:
NullPointerException
- 指定された注釈クラスがnullの場合- 導入されたバージョン:
- 1.8
-
getAnnotations
public Annotation[] getAnnotations()この要素に存在する注釈を返します。 この要素に存在する注釈がない場合、戻り値は長さ0の配列です。 このメソッドの呼出し元は、返された配列を自由に変更することができ、これはほかの呼出し元に返された配列に影響を及ぼしません。このメソッドによって返される注釈は宣言注釈であることに注意してください。
- 定義:
getAnnotations
、インタフェースAnnotatedElement
- 戻り値:
- この要素に存在する注釈
- 導入されたバージョン:
- 1.5
-
getDeclaredAnnotation
public <T extends Annotation> T getDeclaredAnnotation(Class<T> annotationClass) 直接存在する場合は、この要素の指定された型の注釈を返し、そうでない場合はnullを返します。 このメソッドは継承された注釈を無視します。 (この要素に直接存在する注釈がない場合は、nullを返します。)このメソッドによって返される注釈は宣言注釈であることに注意してください。
- 定義:
getDeclaredAnnotation
、インタフェースAnnotatedElement
- 型パラメータ:
T
- 照会し、直接存在する場合に返す注釈の型。- パラメータ:
annotationClass
- 注釈型に対応するClassオブジェクト- 戻り値:
- 直接存在する場合は、この要素の指定された注釈型の注釈。そうでない場合はnull
- 例外:
NullPointerException
- 指定された注釈クラスがnullの場合- 導入されたバージョン:
- 1.8
-
getDeclaredAnnotationsByType
public <T extends Annotation> T[] getDeclaredAnnotationsByType(Class<T> annotationClass) 直接存在するか間接的に存在する場合は、この要素の指定された型の注釈を返します。 このメソッドは継承された注釈を無視します。 この要素に直接または間接的に存在する指定された注釈がない場合、戻り値は長さ0の配列です。 このメソッドとAnnotatedElement.getDeclaredAnnotation(Class)
の違いは、引数が「繰返し可能な注釈タイプ」 (JLS 9.6)であるかどうかをこのメソッドが検出し、ある場合は"検索"がコンテナ注釈(存在する場合)を検出しようとする点です。 このメソッドの呼出し元は、返された配列を自由に変更することができ、これはほかの呼出し元に返された配列に影響を及ぼしません。このメソッドによって返される注釈は宣言注釈であることに注意してください。
- 定義:
getDeclaredAnnotationsByType
、インタフェースAnnotatedElement
- 型パラメータ:
T
- 照会し、直接または間接的に存在する場合に返す注釈の型。- パラメータ:
annotationClass
- 注釈型に対応するClassオブジェクト- 戻り値:
- この要素に直接または間接的に存在する場合は、この要素の指定された注釈型のすべての注釈。そうでない場合は長さ0の配列
- 例外:
NullPointerException
- 指定された注釈クラスがnullの場合- 導入されたバージョン:
- 1.8
-
getDeclaredAnnotations
public Annotation[] getDeclaredAnnotations()この要素に直接存在する注釈を返します。 このメソッドは継承された注釈を無視します。 この要素に直接存在する注釈がない場合、戻り値は長さ0の配列です。 このメソッドの呼出し元は、返された配列を自由に変更することができ、これはほかの呼出し元に返された配列に影響を及ぼしません。このメソッドによって返される注釈は宣言注釈であることに注意してください。
- 定義:
getDeclaredAnnotations
、インタフェースAnnotatedElement
- 実装要件:
- デフォルトの実装では
UnsupportedOperationException
がスローされます。サブクラスはこのメソッドをオーバーライドする必要があります。 - 戻り値:
- この要素に直接存在する注釈
- 導入されたバージョン:
- 1.5
-