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类是领域的基类方法和构造函数的对象。它提供的能力标志反射对象作为抑制默认java语言访问控制检查时。访问检查-对于公共的，默认的（包）访问，保护和私有成员-当字段，方法或构造函数用于设置或获取字段，调用方法，或创建和初始化类的新实例，分别。

在一个体现对象允许复杂的应用程序具有足够的权限设置accessible旗，如java对象序列化或其他持久性机制，操纵的方式，通常会被禁止的对象。

默认情况下，一个反射对象是不可访问的。

从以下版本开始：

一点二

另请参见：

Field， 方法， Constructor， ReflectPermission

构造方法摘要

构造方法

Modifier	Constructor and Description
protected	AccessibleObject() 构造函数：只有通过java虚拟机。

方法摘要

Modifier and Type	Method and Description
<T extends Annotation> T	getAnnotation(类<T> annotationClass) 如果存在此注释，则返回此元素的指定类型的注释，否则为空。
Annotation[]	getAnnotations() 返回此元素上的注释。
<T extends Annotation> T[]	getAnnotationsByType(类<T> annotationClass) 返回与此元素关联的注释。
<T extends Annotation> T	getDeclaredAnnotation(类<T> annotationClass) 返回此元素的指定类型的注释，如果这样的注释是直接存在的，否则为空。
Annotation[]	getDeclaredAnnotations() 返回直接在该元素上的注释。
<T extends Annotation> T[]	getDeclaredAnnotationsByType(类<T> annotationClass) 如果这样的注释直接存在或间接存在，则返回指定类型的该元素的注释（s）。
boolean	isAccessible() 得到的 accessible标志该对象的值。
boolean	isAnnotationPresent(类<? extends Annotation> annotationClass) 如果在这个元素上存在指定类型的注释，则返回真，否则为假。
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

Constructor Detail

AccessibleObject

protected AccessibleObject()

构造函数：只有通过java虚拟机。

方法详细信息

setAccessible

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

为一个单一的安全检查对象数组设置 accessible方便旗的方法（效率）。

首先，如果存在安全管理器，它的checkPermission方法称为一个ReflectPermission("suppressAccessChecks")许可。

如果一个SecurityException flag是true但任何输入的array元素可不能改变了（例如，如果元素对象是类的一个对象类 Constructor）。在这样一个动态的事件，对象的可访问性设置为数组元素flag至（不包括）的，发生异常元素；辅助元素以外的元素（包括），发生异常是不变的。

参数

array - accessibleobjects阵列

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对象是类java.lang.Class一Constructor对象提出的，并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

如果存在此注释，则返回此元素的指定类型的注释，否则为空。

Specified by:

getAnnotation 接口 AnnotatedElement

参数类型

T -查询并返回如果目前的标注类型

参数

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

结果

如果此元素上存在指定的注释类型，此元素的注释将在其他元素上为空

异常

NullPointerException如果注释类是无效的

从以下版本开始：

一点五

isAnnotationPresent

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

如果在这个元素上存在指定类型的注释，则返回真，否则为假。此方法的设计主要是方便的标记注释。

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

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

Specified by:

isAnnotationPresent 接口 AnnotatedElement

参数

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

结果

如果在这个元素上存在指定的注释类型的注释，则为假

异常

NullPointerException如果注释类是无效的

从以下版本开始：

一点五

getAnnotationsByType

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

从接口复制的描述： AnnotatedElement

返回与此元素关联的注释。如果没有与此元素关联的批注，返回值是一个长度为0的数组。这种方法和 AnnotatedElement.getAnnotation(Class)之间的区别是，该方法检测如果它的参数是一个可重复的注释类型（年9.6），如果是这样的话，试图找到一个或更多的注释，通过“浏览”式容器标注。此方法的调用方可以自由修改返回的数组；它将对返回给其他调用方的数组没有影响。

Specified by:

getAnnotationsByType 接口 AnnotatedElement

参数类型

T -查询并返回如果目前的标注类型

参数

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

结果

所有此元素的注释都与此元素关联，如果关联的是指定的注释类型，其他的数组长度为零

异常

NullPointerException如果注释类是无效的

从以下版本开始：

一点八

getAnnotations

public Annotation[] getAnnotations()

从接口复制的描述： AnnotatedElement

返回此元素上的注释。如果这个元素上没有注释，则返回值是一个长度为0的数组。此方法的调用方可以自由修改返回的数组；它将对返回给其他调用方的数组没有影响。

Specified by:

getAnnotations 接口 AnnotatedElement

结果

在这个元素上的注释

从以下版本开始：

一点五

getDeclaredAnnotation

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

从接口复制的描述： AnnotatedElement

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

Specified by:

getDeclaredAnnotation 接口 AnnotatedElement

参数类型

T -查询，如果直接提出返回的标注类型

参数

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

结果

此元素的注释类型，如果直接存在于此元素，将为指定的注释类型，否则为

异常

NullPointerException如果注释类是无效的

从以下版本开始：

一点八

getDeclaredAnnotationsByType

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

从接口复制的描述： AnnotatedElement

如果这样的注释直接存在或间接存在，则返回指定类型的该元素的注释（s）。此方法忽略了继承的注释。如果在这个元素上没有直接或间接存在指定的注释，则返回值是一个长度为0的数组。这种方法和 AnnotatedElement.getDeclaredAnnotation(Class)之间的区别是，该方法检测如果它的参数是一个可重复的注释类型（年9.6），如果是这样的话，试图找到一个或更多的注释，通过“浏览”式容器注释如果存在。此方法的调用方可以自由修改返回的数组；它将对返回给其他调用方的数组没有影响。

Specified by:

getDeclaredAnnotationsByType 接口 AnnotatedElement

参数类型

T -注释类型来查询并返回如果直接或间接存在

参数

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

结果

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

异常

NullPointerException如果注释类是无效的

从以下版本开始：

一点八

getDeclaredAnnotations

public Annotation[] getDeclaredAnnotations()

从接口复制的描述： AnnotatedElement

返回直接在该元素上的注释。此方法忽略了继承的注释。如果在这个元素上没有直接存在的注释，返回值是一个长度为0的数组。此方法的调用方可以自由修改返回的数组；它将对返回给其他调用方的数组没有影响。

Specified by:

getDeclaredAnnotations 接口 AnnotatedElement

结果

直接在这个元素上的注释

从以下版本开始：

一点五