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 가 throw 됩니다만, 입력 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 가 throw 됩니다만, 이 객체의 액세스 가능성은 변함없는 것이 있습니다 (예를 들어, 이 요소 객체가 Class 클래스 Constructor 객체인 경우).

이 객체가 java.lang.Class 클래스 Constructor 객체이며,flag 가 true 인 경우,SecurityException 가 throw 됩니다.

파라미터:

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 의 기술:

지정된 형태의 주석이 존재하는 경우는, 지정된 형태의 요소의 주석을 돌려줍니다.

정의:

인터페이스 AnnotatedElement 내의 getAnnotation

파라미터:

annotationClass - 주석형에 대응하는 Class 객체

반환값:

존재하는 경우는, 지정된 주석형의 요소의 주석. 그렇지 않은 경우는 null

예외:

NullPointerException - 지정된 주석 클래스가 null 의 경우

도입된 버젼:

1.5

isAnnotationPresent

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

인터페이스 AnnotatedElement 의 기술:

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

정의:

인터페이스 AnnotatedElement 내의 isAnnotationPresent

파라미터:

annotationClass - 그렇지 않은 경우는 null 를 돌려줍니다. 주석형에 대응하는 Class 객체

반환값:

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

예외:

NullPointerException - 지정된 주석 클래스가 null 의 경우

도입된 버젼:

1.5

getAnnotations

public Annotation [] getAnnotations()

인터페이스 AnnotatedElement 의 기술:

이 요소에 존재하는 모든 주석을 돌려줍니다 (이 요소에 주석이 없는 경우는 길이 제로의 배열을 돌려줍니다). 이 변경은, 다른 호출해 바탕으로 반환된 배열에 영향을 미치지 않습니다.

정의:

인터페이스 AnnotatedElement 내의 getAnnotations

반환값:

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

도입된 버젼:

1.5

getDeclaredAnnotations

public Annotation [] getDeclaredAnnotations()

인터페이스 AnnotatedElement 의 기술:

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

정의:

인터페이스 AnnotatedElement 내의 getDeclaredAnnotations

반환값:

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

도입된 버젼:

1.5