モジュール java.base

パッケージ 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をスローします。

導入されたバージョン:

1.1

関連項目:

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によって表されるフィールドの値を返します。
AnnotatedType	getAnnotatedType()	このFieldによって表されるフィールドの宣言型を指定する型の使用を表すAnnotatedTypeオブジェクトを返します。
<T extends Annotation> T	getAnnotation(Class<T> annotationClass)	存在する場合は、この要素の指定された型の注釈を返し、そうでない場合はnullを返します。
<T extends Annotation> T[]	getAnnotationsByType(Class<T> annotationClass)	この要素に関連付けられている注釈を返します。
boolean	getBoolean(Object obj)	staticまたはインスタンスbooleanフィールドの値を取得します。
byte	getByte(Object obj)	staticまたはインスタンスbyteフィールドの値を取得します。
char	getChar(Object obj)	char型、または拡大変換によってchar型に変換可能な別のプリミティブ型のstaticまたはインスタンス・フィールドの値を取得します。
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	setAccessible(boolean flag)	このリフレクトされたオブジェクトのaccessibleフラグを、指定されたブール値に設定します。
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で宣言されたメソッド

canAccess, getAnnotations, getDeclaredAnnotation, getDeclaredAnnotations, getDeclaredAnnotationsByType, isAccessible, isAnnotationPresent, setAccessible, trySetAccessible

クラス java.lang.Objectで宣言されたメソッド

clone、finalize、getClass、notify、notifyAll、wait、wait、wait

メソッドの詳細

setAccessible

public void setAccessible(boolean flag)

クラスからコピーされた説明:AccessibleObject

このリフレクトされたオブジェクトのaccessibleフラグを、指定されたブール値に設定します。 trueの値は、リフレクトされたオブジェクトが使用されたときに、Java言語のアクセス制御のチェックを抑制すべきであることを示します。 falseの値は、リフレクトされたオブジェクトが、使用時にJava言語のアクセス制御をチェックし、クラスの説明に記載されているバリエーションを適用する必要があることを示します。

このメソッドは、Cクラスの呼び出し側がdeclaring class Dのmemberへのアクセスを可能にするために使用されます:

• C とDは同じモジュールにあります。
• メンバーはpublicであり、Dはパッケージ内のpublicであり、D exportsを含むモジュールは少なくともCを含むモジュールに含まれます。
• メンバーはprotected static、Dはパッケージ内のpublicであり、Dを含むモジュールは少なくともCを含むモジュールにエクスポートし、CはDのサブクラスです。
• Dは、少なくともCを含むモジュールにD opensを含むモジュールがパッケージされています。 名前のないモジュールとオープン・モジュールのすべてのパッケージはすべてのモジュールに対してオープンであるため、このメソッドは、Dが名前のないモジュールまたはオープン・モジュールにあるときには常に成功します。

このメソッドは、宣言クラスが呼び出し元とは異なるモジュールにあり、宣言クラスを含むパッケージが呼び出し元に対して開かれていない場合に、privateメンバー、デフォルト(package)アクセスを持つメンバー、保護されたインスタンス・メンバー、または保護されたコンストラクタ・モジュール。

セキュリティ・マネージャがある場合、そのcheckPermissionメソッドは最初にReflectPermission("suppressAccessChecks")パーミッションで呼び出されます。

オーバーライド:

クラスAccessibleObjectのsetAccessible

パラメータ:

flag - accessibleフラグの新しい値

例外:

InaccessibleObjectException - アクセスを有効にできない場合

SecurityException - リクエストがセキュリティ・マネージャによって拒否された場合

関連項目:

AccessibleObject.trySetAccessible(), MethodHandles.privateLookupIn(java.lang.Class<?>, java.lang.invoke.MethodHandles.Lookup)

getDeclaringClass

public Class<?> getDeclaringClass()

Fieldオブジェクトによって表されるフィールドを宣言するクラスまたはインタフェースを表すClassオブジェクトを返します。

定義:

getDeclaringClass、インタフェース: Member

戻り値:

基本となるメンバーの宣言クラスを表すオブジェクト

getName

public String getName()

Fieldオブジェクトによって表されるフィールドの名前を返します。

定義:

getName、インタフェース: Member

戻り値:

基本となるメンバーの単純名

getModifiers

public int getModifiers()

Fieldオブジェクトによって表されるフィールドのJava言語修飾子を整数として返します。 修飾子の復号化には、Modifierクラスを使用する必要があります。

定義:

getModifiers、インタフェース: Member

戻り値:

基本となるメンバーのJava言語修飾子

関連項目:

Modifier

isEnumConstant

public boolean isEnumConstant()

このフィールドが列挙型の要素を表す場合はtrueを返し、そうでない場合はfalseを返します。

戻り値:

このフィールドが列挙型の要素を表す場合に限り、true。

導入されたバージョン:

1.5

isSynthetic

public boolean isSynthetic()

このフィールドが合成フィールドである場合はtrueを返し、そうでない場合はfalseを返します。

定義:

isSynthetic、インタフェース: Member

戻り値:

このフィールドが、『Java言語仕様』で定義されている合成フィールドである場合に限り、true

導入されたバージョン:

1.5

getType

public Class<?> getType()

Fieldオブジェクトで表されるフィールドの宣言タイプを識別するClassオブジェクトを返します。

戻り値:

このオブジェクトが表すフィールドの宣言型を識別するClassオブジェクト

getGenericType

public Type getGenericType()

Fieldオブジェクトで表されるフィールドの宣言タイプを表すTypeオブジェクトを返します。

宣言された型のフィールドがパラメータ化された型である場合、返されるTypeオブジェクトは、ソース・コードで使用される実際の型引数を正確に反映する必要があります。

基本となるフィールドの型が、型変数またはパラメータ化された型の場合、仮パラメータ型は作成されます。 そうでない場合、例外タイプは解決されます。

戻り値:

このFieldオブジェクトで表されるフィールドの宣言タイプを表すTypeオブジェクト

例外:

GenericSignatureFormatError - このジェネリック・フィールドのシグネチャが『Java™仮想マシン仕様』で規定される書式に適合しない場合

TypeNotPresentException - 基本となるフィールドのジェネリック型のシグネチャが、存在しない型宣言を参照する場合

MalformedParameterizedTypeException - 基本となるフィールドのジェネリック・シグネチャが、なんらかの理由によりインスタンス化できないパラメータ化された型を参照する場合

導入されたバージョン:

1.5

equals

public boolean equals(Object obj)

このFieldを指定されたオブジェクトと比較します。 オブジェクトが同じ場合にはtrueを返します。 2つのFieldオブジェクトは、同じクラスで宣言され、同じ名前と型を持つ場合に等しいとみなされます。

オーバーライド:

equals 、クラス: Object

パラメータ:

obj - 比較対象の参照オブジェクト。

戻り値:

このオブジェクトがobj引数と同じである場合はtrue、それ以外の場合はfalse。

関連項目:

Object.hashCode()、HashMap

hashCode

public int hashCode()

このFieldのハッシュ・コードを返します。 これは、基本となるフィールドの宣言クラス名とその名前のハッシュ・コードの排他的論理和として計算されます。

オーバーライド:

hashCode 、クラス: Object

戻り値:

このオブジェクトのハッシュ・コード値。

関連項目:

Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)

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。

オーバーライド:

toString 、クラス: Object

戻り値:

このFieldを記述する文字列

Java言語仕様を参照してください:

8.3.1 「フィールド修飾子」

toGenericString

public String toGenericString()

ジェネリック型を含む、このFieldを記述する文字列を返します。 この文字列の書式は、(存在する場合には)フィールドのアクセス修飾子、ジェネリック・フィールド型、空白、フィールドを宣言するクラスの完全指定名、ピリオド、フィールド名が順番に続きます。

修飾子は、『Java言語仕様』で規定された正規の順序で格納されます。 これは、public、protected、またはprivateがまず配置され、次にほかの修飾子が次の順序で続きます: static、final、transient、volatile。

戻り値:

ジェネリック型を含む、このFieldを記述する文字列

Java言語仕様を参照してください:

8.3.1 「フィールド修飾子」

導入されたバージョン:

1.5

get

public Object get(Object obj) throws IllegalArgumentException, IllegalAccessException

指定されたオブジェクトについて、このFieldによって表されるフィールドの値を返します。 プリミティブ型の場合、オブジェクト内に自動的に格納されてから返されます。

基本となるフィールドの値は、次に示すように取得されます。

基本となるフィールドがstaticフィールドである場合、obj引数は無視されます。オブジェクト引数がnullである場合があります。

そうでない場合、基本となるフィールドはインスタンス・フィールドです。 指定されたobj引数がnullの場合、メソッドはNullPointerExceptionをスローします。 指定されたオブジェクトが基本となるフィールドを宣言するクラスまたはインタフェースのインスタンスではない場合、メソッドはIllegalArgumentExceptionをスローします。

このFieldオブジェクトがJava言語アクセス制御を実施しており、基本となるフィールドにアクセスできない場合、メソッドはIllegalAccessExceptionをスローします。 基本となるフィールドがstaticの場合、フィールドを宣言したクラスがまだ初期化されていないときは、このクラスが初期化されます。

それ以外の場合、値は基本となるインスタンスまたはstaticフィールドから取得されます。 フィールドにプリミティブ型が指定されている場合、値は返される前にオブジェクト内でラップされます。

フィールドがobjの型に隠されている場合、フィールドの値は前述のルールに従って取得されます。

パラメータ:

obj - 表現されるフィールド値の抽出元オブジェクト

戻り値:

オブジェクトobj内で表現されるフィールドの値。プリミティブ値は適切なオブジェクト内にラップされてから返される

例外:

IllegalAccessException - このFieldオブジェクトがJava言語アクセス制御を実施しており、基本となるフィールドにアクセスできない場合。

IllegalArgumentException - 指定されたオブジェクトが基本となるフィールド(またはそのサブクラスか実装側)を宣言するクラスまたはインタフェースのインスタンスではない場合。

NullPointerException - 指定されたオブジェクトがnullで、フィールドがインスタンス・フィールドの場合。

ExceptionInInitializerError - このメソッドによる初期化に失敗した場合。

getBoolean

public boolean getBoolean(Object obj) throws IllegalArgumentException, IllegalAccessException

staticまたはインスタンスbooleanフィールドの値を取得します。

パラメータ:

obj - boolean値の抽出元のオブジェクト

戻り値:

booleanフィールドの値

例外:

IllegalAccessException - このFieldオブジェクトがJava言語アクセス制御を実施しており、基本となるフィールドにアクセスできない場合。

IllegalArgumentException - 指定されたオブジェクトが基本となるフィールド(またはそのサブクラスか実装側)を宣言するクラスまたはインタフェースのインスタンスではない場合、あるいはフィールドの値が拡大変換によってboolean型に変換できない場合。

NullPointerException - 指定されたオブジェクトがnullで、フィールドがインスタンス・フィールドの場合。

ExceptionInInitializerError - このメソッドによる初期化に失敗した場合。

関連項目:

get(java.lang.Object)

getByte

public byte getByte(Object obj) throws IllegalArgumentException, IllegalAccessException

staticまたはインスタンスbyteフィールドの値を取得します。

パラメータ:

obj - byte値の抽出元のオブジェクト

戻り値:

byteフィールドの値

例外:

IllegalAccessException - このFieldオブジェクトがJava言語アクセス制御を実施しており、基本となるフィールドにアクセスできない場合。

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 - このFieldオブジェクトがJava言語アクセス制御を実施しており、基本となるフィールドにアクセスできない場合。

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 - このFieldオブジェクトがJava言語アクセス制御を実施しており、基本となるフィールドにアクセスできない場合。

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 - このFieldオブジェクトがJava言語アクセス制御を実施しており、基本となるフィールドにアクセスできない場合。

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 - このFieldオブジェクトがJava言語アクセス制御を実施しており、基本となるフィールドにアクセスできない場合。

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 - このFieldオブジェクトがJava言語アクセス制御を実施しており、基本となるフィールドにアクセスできない場合。

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 - このFieldオブジェクトがJava言語アクセス制御を実施しており、基本となるフィールドにアクセスできない場合。

IllegalArgumentException - 指定されたオブジェクトが基本となるフィールド(またはそのサブクラスか実装側)を宣言するクラスまたはインタフェースのインスタンスではない場合、あるいはフィールドの値が拡大変換によってdouble型に変換できない場合。

NullPointerException - 指定されたオブジェクトがnullで、フィールドがインスタンス・フィールドの場合。

ExceptionInInitializerError - このメソッドによる初期化に失敗した場合。

関連項目:

get(java.lang.Object)

set

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

このFieldオブジェクトによって表される指定されたオブジェクト引数のフィールドを、指定された新しい値に設定します。 基本となるフィールドにプリミティブ型が指定されている場合、新しい値は自動的にラップ解除されます。

動作は次のように進行します。

基本となるフィールドがstaticである場合、obj引数は無視されます。オブジェクト引数がnullの場合があります。

そうでない場合、基本となるフィールドはインスタンス・フィールドです。 指定されたオブジェクト引数がnullの場合、メソッドはNullPointerExceptionをスローします。 指定されたオブジェクト引数が基本となるフィールドを宣言するクラスまたはインタフェースのインスタンスではない場合、メソッドはIllegalArgumentExceptionをスローします。

このFieldオブジェクトがJava言語アクセス制御を実施しており、基本となるフィールドにアクセスできない場合、メソッドはIllegalAccessExceptionをスローします。

基本となるフィールドがfinalである場合、setAccessible(true)がこのFieldオブジェクトについて有効で、このフィールドがstaticでないときを除き、メソッドはIllegalAccessExceptionをスローします。 この方法でfinalフィールドを設定することが有用なのは、プログラムのほかの部分からアクセスできるようにする前に空白のfinalフィールドを持つクラスのインスタンスを直列化復元や再構築を行うときだけです。 ほかのコンテキストで使用すると、プログラムのほかの部分がこのフィールドの元の値を使用し続けるなどの予測できない影響が発生する可能性があります。

基本となるフィールドがプリミティブ型である場合、ラップ解除変換が試行され、新しい値をプリミティブ型の値に変換します。 この試行が正常に終了しない場合、メソッドはIllegalArgumentExceptionをスローします。

ラップ解除が行われたあとに、新しい値を恒等変換または拡大変換で基本となるフィールドの型に変換できない場合、メソッドはIllegalArgumentExceptionをスローします。

基本となるフィールドがstaticの場合、フィールドを宣言したクラスがまだ初期化されていないときは、このクラスが初期化されます。

フィールドは、ラップ解除され拡大された新しい値に設定されます。

フィールドがobjの型に隠されている場合、フィールドの値は前述のルールに従って設定されます。

パラメータ:

obj - フィールドを変更するオブジェクト

value - 変更中のobjの新しいフィールド値

例外:

IllegalAccessException - このFieldオブジェクトがJava言語アクセス制御を実施しており、基本となるフィールドが、アクセス不可能であるかfinalである場合。

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 - このFieldオブジェクトがJava言語アクセス制御を実施しており、基本となるフィールドが、アクセス不可能であるかfinalである場合。

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 - このFieldオブジェクトがJava言語アクセス制御を実施しており、基本となるフィールドが、アクセス不可能であるかfinalである場合。

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 - このFieldオブジェクトがJava言語アクセス制御を実施しており、基本となるフィールドが、アクセス不可能であるかfinalである場合。

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 - このFieldオブジェクトがJava言語アクセス制御を実施しており、基本となるフィールドが、アクセス不可能であるかfinalである場合。

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 - このFieldオブジェクトがJava言語アクセス制御を実施しており、基本となるフィールドが、アクセス不可能であるかfinalである場合。

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 - このFieldオブジェクトがJava言語アクセス制御を実施しており、基本となるフィールドが、アクセス不可能であるかfinalである場合。

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 - このFieldオブジェクトがJava言語アクセス制御を実施しており、基本となるフィールドが、アクセス不可能であるかfinalである場合。

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 - このFieldオブジェクトがJava言語アクセス制御を実施しており、基本となるフィールドが、アクセス不可能であるかfinalである場合。

IllegalArgumentException - 指定されたオブジェクトが基本となるフィールド(またはそのサブクラスか実装側)を宣言するクラスまたはインタフェースのインスタンスではない場合、あるいはラップ解除変換が失敗した場合。

NullPointerException - 指定されたオブジェクトがnullで、フィールドがインスタンス・フィールドの場合。

ExceptionInInitializerError - このメソッドによる初期化に失敗した場合。

関連項目:

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

getAnnotation

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

インタフェースからコピーされた説明: AnnotatedElement

存在する場合は、この要素の指定された型の注釈を返し、そうでない場合はnullを返します。

定義:

getAnnotation、インタフェース: AnnotatedElement

オーバーライド:

getAnnotation、クラス: AccessibleObject

型パラメータ:

T - 照会し、存在する場合に返す注釈の型。

パラメータ:

annotationClass - 注釈型に対応するClassオブジェクト

戻り値:

存在する場合は、この要素の指定された注釈型の注釈。そうでない場合はnull

例外:

NullPointerException - 指定された注釈クラスがnullの場合

導入されたバージョン:

1.5

getAnnotationsByType

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

この要素に関連付けられている注釈を返します。 この要素に関連付けられている注釈がない場合、戻り値は長さ0の配列です。 このメソッドとAnnotatedElement.getAnnotation(Class)の違いは、このメソッドではその引数が繰返し可能な注釈型 (JLS 9.6)であるかどうかが検出され、繰返し可能な注釈型である場合は、コンテナ注釈を調べることで、その型の1つ以上の注釈の検索が試みられることです。 このメソッドの呼出し元は、返された配列を自由に変更することができ、これはほかの呼出し元に返された配列に影響を及ぼしません。

定義:

getAnnotationsByType、インタフェース: AnnotatedElement

オーバーライド:

getAnnotationsByType、クラス: AccessibleObject

型パラメータ:

T - 照会し、存在する場合に返す注釈の型。

パラメータ:

annotationClass - 注釈型に対応するClassオブジェクト

戻り値:

この要素に関連付けられている場合は、この要素の指定された注釈型のすべての注釈。そうでない場合は長さ0の配列

例外:

NullPointerException - 指定された注釈クラスがnullの場合

導入されたバージョン:

1.8

getAnnotatedType

public AnnotatedType getAnnotatedType()

このFieldによって表されるフィールドの宣言型を指定する型の使用を表すAnnotatedTypeオブジェクトを返します。

戻り値:

このFieldが表すフィールドの宣言型を表すオブジェクト

導入されたバージョン:

1.8