compact1, compact2, compact3

java.lang.reflect

Class AccessibleObject

java.lang.Object

java.lang.reflect.AccessibleObject

All Implemented Interfaces:

AnnotatedElement

已知直接子类：

Executable ， Field

public class AccessibleObject
extends Object
implements AnnotatedElement

AccessibleObject类是Field，Method和Constructor对象的基类。 它提供了将反射对象标记为在使用它时抑制默认Java语言访问控制检查的功能。 当使用Fields，Methods或Constructors来设置或获取字段，调用方法，或创建和初始化新的类实例时，执行访问检查（对于public，默认（包）访问，受保护和私有成员） ， 分别。

在反射对象中设置accessible标志允许具有足够权限的复杂应用程序（如Java对象序列化或其他持久性机制）以通常被禁止的方式操纵对象。

默认情况下，反射对象不可访问。

从以下版本开始：

1.2

另请参见：

Field ， 方法 ， Constructor ， ReflectPermission

构造方法摘要

构造方法

Modifier	Constructor and Description
protected	AccessibleObject() 构造函数：仅由Java虚拟机使用。

方法摘要

Modifier and Type	Method and Description
<T extends Annotation> T	getAnnotation(类<T> annotationClass) 返回该元素的，如果这样的注释 ，否则返回null指定类型的注释。
Annotation[]	getAnnotations() 返回此元素上 存在的注释。
<T extends Annotation> T[]	getAnnotationsByType(类<T> annotationClass) 返回与此元素相关 联的注释 。
<T extends Annotation> T	getDeclaredAnnotation(类<T> annotationClass) 如果这样的注释 直接存在 ，则返回指定类型的元素注释，否则返回null。
Annotation[]	getDeclaredAnnotations() 返回 直接存在于此元素上的注释。
<T extends Annotation> T[]	getDeclaredAnnotationsByType(类<T> annotationClass) 如果此类注释 直接存在或 间接存在，则返回该元素的注释（指定类型）。
boolean	isAccessible() 获取此对象的 accessible标志的值。
boolean	isAnnotationPresent(类<? extends Annotation> annotationClass) 如果此元素上 存在指定类型的注释，则返回true，否则返回false。
static void	setAccessible(AccessibleObject[] array, boolean flag) 方便的方法来设置 accessible标志的一系列对象的安全检查（为了效率）。
void	setAccessible(boolean flag) 将此对象的 accessible标志设置为指示的布尔值。

Methods inherited from class java.lang.Object

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

构造方法详细信息

AccessibleObject

protected AccessibleObject()

构造函数：仅由Java虚拟机使用。

方法详细信息

setAccessible

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

方便的方法来设置accessible标志的一系列对象的安全检查（为了效率）。

首先，如果有一个安全管理器，它的checkPermission方法被调用一个ReflectPermission("suppressAccessChecks")权限。

甲SecurityException如果升高flag是true但任何输入的元件中的可访问性array可以不改变（例如，如果元素对象是Constructor对象为类类 ）。 在发生这种SecurityException的情况下，对于数组元素，对象的可访问性设置为flag （并且排除）异常发生的元素; 除了（和包括）异常发生的元素以外的元素的可访问性是不变的。

参数

array - array的数组

flag - 每个对象中的 accessible标志的新值

异常

SecurityException - 如果请求被拒绝。

另请参见：

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

setAccessible

public void setAccessible(boolean flag)
                   throws SecurityException

将此对象的accessible标志设置为指示的布尔值。 true的值表示反射对象应该在使用时抑制Java语言访问检查。 false的值表示反映的对象应该强制执行Java语言访问检查。

首先，如果有一个安全管理器，它的checkPermission方法被调用一个ReflectPermission("suppressAccessChecks")权限。

甲SecurityException如果升高flag是true但此对象的可访问性可以不改变（例如，如果该元素对象是Constructor对象为类类 ）。

一个SecurityException如果这个对象是提高Constructor对象类java.lang.Class ，以及flag是真的。

参数

flag - accessible旗的新值

异常

SecurityException - 如果请求被拒绝。

另请参见：

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

isAccessible

public boolean isAccessible()

获取此对象的 accessible标志的值。

结果

对象的 accessible标志

getAnnotation

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

说明从界面： AnnotatedElement复制

返回该元素的，如果这样的注释 ，否则返回null指定类型的注释。

Specified by:

getAnnotation在界面 AnnotatedElement

参数类型

T - 要查询的注释类型，如果存在则返回

参数

annotationClass - 对应于注释类型的Class对象

结果

该元素的注释指定的注释类型，如果存在于此元素，否则为null

异常

NullPointerException - 如果给定的注释类为空

从以下版本开始：

1.5

isAnnotationPresent

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

如果此元素上存在指定类型的注释，则返回true，否则返回false。 该方法主要用于方便访问标记注释。

此方法返回的真值相当于： getAnnotation(annotationClass) != null

默认方法的主体被指定为上述代码。

Specified by:

isAnnotationPresent在界面 AnnotatedElement

参数

annotationClass - 对应于注释类型的Class对象

结果

如果此元素上存在指定注释类型的注释，则为true，否则为false

异常

NullPointerException - 如果给定的注释类为空

从以下版本开始：

1.5

getAnnotationsByType

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

描述从界面： AnnotatedElement复制

返回与此元素相关联的注释 。 如果没有与此元素相关联的注释 ，则返回值为长度为0.的数组。此方法与AnnotatedElement.getAnnotation(Class)之间的区别在于该方法检测其参数是否是可重复注释类型 （JLS 9.6），如果是，则尝试通过“查看”容器注释来查找该类型的一个或多个注释。 该方法的调用者可以自由修改返回的数组; 它将对返回给其他调用者的数组没有影响。

Specified by:

getAnnotationsByType在界面 AnnotatedElement

参数类型

T - 要查询的注释类型，如果存在则返回

参数

annotationClass - 对应于注释类型的Class对象

结果

如果与此元素相关联，则指定注释类型的所有元素注释，否则为长度为零的数组

异常

NullPointerException - 如果给定的注释类为空

从以下版本开始：

1.8

getAnnotations

public Annotation[] getAnnotations()

说明从界面： AnnotatedElement复制

返回此元素上存在的注释。 如果没有存在于此元素上注解，返回值是长度为0这种方法的调用者可以随意修改返回的数组的数组; 它将对返回给其他调用者的数组没有影响。

Specified by:

getAnnotations在界面 AnnotatedElement

结果

此元素上出现的注释

从以下版本开始：

1.5

getDeclaredAnnotation

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

说明从界面： AnnotatedElement复制

如果这样的注释直接存在 ，则返回指定类型的元素注释，否则返回null。 此方法忽略继承的注释。 （如果此元素上没有注释，则返回null）

Specified by:

getDeclaredAnnotation在界面 AnnotatedElement

参数类型

T - 要查询并返回的注释的类型，如果直接出现

参数

annotationClass - 对应于注释类型的Class对象

结果

如果直接出现在该元素上，则指定注释类型的元素注释，否则为null

异常

NullPointerException - 如果给定的注释类为空

从以下版本开始：

1.8

getDeclaredAnnotationsByType

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

说明从界面： AnnotatedElement复制

如果此类注释直接存在或间接存在，则返回该元素的注释（指定类型）。 此方法忽略继承的注释。 如果在该元素上没有直接或间接存在的指定注释，则返回值为长度为0.的数组。此方法与AnnotatedElement.getDeclaredAnnotation(Class)之间的区别在于该方法检测其参数是否是可重复注释类型 （JLS 9.6），以及如果是，尝试通过“查看”容器注释（如果存在）来查找该类型的一个或多个注释。 该方法的调用者可以自由修改返回的数组; 它将对返回给其他调用者的数组没有影响。

Specified by:

getDeclaredAnnotationsByType在界面 AnnotatedElement

参数类型

T - 直接或间接出现的查询和返回的注释类型

参数

annotationClass - 对应于注释类型的Class对象

结果

指定注释类型的所有这些元素的注释，如果直接或间接地存在于该元素上，否则为长度为零的数组

异常

NullPointerException - 如果给定的注释类为空

从以下版本开始：

1.8

getDeclaredAnnotations

public Annotation[] getDeclaredAnnotations()

说明从界面： AnnotatedElement复制

返回直接存在于此元素上的注释。 此方法忽略继承的注释。 如果此元素上没有直接显示的注释，则返回值为长度为0的数组。此方法的调用者可以自由修改返回的数组; 它将对返回给其他调用者的数组没有影响。

Specified by:

getDeclaredAnnotations在界面 AnnotatedElement

结果

此元素上直接显示的注释

从以下版本开始：

1.5