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 객체의 base class입니다. 이 클래스를 사용하면, 리플렉트 된 객체의 사용시에 디폴트의 Java 언어 액세스 제어 체크를 억제할지 어떨지의 플래그 설정을 실시할 수 있습니다. 액세스 체크는 다음의 경우에 public, 디폴트 (package) 액세스, protected 및 private 멤버에 대해서 실행됩니다. 즉, 필드의 설정 또는 취득에 Field가 사용되는 경우, 메서드의 호출에 Method가 사용되는 경우, 혹은 클래스의 새로운 인스턴스의 생성 및 초기화에 Constructor가 사용되는 경우입니다.

리플렉트 된 객체로 accessible 플래그를 설정하면, 충분한 특권을 가지는 고도의 어플리케이션 (Java 객체의 직렬화나 그 외의 지속성 도구 등)은 일반적으로 금지되고 있는 방법으로 객체를 조작할 수 있습니다.

도입된 버전 :

1.2

관련 항목:

Field, Method, Constructor, ReflectPermission

생성자 개요

protected

AccessibleObject () 생성자 으로 Java 가상 머신만이 사용합니다.

메서드 개요

<T extends Annotation > T	getAnnotation (Class <T> annotationClass) 지정된 형태의 주석이 존재하는 경우는 지정된 형태의 요소의 주석을 리턴합니다.
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 가상 머신만이 사용합니다.

메서드의 상세

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을 리턴합니다.

정의:

인터페이스 AnnotatedElement 내의 getAnnotation

파라미터:

annotationClass - 어노테이션에 대응하는 Class 객체

반환값:

존재하는 경우는 지정된 어노테이션의 요소의 주석. 그렇지 않은 경우는 null

isAnnotationPresent

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

인터페이스 AnnotatedElement 기술:

지정된 형태의 주석이 이 요소에 존재하는 경우는 true를 돌려주고, 그렇지 않은 경우는 false를 리턴합니다. 이 메서드는 주로 마커 주석에의 간이 액세스를 목적으로 설계되고 있습니다.

정의:

인터페이스 AnnotatedElement 내의 isAnnotationPresent

파라미터:

annotationClass - 어노테이션에 대응하는 Class 객체

반환값:

지정된 어노테이션의 주석이 이 요소에 존재하는 경우는 true, 그렇지 않은 경우는 false

getAnnotations

public Annotation [] getAnnotations()

인터페이스 AnnotatedElement 기술:

이 요소에 존재하는 모든 주석을 리턴합니다 (이 요소에 주석이 없는 경우는 길이 제로의 배열을 리턴합니다). 이 메서드의 호출원래는 리턴된 배열을 자유롭게 변경할 수 있습니다. 이 변경은 다른 호출 바탕으로 리턴된 배열에 영향을 미치지 않습니다.

정의:

인터페이스 AnnotatedElement 내의 getAnnotations

반환값:

이 요소에 존재하는 모든 주석

getDeclaredAnnotations

public Annotation [] getDeclaredAnnotations()

인터페이스 AnnotatedElement 기술:

이 요소에 직접 존재하는 모든 주석을 리턴합니다. 이 인터페이스에 있는 다른 메서드와는 달라, 이 메서드는 상속된 주석을 무시합니다 (이 요소에 주석이 직접 존재하지 않는 경우는 길이 제로의 배열을 돌려준다). 이 메서드의 호출원래는 리턴된 배열을 자유롭게 변경할 수 있습니다. 이 변경은 다른 호출 바탕으로 리턴된 배열에 영향을 미치지 않습니다.

정의:

인터페이스 AnnotatedElement 내의 getDeclaredAnnotations

반환값:

이 요소에 직접 존재하는 모든 주석