java.lang.reflect
클래스 Field

java.lang.Object 
  java.lang.reflect.AccessibleObject 
      java.lang.reflect.Field

모든 구현된 인터페이스:

AnnotatedElement , Member

public final class Field
extends AccessibleObject 
implements Member 

Field 는, 클래스 또는 인터페이스에 대한 정보, 그것들에의 동적인 액세스, 그 단일 필드를 제공합니다. 리플렉트 된 필드가, 클래스 (static) 필드 또는 인스턴스 필드인 일도 있습니다.

Field 는, 액세스 조작의 취득 또는 설정중에 확대 변환이 발생하는 것을 허가합니다만, 축소 변환이 발생하면(자) IllegalArgumentException 를 throw 합니다.

관련 항목:

Member , Class , Class.getFields() , Class.getField(String) , Class.getDeclaredFields() , Class.getDeclaredField(String)

필드의 개요

인터페이스 java.lang.reflect. Member 로부터 상속된 필드

DECLARED , PUBLIC

메소드의 개요

boolean	equals (Object obj) Field 가 지정된 객체와 비교합니다.
Object	get (Object obj) 지정된 객체에 대해, 이 Field 에 의해 나타내지는 필드의 값을 돌려줍니다.
<T extends Annotation > T	getAnnotation (Class <T> annotationClass) 지정된 형태의 주석이 존재하는 경우는, 지정된 형태의 요소의 주석을 돌려줍니다.
boolean	getBoolean (Object obj) static 또는 인스턴스 boolean 필드의 값을 가져옵니다.
byte	getByte (Object obj) static 또는 인스턴스 byte 필드의 값을 가져옵니다.
char	getChar (Object obj) char 형, 또는 확대 변환에 의해 char 형에 변환 가능한 다른 원시형의 static 또는 인스턴스 필드의 값을 가져옵니다.
Annotation []	getDeclaredAnnotations () 이 요소에 직접 존재하는 모든 주석을 돌려줍니다.
Class <? >	getDeclaringClass () Field 객체에 의해 나타내지는 필드를 선언하는 클래스 또는 인터페이스를 나타내는 Class 객체를 돌려줍니다.
double	getDouble (Object obj) double 형, 또는 확대 변환에 의해 double 형에 변환 가능한 다른 원시형의 static 또는 인스턴스 필드의 값을 가져옵니다.
float	getFloat (Object obj) float 형, 또는 확대 변환에 의해 float 형에 변환 가능한 다른 원시형의 static 또는 인스턴스 필드의 값을 가져옵니다.
Type	getGenericType () Field 객체로 나타내지는 필드의 선언형을 나타내는 Type 객체를 돌려줍니다.
int	getInt (Object obj) int 형, 또는 확대 변환에 의해 int 형에 변환 가능한 다른 원시형의 static 또는 인스턴스 필드의 값을 가져옵니다.
long	getLong (Object obj) long 형, 또는 확대 변환에 의해 long 형에 변환 가능한 다른 원시형의 static 또는 인스턴스 필드의 값을 가져옵니다.
int	getModifiers () Field 객체에 의해 나타내지는 필드의 Java 언어 수식자를 정수로서 돌려줍니다.
String	getName () Field 객체에 의해 나타내지는 필드의 이름을 돌려줍니다.
short	getShort (Object obj) short 형, 또는 확대 변환에 의해 short 형에 변환 가능한 다른 원시형의 static 또는 인스턴스 필드의 값을 가져옵니다.
Class <? >	getType () Field 객체로 나타내지는 필드의 선언형을 식별하는 Class 객체를 돌려줍니다.
int	hashCode () Field 의 해시 코드를 돌려줍니다.
boolean	isEnumConstant () 이 필드가 열거형의 요소를 나타내는 경우는 true 를 돌려주어, 그렇지 않은 경우는 false 를 돌려줍니다.
boolean	isSynthetic () 이 필드가 합성 필드인 경우는 true 를 돌려주어, 그렇지 않은 경우는 false 를 돌려줍니다.
void	set (Object obj, Object value) 이 Field 객체에 의해 나타내지는 지정된 객체 인수의 필드를, 지정된 새로운 값으로 설정합니다.
void	setBoolean (Object obj, boolean z) 지정된 객체에 대해, 필드의 값을 boolean 로서 설정합니다.
void	setByte (Object obj, byte b) 지정된 객체에 대해, 필드의 값을 byte 로서 설정합니다.
void	setChar (Object obj, char c) 지정된 객체에 대해, 필드의 값을 char 로서 설정합니다.
void	setDouble (Object obj, double d) 지정된 객체에 대해, 필드의 값을 double 로서 설정합니다.
void	setFloat (Object obj, float f) 지정된 객체에 대해, 필드의 값을 float 로서 설정합니다.
void	setInt (Object obj, int i) 지정된 객체에 대해, 필드의 값을 int 로서 설정합니다.
void	setLong (Object obj, long l) 지정된 객체에 대해, 필드의 값을 long 로서 설정합니다.
void	setShort (Object obj, short s) 지정된 객체에 대해, 필드의 값을 short 로서 설정합니다.
String	toGenericString () 총칭형을 포함한, 이 Field 를 기술하는 캐릭터 라인을 돌려줍니다.
String	toString () Field 를 기술하는 캐릭터 라인을 돌려줍니다.

클래스 java.lang.reflect. AccessibleObject 로부터 상속된 메소드

getAnnotations , isAccessible , isAnnotationPresent , setAccessible , setAccessible

클래스 java.lang. Object 로부터 상속된 메소드

clone , finalize , getClass , notify , notifyAll , wait , wait , wait

메소드의 상세

getDeclaringClass

public Class <? > getDeclaringClass()

Field 객체에 의해 나타내지는 필드를 선언하는 클래스 또는 인터페이스를 나타내는 Class 객체를 돌려줍니다.

정의:

인터페이스 Member 내의 getDeclaringClass

반환값:

기본이 되는 멤버의 선언 클래스를 나타내는 객체

getName

public String  getName()

Field 객체에 의해 나타내지는 필드의 이름을 돌려줍니다.

정의:

인터페이스 Member 내의 getName

반환값:

기본이 되는 멤버의 단순명

getModifiers

public int getModifiers()

Field 객체에 의해 나타내지는 필드의 Java 언어 수식자를 정수로서 돌려줍니다. 수식자의 복호화에는,Modifier 클래스를 사용할 필요가 있습니다.

정의:

인터페이스 Member 내의 getModifiers

반환값:

기본이 되는 멤버의 Java 언어 수식자

관련 항목:

Modifier

isEnumConstant

public boolean isEnumConstant()

이 필드가 열거형의 요소를 나타내는 경우는 true 를 돌려주어, 그렇지 않은 경우는 false 를 돌려줍니다.

반환값:

이 필드가 열거형의 요소를 나타내는 경우에 한정해,true

도입된 버젼:

1.5

isSynthetic

public boolean isSynthetic()

이 필드가 합성 필드인 경우는 true 를 돌려주어, 그렇지 않은 경우는 false 를 돌려줍니다.

정의:

인터페이스 Member 내의 isSynthetic

반환값:

이 필드가, 「Java 언어 스펙」으로 정의되고 있는 합성 필드인 경우에 한정해, true

도입된 버젼:

1.5

getType

public Class <? > getType()

Field 객체로 나타내지는 필드의 선언형을 식별하는 Class 객체를 돌려줍니다.

반환값:

이 객체가 나타내는 필드의 선언형을 식별하는 Class 객체

getGenericType

public Type  getGenericType()

Field 객체로 나타내지는 필드의 선언형을 나타내는 Type 객체를 돌려줍니다.

Type 가, 파라미터화 된 형태의 경우, 반환되는 Type 객체는, 원시 코드로 사용되는 실제의 형태 파라미터를 정확하게 반영하지 않으면 안됩니다.

기본이 되는 필드의 형태가, 형태 변수 또는 파라미터화 된 형태의 경우, 가파라미터형은 작성됩니다. 그렇지 않은 경우, 예외 타입은 해결됩니다.

반환값:

Field 객체로 나타내지는 필드의 선언형을 나타내는 Type 객체

예외:

GenericSignatureFormatError - 이 총칭 필드의 서명이 「Java 가상 머신 스펙 제 3 판」으로 규정되는 서식에 적합하지 않는 경우

TypeNotPresentException - 기본이 되는 필드의 총칭형의 서명이, 존재하지 않는 형태 선언을 참조하는 경우

MalformedParameterizedTypeException - 기본이 되는 필드의 총칭 서명이, 하등의 이유에 의해 인스턴스화할 수 없는 파라미터화 된 형태를 참조하는 경우

도입된 버젼:

1.5

equals

public boolean equals(Object  obj)

Field 가 지정된 객체와 비교합니다. 객체가 같은 경우에는 true 를 돌려줍니다. 2 개의 Field 객체는, 같은 클래스에서 선언되어 같은 이름과 형태를 가지는 경우에 동일하다고 보입니다.

오버라이드(override):

클래스 Object 내의 equals

파라미터:

obj - 비교 대상의 참조 객체

반환값:

obj 인수로 지정된 객체와 이 객체가 동일한 경우는 true, 그렇지 않은 경우는 false

관련 항목:

Object.hashCode() , Hashtable

hashCode

public int hashCode()

Field 의 해시 코드를 돌려줍니다. 이것은, 기본이 되는 필드의 선언 클래스명과 그 이름의 해시 코드의 배타적 논리합으로서 계산됩니다.

오버라이드(override):

클래스 Object 내의 hashCode

반환값:

이 객체의 해시 코드값

관련 항목:

Object.equals(java.lang.Object) , Hashtable

toString

public String  toString()

Field 를 기술하는 캐릭터 라인을 돌려줍니다. 이 캐릭터 라인의 서식은, 존재하는 경우는 필드의 액세스 수식자, 필드형, 스페이스, 필드를 선언하는 클래스의 완전 수식명, 피리어드, 필드명이 차례로 계속됩니다. 다음에 예를 나타냅니다.

public static final int java.lang.Thread.MIN_PRIORITY
private int java.io.FileDescriptor.fd
 

수식자는, 「Java 언어 스펙」으로 규정된 정규의 순서로 포함됩니다. 즉, 최초로 public,protected, 또는 private, 계속되어 그 이외의 수식자가 static,final,transient,volatile 의 순서로 놓여집니다.

오버라이드(override):

클래스 Object 내의 toString

반환값:

이 객체의 캐릭터 라인 표현

toGenericString

public String  toGenericString()

총칭형을 포함한, 이 Field 를 기술하는 캐릭터 라인을 돌려줍니다. 이 캐릭터 라인의 서식은, (존재하는 경우에는) 필드의 액세스 수식자, 총칭 필드형, 공백, 필드를 선언하는 클래스의 완전 수식명, 피리어드, 필드명이 차례로 계속됩니다.

수식자는, 「Java 언어 스펙」으로 규정된 정규의 순서로 포함됩니다. 즉, 최초로 public,protected, 또는 private, 계속되어 그 이외의 수식자가 static,final,transient,volatile 의 순서로 놓여집니다.

반환값:

총칭형을 포함한, 이 Field 를 기술하는 캐릭터 라인

도입된 버젼:

1.5

get

public Object  get(Object  obj)
           throws IllegalArgumentException ,
                  IllegalAccessException 

지정된 객체에 대해, 이 Field 에 의해 나타내지는 필드의 값을 돌려줍니다. 원시형의 경우, 객체내에 자동적으로 포함되고 나서 돌려주어집니다.

기본이 되는 필드의 값은, 다음에 나타내도록(듯이) 취득됩니다.

기본이 되는 필드가 static 필드인 경우,obj 인수는 무시됩니다. 객체 인수가 null 인 경우가 있습니다.

static 필드가 아닌 경우, 기본이 되는 필드는 인스턴스 필드입니다. 지정된 obj 인수가 null 의 경우, 메소드는 NullPointerException 를 throw 합니다. 지정된 객체가 기본이 되는 필드를 선언하는 클래스 또는 인터페이스의 인스턴스가 아닌 경우, 메소드는 IllegalArgumentException 를 throw 합니다.

이 Field 객체가 Java 언어 액세스 제어를 실시해, 기본이 되는 필드에 액세스 할 수 없는 경우, 메소드는 IllegalAccessException 를 throw 합니다. 기본이 되는 필드가 static 의 경우, 필드를 선언한 클래스가 아직 초기화되어 있지 않을 때는, 이 클래스가 초기화됩니다.

그 이외의 경우, 값은 기본이 되는 인스턴스 또는 static 필드로부터 취득됩니다. 필드에 원시형이 지정되고 있는 경우, 값은 돌려주어지기 전에 객체내에서 랩 됩니다.

필드가 obj 의 형태에 숨겨지고 있는 경우, 필드의 값은 전술의 규칙에 따라 취득됩니다.

파라미터:

obj - 표현되는 필드치의 추출원객체

반환값:

객체 obj 내에서 표현되는 값. 프리미티브(primitive)치는 적절한 객체내에 랩 되고 나서 반환된다

예외:

IllegalAccessException - 기본이 되는 필드에 액세스 할 수 없는 경우

IllegalArgumentException - 지정된 객체가 기본이 되는 필드 (또는 그 서브 클래스나 구현측)를 선언하는 클래스 또는 인터페이스의 인스턴스가 아닌 경우

NullPointerException - 지정된 객체가 null 로, 필드가 인스턴스 필드의 경우

ExceptionInInitializerError - 이 메소드에 의한 초기화가 실패했을 경우

getBoolean

public boolean getBoolean(Object  obj)
                   throws IllegalArgumentException ,
                          IllegalAccessException 

static 또는 인스턴스 boolean 필드의 값을 가져옵니다.

파라미터:

obj - boolean 치의 추출원의 객체

반환값:

boolean 필드의 값

예외:

IllegalAccessException - 기본이 되는 필드에 액세스 할 수 없는 경우

IllegalArgumentException - 지정된 객체가 기본이 되는 필드 (또는 그 서브 클래스나 구현측)를 선언하는 클래스 또는 인터페이스의 인스턴스가 아닌 경우, 혹은 필드의 값이 확대 변환에 의해 boolean 형으로 변환할 수 없는 경우

NullPointerException - 지정된 객체가 null 로, 필드가 인스턴스 필드의 경우

ExceptionInInitializerError - 이 메소드에 의한 초기화가 실패했을 경우

관련 항목:

get(java.lang.Object)

getByte

public byte getByte(Object  obj)
             throws IllegalArgumentException ,
                    IllegalAccessException 

static 또는 인스턴스 byte 필드의 값을 가져옵니다.

파라미터:

obj - byte 치의 추출원의 객체

반환값:

byte 필드의 값

예외:

IllegalAccessException - 기본이 되는 필드에 액세스 할 수 없는 경우

IllegalArgumentException - 지정된 객체가 기본이 되는 필드 (또는 그 서브 클래스나 구현측)를 선언하는 클래스 또는 인터페이스의 인스턴스가 아닌 경우, 혹은 필드의 값이 확대 변환에 의해 byte 형으로 변환할 수 없는 경우

NullPointerException - 지정된 객체가 null 로, 필드가 인스턴스 필드의 경우

ExceptionInInitializerError - 이 메소드에 의한 초기화가 실패했을 경우

관련 항목:

get(java.lang.Object)

getChar

public char getChar(Object  obj)
             throws IllegalArgumentException ,
                    IllegalAccessException 

char 형, 또는 확대 변환에 의해 char 형에 변환 가능한 다른 원시형의 static 또는 인스턴스 필드의 값을 가져옵니다.

파라미터:

obj - char 치의 추출원의 객체

반환값:

char 형에 변환된 필드의 값

예외:

IllegalAccessException - 기본이 되는 필드에 액세스 할 수 없는 경우

IllegalArgumentException - 지정된 객체가 기본이 되는 필드 (또는 그 서브 클래스나 구현측)를 선언하는 클래스 또는 인터페이스의 인스턴스가 아닌 경우, 혹은 필드의 값이 확대 변환에 의해 char 형으로 변환할 수 없는 경우

NullPointerException - 지정된 객체가 null 로, 필드가 인스턴스 필드의 경우

ExceptionInInitializerError - 이 메소드에 의한 초기화가 실패했을 경우

관련 항목:

get(java.lang.Object)

getShort

public short getShort(Object  obj)
               throws IllegalArgumentException ,
                      IllegalAccessException 

short 형, 또는 확대 변환에 의해 short 형에 변환 가능한 다른 원시형의 static 또는 인스턴스 필드의 값을 가져옵니다.

파라미터:

obj - short 치의 추출원의 객체

반환값:

short 형에 변환된 필드의 값

예외:

IllegalAccessException - 기본이 되는 필드에 액세스 할 수 없는 경우

IllegalArgumentException - 지정된 객체가 기본이 되는 필드 (또는 그 서브 클래스나 구현측)를 선언하는 클래스 또는 인터페이스의 인스턴스가 아닌 경우, 혹은 필드의 값이 확대 변환에 의해 short 형으로 변환할 수 없는 경우

NullPointerException - 지정된 객체가 null 로, 필드가 인스턴스 필드의 경우

ExceptionInInitializerError - 이 메소드에 의한 초기화가 실패했을 경우

관련 항목:

get(java.lang.Object)

getInt

public int getInt(Object  obj)
           throws IllegalArgumentException ,
                  IllegalAccessException 

int 형, 또는 확대 변환에 의해 int 형에 변환 가능한 다른 원시형의 static 또는 인스턴스 필드의 값을 가져옵니다.

파라미터:

obj - int 치의 추출원의 객체

반환값:

int 형에 변환된 필드의 값

예외:

IllegalAccessException - 기본이 되는 필드에 액세스 할 수 없는 경우

IllegalArgumentException - 지정된 객체가 기본이 되는 필드 (또는 그 서브 클래스나 구현측)를 선언하는 클래스 또는 인터페이스의 인스턴스가 아닌 경우, 혹은 필드의 값이 확대 변환으로 int 형으로 변환할 수 없는 경우

NullPointerException - 지정된 객체가 null 로, 필드가 인스턴스 필드의 경우

ExceptionInInitializerError - 이 메소드에 의한 초기화가 실패했을 경우

관련 항목:

get(java.lang.Object)

getLong

public long getLong(Object  obj)
             throws IllegalArgumentException ,
                    IllegalAccessException 

long 형, 또는 확대 변환에 의해 long 형에 변환 가능한 다른 원시형의 static 또는 인스턴스 필드의 값을 가져옵니다.

파라미터:

obj - long 치의 추출원의 객체

반환값:

long 형에 변환된 필드의 값

예외:

IllegalAccessException - 기본이 되는 필드에 액세스 할 수 없는 경우

IllegalArgumentException - 지정된 객체가 기본이 되는 필드 (또는 그 서브 클래스나 구현측)를 선언하는 클래스 또는 인터페이스의 인스턴스가 아닌 경우, 혹은 필드의 값이 확대 변환에 의해 long 형으로 변환할 수 없는 경우

NullPointerException - 지정된 객체가 null 로, 필드가 인스턴스 필드의 경우

ExceptionInInitializerError - 이 메소드에 의한 초기화가 실패했을 경우

관련 항목:

get(java.lang.Object)

getFloat

public float getFloat(Object  obj)
               throws IllegalArgumentException ,
                      IllegalAccessException 

float 형, 또는 확대 변환에 의해 float 형에 변환 가능한 다른 원시형의 static 또는 인스턴스 필드의 값을 가져옵니다.

파라미터:

obj - float 치의 추출원의 객체

반환값:

float 형에 변환된 필드의 값

예외:

IllegalAccessException - 기본이 되는 필드에 액세스 할 수 없는 경우

IllegalArgumentException - 지정된 객체가 기본이 되는 필드 (또는 그 서브 클래스나 구현측)를 선언하는 클래스 또는 인터페이스의 인스턴스가 아닌 경우, 혹은 필드의 값이 확대 변환에 의해 float 형으로 변환할 수 없는 경우

NullPointerException - 지정된 객체가 null 로, 필드가 인스턴스 필드의 경우

ExceptionInInitializerError - 이 메소드에 의한 초기화가 실패했을 경우

관련 항목:

get(java.lang.Object)

getDouble

public double getDouble(Object  obj)
                 throws IllegalArgumentException ,
                        IllegalAccessException 

double 형, 또는 확대 변환에 의해 double 형에 변환 가능한 다른 원시형의 static 또는 인스턴스 필드의 값을 가져옵니다.

파라미터:

obj - double 치의 추출원의 객체

반환값:

double 형에 변환된 필드의 값

예외:

IllegalAccessException - 기본이 되는 필드에 액세스 할 수 없는 경우

IllegalArgumentException - 지정된 객체가 기본이 되는 필드 (또는 그 서브 클래스나 구현측)를 선언하는 클래스 또는 인터페이스의 인스턴스가 아닌 경우, 혹은 필드의 값이 확대 변환에 의해 double 형으로 변환할 수 없는 경우

NullPointerException - 지정된 객체가 null 로, 필드가 인스턴스 필드의 경우

ExceptionInInitializerError - 이 메소드에 의한 초기화가 실패했을 경우

관련 항목:

get(java.lang.Object)

set

public void set(Object  obj,
                Object  value)
         throws IllegalArgumentException ,
                IllegalAccessException 

이 Field 객체에 의해 나타내지는 지정된 객체 인수의 필드를, 지정된 새로운 값으로 설정합니다. 기본이 되는 필드에 원시형이 지정되고 있는 경우, 새로운 값은 자동적으로 랩 해제됩니다.

동작은 다음과 같이 진행합니다.

기본이 되는 필드가 static 인 경우,obj 인수는 무시됩니다. 객체 인수가 null 의 경우가 있습니다.

static 가 아닌 경우, 기본이 되는 필드는 인스턴스 필드입니다. 지정된 객체 인수가 null 의 경우, 메소드는 NullPointerException 를 throw 합니다. 지정된 객체 인수가 기본이 되는 필드를 선언하는 클래스 또는 인터페이스의 인스턴스가 아닌 경우, 메소드는 IllegalArgumentException 를 throw 합니다.

이 Field 객체가 Java 언어 액세스 제어를 실시해, 기본이 되는 필드에 액세스 할 수 없는 경우, 메소드는 IllegalAccessException 를 throw 합니다.

기본이 되는 필드가 final 의 경우,setAccessible(true) 가 이 필드에 도착해 유효해, 이 필드가 static 가 아닐 때를 제외해, 메소드는 IllegalAccessException 를 throw 합니다. 이 방법으로 final 필드를 설정하는 것이 유용한 것은, 프로그램외의 부분으로부터 액세스 할 수 있도록(듯이) 하기 전에 공백의 final 필드를 가지는 클래스의 인스턴스를 직렬화 복원이나 재구축을 실시할 때 뿐입니다. 다른 문맥으로 사용하면(자), 프로그램외의 부분이 이 필드의 원의 값을 계속 사용하는 등 의 예측할 수 없는 영향이 발생할 가능성이 있습니다.

기본이 되는 필드가 원시형인 경우, 랩 해제 변환이 시행되어 새로운 값을 원시형의 값으로 변환합니다. 이 시행이 정상적으로 종료하지 않는 경우, 메소드는 IllegalArgumentException 를 throw 합니다.

랩 해제를 한 뒤에, 새로운 값을 항등변환 또는 확대 변환으로 기본이 되는 필드의 형태로 변환할 수 없는 경우, 메소드는 IllegalArgumentException 를 throw 합니다.

기본이 되는 필드가 static 의 경우, 필드를 선언한 클래스가 아직 초기화되어 있지 않을 때는, 이 클래스가 초기화됩니다.

필드는, 랩 해제되고 확대된 새로운 값으로 설정됩니다.

필드가 obj 의 형태에 숨겨지고 있는 경우, 필드의 값은 전술의 규칙에 따라 설정됩니다.

파라미터:

obj - 필드를 변경하는 객체

value - 변경중의 obj 의 새로운 필드치

예외:

IllegalAccessException - 기본이 되는 필드에 액세스 할 수 없는 경우

IllegalArgumentException - 지정된 객체가 기본이 되는 필드 (또는 그 서브 클래스나 구현측)를 선언하는 클래스 또는 인터페이스의 인스턴스가 아닌 경우, 혹은 랩 해제 변환이 실패했을 경우

NullPointerException - 지정된 객체가 null 로, 필드가 인스턴스 필드의 경우

ExceptionInInitializerError - 이 메소드에 의한 초기화가 실패했을 경우

setBoolean

public void setBoolean(Object  obj,
                       boolean z)
                throws IllegalArgumentException ,
                       IllegalAccessException 

지정된 객체에 대해, 필드의 값을 boolean 로서 설정합니다. 이 메소드의 동작은 set(obj, zObj) 와 같습니다. zObj 는 Boolean 객체를 나타내,zObj.booleanValue() == z 입니다.

파라미터:

obj - 필드를 변경하는 객체

z - 변경중의 obj 의 새로운 필드치

예외:

IllegalAccessException - 기본이 되는 필드에 액세스 할 수 없는 경우

IllegalArgumentException - 지정된 객체가 기본이 되는 필드 (또는 그 서브 클래스나 구현측)를 선언하는 클래스 또는 인터페이스의 인스턴스가 아닌 경우, 혹은 랩 해제 변환이 실패했을 경우

NullPointerException - 지정된 객체가 null 로, 필드가 인스턴스 필드의 경우

ExceptionInInitializerError - 이 메소드에 의한 초기화가 실패했을 경우

관련 항목:

set(java.lang.Object, java.lang.Object)

setByte

public void setByte(Object  obj,
                    byte b)
             throws IllegalArgumentException ,
                    IllegalAccessException 

지정된 객체에 대해, 필드의 값을 byte 로서 설정합니다. 이 메소드의 동작은 set(obj, bObj) 와 같습니다. bObj 는 Byte 객체를 나타내,bObj.byteValue() == b 입니다.

파라미터:

obj - 필드를 변경하는 객체

b - 변경중의 obj 의 새로운 필드치

예외:

IllegalAccessException - 기본이 되는 필드에 액세스 할 수 없는 경우

IllegalArgumentException - 지정된 객체가 기본이 되는 필드 (또는 그 서브 클래스나 구현측)를 선언하는 클래스 또는 인터페이스의 인스턴스가 아닌 경우, 혹은 랩 해제 변환이 실패했을 경우

NullPointerException - 지정된 객체가 null 로, 필드가 인스턴스 필드의 경우

ExceptionInInitializerError - 이 메소드에 의한 초기화가 실패했을 경우

관련 항목:

set(java.lang.Object, java.lang.Object)

setChar

public void setChar(Object  obj,
                    char c)
             throws IllegalArgumentException ,
                    IllegalAccessException 

지정된 객체에 대해, 필드의 값을 char 로서 설정합니다. 이 메소드의 동작은 set(obj, cObj) 와 같습니다. cObj 는 Character 객체를 나타내,cObj.charValue() == c 입니다.

파라미터:

obj - 필드를 변경하는 객체

c - 변경중의 obj 의 새로운 필드치

예외:

IllegalAccessException - 기본이 되는 필드에 액세스 할 수 없는 경우

IllegalArgumentException - 지정된 객체가 기본이 되는 필드 (또는 그 서브 클래스나 구현측)를 선언하는 클래스 또는 인터페이스의 인스턴스가 아닌 경우, 혹은 랩 해제 변환이 실패했을 경우

NullPointerException - 지정된 객체가 null 로, 필드가 인스턴스 필드의 경우

ExceptionInInitializerError - 이 메소드에 의한 초기화가 실패했을 경우

관련 항목:

set(java.lang.Object, java.lang.Object)

setShort

public void setShort(Object  obj,
                     short s)
              throws IllegalArgumentException ,
                     IllegalAccessException 

지정된 객체에 대해, 필드의 값을 short 로서 설정합니다. 이 메소드의 동작은 set(obj, sObj) 와 같습니다. sObj 는 Short 객체를 나타내,sObj.shortValue() == s 입니다.

파라미터:

obj - 필드를 변경하는 객체

s - 변경중의 obj 의 새로운 필드치

예외:

IllegalAccessException - 기본이 되는 필드에 액세스 할 수 없는 경우

IllegalArgumentException - 지정된 객체가 기본이 되는 필드 (또는 그 서브 클래스나 구현측)를 선언하는 클래스 또는 인터페이스의 인스턴스가 아닌 경우, 혹은 랩 해제 변환이 실패했을 경우

NullPointerException - 지정된 객체가 null 로, 필드가 인스턴스 필드의 경우

ExceptionInInitializerError - 이 메소드에 의한 초기화가 실패했을 경우

관련 항목:

set(java.lang.Object, java.lang.Object)

setInt

public void setInt(Object  obj,
                   int i)
            throws IllegalArgumentException ,
                   IllegalAccessException 

지정된 객체에 대해, 필드의 값을 int 로서 설정합니다. 이 메소드의 동작은 set(obj, iObj) 와 같습니다. iObj 는 Integer 객체를 나타내,iObj.intValue() == i 입니다.

파라미터:

obj - 필드를 변경하는 객체

i - 변경중의 obj 의 새로운 필드치

예외:

IllegalAccessException - 기본이 되는 필드에 액세스 할 수 없는 경우

IllegalArgumentException - 지정된 객체가 기본이 되는 필드 (또는 그 서브 클래스나 구현측)를 선언하는 클래스 또는 인터페이스의 인스턴스가 아닌 경우, 혹은 랩 해제 변환이 실패했을 경우

NullPointerException - 지정된 객체가 null 로, 필드가 인스턴스 필드의 경우

ExceptionInInitializerError - 이 메소드에 의한 초기화가 실패했을 경우

관련 항목:

set(java.lang.Object, java.lang.Object)

setLong

public void setLong(Object  obj,
                    long l)
             throws IllegalArgumentException ,
                    IllegalAccessException 

지정된 객체에 대해, 필드의 값을 long 로서 설정합니다. 이 메소드의 동작은 set(obj, lObj) 와 같습니다. lObj 는 Long 객체를 나타내,lObj.longValue() == l 입니다.

파라미터:

obj - 필드를 변경하는 객체

l - 변경중의 obj 의 새로운 필드치

예외:

IllegalAccessException - 기본이 되는 필드에 액세스 할 수 없는 경우

IllegalArgumentException - 지정된 객체가 기본이 되는 필드 (또는 그 서브 클래스나 구현측)를 선언하는 클래스 또는 인터페이스의 인스턴스가 아닌 경우, 혹은 랩 해제 변환이 실패했을 경우

NullPointerException - 지정된 객체가 null 로, 필드가 인스턴스 필드의 경우

ExceptionInInitializerError - 이 메소드에 의한 초기화가 실패했을 경우

관련 항목:

set(java.lang.Object, java.lang.Object)

setFloat

public void setFloat(Object  obj,
                     float f)
              throws IllegalArgumentException ,
                     IllegalAccessException 

지정된 객체에 대해, 필드의 값을 float 로서 설정합니다. 이 메소드의 동작은 set(obj, fObj) 와 같습니다. fObj 는 Float 객체를 나타내,fObj.floatValue() == f 입니다.

파라미터:

obj - 필드를 변경하는 객체

f - 변경중의 obj 의 새로운 필드치

예외:

IllegalAccessException - 기본이 되는 필드에 액세스 할 수 없는 경우

IllegalArgumentException - 지정된 객체가 기본이 되는 필드 (또는 그 서브 클래스나 구현측)를 선언하는 클래스 또는 인터페이스의 인스턴스가 아닌 경우, 혹은 랩 해제 변환이 실패했을 경우

NullPointerException - 지정된 객체가 null 로, 필드가 인스턴스 필드의 경우

ExceptionInInitializerError - 이 메소드에 의한 초기화가 실패했을 경우

관련 항목:

set(java.lang.Object, java.lang.Object)

setDouble

public void setDouble(Object  obj,
                      double d)
               throws IllegalArgumentException ,
                      IllegalAccessException 

지정된 객체에 대해, 필드의 값을 double 로서 설정합니다. 이 메소드의 동작은 set(obj, dObj) 와 같습니다. dObj 는 Double 객체를 나타내,dObj.doubleValue() == d 입니다.

파라미터:

obj - 필드를 변경하는 객체

d - 변경중의 obj 의 새로운 필드치

예외:

IllegalAccessException - 기본이 되는 필드에 액세스 할 수 없는 경우

IllegalArgumentException - 지정된 객체가 기본이 되는 필드 (또는 그 서브 클래스나 구현측)를 선언하는 클래스 또는 인터페이스의 인스턴스가 아닌 경우, 혹은 랩 해제 변환이 실패했을 경우

NullPointerException - 지정된 객체가 null 로, 필드가 인스턴스 필드의 경우

ExceptionInInitializerError - 이 메소드에 의한 초기화가 실패했을 경우

관련 항목:

set(java.lang.Object, java.lang.Object)

getAnnotation

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

인터페이스 AnnotatedElement 의 기술:

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

정의:

인터페이스 AnnotatedElement 내의 getAnnotation

오버라이드(override):

클래스 AccessibleObject 내의 getAnnotation

파라미터:

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

반환값:

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

예외:

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

도입된 버젼:

1.5

getDeclaredAnnotations

public Annotation [] getDeclaredAnnotations()

인터페이스 AnnotatedElement 의 기술:

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

정의:

인터페이스 AnnotatedElement 내의 getDeclaredAnnotations

오버라이드(override):

클래스 AccessibleObject 내의 getDeclaredAnnotations

반환값:

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

도입된 버젼:

1.5