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
- 関連項目:
-
フィールドのサマリー
-
メソッドのサマリー
修飾子と型メソッド説明このフィールドの「アクセス・フラグ」の変更不可能なセットを返します(空の場合もあります)。booleanこのFieldを指定されたオブジェクトと比較します。指定されたオブジェクトについて、このFieldによって表されるフィールドの値を返します。このFieldによって表されるフィールドの宣言型を指定する型の使用を表すAnnotatedTypeオブジェクトを返します。<T extends Annotation>
TgetAnnotation(Class<T> annotationClass) 存在する場合は、この要素の指定された型の注釈を返し、そうでない場合はnullを返します。<T extends Annotation>
T[]getAnnotationsByType(Class<T> annotationClass) この要素に関連付けられている注釈を返します。booleangetBoolean(Object obj) staticまたはインスタンスbooleanフィールドの値を取得します。bytestaticまたはインスタンスbyteフィールドの値を取得します。charchar型、または拡大変換によってchar型に変換可能な別のプリミティブ型のstaticまたはインスタンス・フィールドの値を取得します。Class<?> Fieldオブジェクトによって表されるフィールドを宣言するクラスまたはインタフェースを表すClassオブジェクトを返します。doubledouble型、または拡大変換によってdouble型に変換可能な別のプリミティブ型のstaticまたはインスタンス・フィールドの値を取得します。floatfloat型、または拡大変換によってfloat型に変換可能な別のプリミティブ型のstaticまたはインスタンス・フィールドの値を取得します。Fieldオブジェクトで表されるフィールドの宣言タイプを表すTypeオブジェクトを返します。intint型、または拡大変換によってint型に変換可能な別のプリミティブ型のstaticまたはインスタンス・フィールドの値を取得します。longlong型、または拡大変換によってlong型に変換可能な別のプリミティブ型のstaticまたはインスタンス・フィールドの値を取得します。intFieldオブジェクトによって表されるフィールドのJava言語修飾子を整数として返します。getName()Fieldオブジェクトによって表されるフィールドの名前を返します。shortshort型、または拡大変換によってshort型に変換可能な別のプリミティブ型のstaticまたはインスタンス・フィールドの値を取得します。Class<?> getType()Fieldオブジェクトで表されるフィールドの宣言タイプを識別するClassオブジェクトを返します。inthashCode()このFieldのハッシュ・コードを返します。booleanこのフィールドが列挙型クラスの要素を表す場合はtrueを返し、そうでない場合はfalseを返します。booleanこのフィールドが合成フィールドである場合はtrueを返し、そうでない場合はfalseを返します。voidこのFieldオブジェクトによって表される指定されたオブジェクト引数のフィールドを、指定された新しい値に設定します。voidsetAccessible(boolean flag) この反映オブジェクトのaccessibleフラグを指定されたブール値に設定します。voidsetBoolean(Object obj, boolean z) 指定されたオブジェクトについて、フィールドの値をbooleanとして設定します。void指定されたオブジェクトについて、フィールドの値をbyteとして設定します。void指定されたオブジェクトについて、フィールドの値をcharとして設定します。void指定されたオブジェクトについて、フィールドの値をdoubleとして設定します。void指定されたオブジェクトについて、フィールドの値をfloatとして設定します。void指定されたオブジェクトについて、フィールドの値をintとして設定します。void指定されたオブジェクトについて、フィールドの値をlongとして設定します。void指定されたオブジェクトについて、フィールドの値をshortとして設定します。ジェネリック型を含む、このFieldを記述する文字列を返します。toString()このFieldを記述する文字列を返します。クラスjava.lang.reflect.AccessibleObjectで宣言されたメソッド
canAccess, getAnnotations, getDeclaredAnnotation, getDeclaredAnnotations, getDeclaredAnnotationsByType, isAccessible, isAnnotationPresent, setAccessible, trySetAccessible
-
メソッドの詳細
-
setAccessible
public void setAccessible(boolean flag) クラス:AccessibleObjectからコピーされた説明この反映オブジェクトのaccessibleフラグを指定されたブール値に設定します。 値trueは、Java言語アクセス制御の使用時に、反映されたオブジェクトがチェックを抑制する必要があることを示します。 値falseは、反映されたオブジェクトが使用されるときにJava言語アクセス制御のチェックを強制することを示し、クラスの説明に示されているバリエーションを示します。このメソッドは、
Cクラスの呼び出し側がdeclaring classDのmemberへのアクセスを可能にするために使用されます:-
CとDは同じモジュール内にあります。 - メンバーは
publicであり、Dはパッケージ内のpublicであり、Dexportsを含むモジュールは少なくともCを含むモジュールに含まれます。 - メンバーは
protectedstatic、Dはパッケージ内のpublicであり、Dを含むモジュールは少なくともCを含むモジュールにエクスポートし、CはDのサブクラスです。 -
Dは、少なくともCを含むモジュールにDopensを含むモジュールがパッケージされています。 名前なしモジュールおよびオープン・モジュール内のすべてのパッケージは、すべてのモジュールに対して開かれているため、Dが名前なしモジュールまたはオープン・モジュールにある場合、このメソッドは常に成功します。
このメソッドは、次の場合にのみ
declaring classDのmemberへのアクセスを有効にするために、スタック上にコール元クラスがない「JNIコード」で使用できます:- メンバーは
publicで、DはDexportsが無条件に含まれるパッケージ内のpublicです。
宣言クラスが呼出し側と異なるモジュールにあり、宣言クラスを含むパッケージが呼出し側のモジュールに対して開かれていない場合、このメソッドは、プライベート・メンバー、デフォルトの(package)アクセス権を持つメンバー、保護されたインスタンス・メンバーまたは保護されたコンストラクタへのアクセスを有効にするために使用できません。
このメソッドを使用して、non-modifiable最終フィールドへのwriteアクセスを有効にすることはできません。 次のフィールドは変更できません:
trueがJava言語アクセス制御チェックを抑制して、これらの変更不可能な最終フィールドへのreadアクセスのみを有効にする場合のaccessibleフラグ。セキュリティ・マネージャが存在する場合、その
checkPermissionメソッドが最初にReflectPermission("suppressAccessChecks")権限でコールされます。- オーバーライド:
- クラス
AccessibleObjectのsetAccessible - パラメータ:
flag-accessibleフラグの新しい値- 例外:
InaccessibleObjectException- アクセスを有効にできない場合SecurityException- リクエストがセキュリティ・マネージャによって拒否された場合- 外部仕様
- 関連項目:
-
-
getDeclaringClass
public Class<?> getDeclaringClass()Fieldオブジェクトによって表されるフィールドを宣言するクラスまたはインタフェースを表すClassオブジェクトを返します。- 定義:
getDeclaringClass、インタフェースMember- 戻り値:
- 基本となるメンバーの宣言クラスを表すオブジェクト
-
getName
-
getModifiers
public int getModifiers()Fieldオブジェクトによって表されるフィールドのJava言語修飾子を整数として返します。 修飾子の復号化には、Modifierクラスを使用する必要があります。- 定義:
getModifiers、インタフェースMember- 戻り値:
- 基本となるメンバーのJava言語修飾子
- Java言語仕様を参照してください:
-
「8.3 フィールド宣言」
「9.3 フィールド(定数)宣言」 - 関連項目:
-
accessFlags
public Set<AccessFlag> accessFlags()このフィールドの「アクセス・フラグ」の変更不可能なセットを返します(空の場合もあります)。- 定義:
- インタフェース
Member内のaccessFlags - 戻り値:
- このフィールドの「アクセス・フラグ」の変更不可セット(空の場合あり)
- Java Virtual Machine仕様を参照してください:
-
4.5 フィールド
- 導入されたバージョン:
- 20
- 関連項目:
-
isEnumConstant
public boolean isEnumConstant()このフィールドが列挙型クラスの要素を表す場合はtrueを返し、そうでない場合はfalseを返します。- 戻り値:
- このフィールドが列挙型クラスの要素を表す場合にかぎり
true。 - Java言語仕様を参照してください:
-
8.9.1 enum定数
- 導入されたバージョン:
- 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 Virtual Machine仕様」で指定された形式に準拠していない場合TypeNotPresentException- 基礎となるフィールドのジェネリック・タイプ・シグネチャが、存在しないクラスまたはインタフェース宣言を参照している場合MalformedParameterizedTypeException- 基本となるフィールドのジェネリック・シグネチャが、なんらかの理由によりインスタンス化できないパラメータ化された型を参照する場合- 導入されたバージョン:
- 1.5
-
equals
-
hashCode
-
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- このメソッドによる初期化に失敗した場合。- 関連項目:
-
getByte
public byte getByte(Object obj) throws IllegalArgumentException, IllegalAccessException staticまたはインスタンスbyteフィールドの値を取得します。- パラメータ:
obj-byte値の抽出元のオブジェクト- 戻り値:
byteフィールドの値- 例外:
IllegalAccessException- このFieldオブジェクトがJava言語アクセス制御を実施しており、基本となるフィールドにアクセスできない場合。IllegalArgumentException- 指定されたオブジェクトが基本となるフィールド(またはそのサブクラスか実装側)を宣言するクラスまたはインタフェースのインスタンスではない場合、あるいはフィールドの値が拡大変換によってbyte型に変換できない場合。NullPointerException- 指定されたオブジェクトがnullで、フィールドがインスタンス・フィールドの場合。ExceptionInInitializerError- このメソッドによる初期化に失敗した場合。- 関連項目:
-
getChar
public char getChar(Object obj) throws IllegalArgumentException, IllegalAccessException char型、または拡大変換によってchar型に変換可能な別のプリミティブ型のstaticまたはインスタンス・フィールドの値を取得します。- パラメータ:
obj-char値の抽出元のオブジェクト- 戻り値:
char型に変換されたフィールドの値- 例外:
IllegalAccessException- このFieldオブジェクトがJava言語アクセス制御を実施しており、基本となるフィールドにアクセスできない場合。IllegalArgumentException- 指定されたオブジェクトが基本となるフィールド(またはそのサブクラスか実装側)を宣言するクラスまたはインタフェースのインスタンスではない場合、あるいはフィールドの値が拡大変換によってchar型に変換できない場合。NullPointerException- 指定されたオブジェクトがnullで、フィールドがインスタンス・フィールドの場合。ExceptionInInitializerError- このメソッドによる初期化に失敗した場合。- 関連項目:
-
getShort
public short getShort(Object obj) throws IllegalArgumentException, IllegalAccessException short型、または拡大変換によってshort型に変換可能な別のプリミティブ型のstaticまたはインスタンス・フィールドの値を取得します。- パラメータ:
obj-short値の抽出元のオブジェクト- 戻り値:
short型に変換されたフィールドの値- 例外:
IllegalAccessException- このFieldオブジェクトがJava言語アクセス制御を実施しており、基本となるフィールドにアクセスできない場合。IllegalArgumentException- 指定されたオブジェクトが基本となるフィールド(またはそのサブクラスか実装側)を宣言するクラスまたはインタフェースのインスタンスではない場合、あるいはフィールドの値が拡大変換によってshort型に変換できない場合。NullPointerException- 指定されたオブジェクトがnullで、フィールドがインスタンス・フィールドの場合。ExceptionInInitializerError- このメソッドによる初期化に失敗した場合。- 関連項目:
-
getInt
public int getInt(Object obj) throws IllegalArgumentException, IllegalAccessException int型、または拡大変換によってint型に変換可能な別のプリミティブ型のstaticまたはインスタンス・フィールドの値を取得します。- パラメータ:
obj-int値の抽出元のオブジェクト- 戻り値:
int型に変換されたフィールドの値- 例外:
IllegalAccessException- このFieldオブジェクトがJava言語アクセス制御を実施しており、基本となるフィールドにアクセスできない場合。IllegalArgumentException- 指定されたオブジェクトが基本となるフィールド(またはそのサブクラスか実装側)を宣言するクラスまたはインタフェースのインスタンスではない場合、あるいはフィールドの値が拡大変換によってint型に変換できない場合。NullPointerException- 指定されたオブジェクトがnullで、フィールドがインスタンス・フィールドの場合。ExceptionInInitializerError- このメソッドによる初期化に失敗した場合。- 関連項目:
-
getLong
public long getLong(Object obj) throws IllegalArgumentException, IllegalAccessException long型、または拡大変換によってlong型に変換可能な別のプリミティブ型のstaticまたはインスタンス・フィールドの値を取得します。- パラメータ:
obj-long値の抽出元のオブジェクト- 戻り値:
long型に変換されたフィールドの値- 例外:
IllegalAccessException- このFieldオブジェクトがJava言語アクセス制御を実施しており、基本となるフィールドにアクセスできない場合。IllegalArgumentException- 指定されたオブジェクトが基本となるフィールド(またはそのサブクラスか実装側)を宣言するクラスまたはインタフェースのインスタンスではない場合、あるいはフィールドの値が拡大変換によってlong型に変換できない場合。NullPointerException- 指定されたオブジェクトがnullで、フィールドがインスタンス・フィールドの場合。ExceptionInInitializerError- このメソッドによる初期化に失敗した場合。- 関連項目:
-
getFloat
public float getFloat(Object obj) throws IllegalArgumentException, IllegalAccessException float型、または拡大変換によってfloat型に変換可能な別のプリミティブ型のstaticまたはインスタンス・フィールドの値を取得します。- パラメータ:
obj-float値の抽出元のオブジェクト- 戻り値:
float型に変換されたフィールドの値- 例外:
IllegalAccessException- このFieldオブジェクトがJava言語アクセス制御を実施しており、基本となるフィールドにアクセスできない場合。IllegalArgumentException- 指定されたオブジェクトが基本となるフィールド(またはそのサブクラスか実装側)を宣言するクラスまたはインタフェースのインスタンスではない場合、あるいはフィールドの値が拡大変換によってfloat型に変換できない場合。NullPointerException- 指定されたオブジェクトがnullで、フィールドがインスタンス・フィールドの場合。ExceptionInInitializerError- このメソッドによる初期化に失敗した場合。- 関連項目:
-
getDouble
public double getDouble(Object obj) throws IllegalArgumentException, IllegalAccessException double型、または拡大変換によってdouble型に変換可能な別のプリミティブ型のstaticまたはインスタンス・フィールドの値を取得します。- パラメータ:
obj-double値の抽出元のオブジェクト- 戻り値:
double型に変換されたフィールドの値- 例外:
IllegalAccessException- このFieldオブジェクトがJava言語アクセス制御を実施しており、基本となるフィールドにアクセスできない場合。IllegalArgumentException- 指定されたオブジェクトが基本となるフィールド(またはそのサブクラスか実装側)を宣言するクラスまたはインタフェースのインスタンスではない場合、あるいはフィールドの値が拡大変換によってdouble型に変換できない場合。NullPointerException- 指定されたオブジェクトがnullで、フィールドがインスタンス・フィールドの場合。ExceptionInInitializerError- このメソッドによる初期化に失敗した場合。- 関連項目:
-
set
public void set(Object obj, Object value) throws IllegalArgumentException, IllegalAccessException このFieldオブジェクトによって表される指定されたオブジェクト引数のフィールドを、指定された新しい値に設定します。 基本となるフィールドにプリミティブ型が指定されている場合、新しい値は自動的にラップ解除されます。動作は次のように進行します。
基本となるフィールドがstaticである場合、
obj引数は無視されます。オブジェクト引数がnullの場合があります。そうでない場合、基本となるフィールドはインスタンス・フィールドです。 指定されたオブジェクト引数がnullの場合、メソッドは
NullPointerExceptionをスローします。 指定されたオブジェクト引数が基本となるフィールドを宣言するクラスまたはインタフェースのインスタンスではない場合、メソッドはIllegalArgumentExceptionをスローします。この
FieldオブジェクトがJava言語アクセス制御を実施しており、基本となるフィールドにアクセスできない場合、メソッドはIllegalAccessExceptionをスローします。基礎となるフィールドがfinalの場合、この
Fieldオブジェクトは、次の条件が満たされた場合にのみwriteアクセス権を持ちます:- この
Fieldオブジェクトに対するsetAccessible(true)が成功しました。 - フィールドが静的でない。
- クラスを宣言しているフィールドが「非表示クラス」ではありません。
- クラスを宣言するフィールドが「レコード・クラス」ではありません。
IllegalAccessExceptionをスローします。この方法でfinalフィールドを設定することが有用なのは、プログラムのほかの部分からアクセスできるようにする前に空白のfinalフィールドを持つクラスのインスタンスを直列化復元や再構築を行うときだけです。 ほかのコンテキストで使用すると、プログラムのほかの部分がこのフィールドの元の値を使用し続けるなどの予測できない影響が発生する可能性があります。
基本となるフィールドがプリミティブ型である場合、ラップ解除変換が試行され、新しい値をプリミティブ型の値に変換します。 この試行が正常に終了しない場合、メソッドは
IllegalArgumentExceptionをスローします。ラップ解除が行われたあとに、新しい値を恒等変換または拡大変換で基本となるフィールドの型に変換できない場合、メソッドは
IllegalArgumentExceptionをスローします。基本となるフィールドがstaticの場合、フィールドを宣言したクラスがまだ初期化されていないときは、このクラスが初期化されます。
フィールドは、ラップ解除され拡大された新しい値に設定されます。
フィールドが
objの型に隠されている場合、フィールドの値は前述のルールに従って設定されます。- パラメータ:
obj- フィールドを変更するオブジェクトvalue- 変更中のobjの新しいフィールド値- 例外:
IllegalAccessException- このFieldオブジェクトがJava言語アクセス制御を実施しており、基礎となるフィールドがアクセス不可またはfinalの場合、またはこのFieldオブジェクトに書込みアクセス権がない場合。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の場合、またはこのFieldオブジェクトに書込みアクセス権がない場合。IllegalArgumentException- 指定されたオブジェクトが基本となるフィールド(またはそのサブクラスか実装側)を宣言するクラスまたはインタフェースのインスタンスではない場合、あるいはラップ解除変換が失敗した場合。NullPointerException- 指定されたオブジェクトがnullで、フィールドがインスタンス・フィールドの場合。ExceptionInInitializerError- このメソッドによる初期化に失敗した場合。- 関連項目:
-
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の場合、またはこのFieldオブジェクトに書込みアクセス権がない場合。IllegalArgumentException- 指定されたオブジェクトが基本となるフィールド(またはそのサブクラスか実装側)を宣言するクラスまたはインタフェースのインスタンスではない場合、あるいはラップ解除変換が失敗した場合。NullPointerException- 指定されたオブジェクトがnullで、フィールドがインスタンス・フィールドの場合。ExceptionInInitializerError- このメソッドによる初期化に失敗した場合。- 関連項目:
-
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の場合、またはこのFieldオブジェクトに書込みアクセス権がない場合。IllegalArgumentException- 指定されたオブジェクトが基本となるフィールド(またはそのサブクラスか実装側)を宣言するクラスまたはインタフェースのインスタンスではない場合、あるいはラップ解除変換が失敗した場合。NullPointerException- 指定されたオブジェクトがnullで、フィールドがインスタンス・フィールドの場合。ExceptionInInitializerError- このメソッドによる初期化に失敗した場合。- 関連項目:
-
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の場合、またはこのFieldオブジェクトに書込みアクセス権がない場合。IllegalArgumentException- 指定されたオブジェクトが基本となるフィールド(またはそのサブクラスか実装側)を宣言するクラスまたはインタフェースのインスタンスではない場合、あるいはラップ解除変換が失敗した場合。NullPointerException- 指定されたオブジェクトがnullで、フィールドがインスタンス・フィールドの場合。ExceptionInInitializerError- このメソッドによる初期化に失敗した場合。- 関連項目:
-
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の場合、またはこのFieldオブジェクトに書込みアクセス権がない場合。IllegalArgumentException- 指定されたオブジェクトが基本となるフィールド(またはそのサブクラスか実装側)を宣言するクラスまたはインタフェースのインスタンスではない場合、あるいはラップ解除変換が失敗した場合。NullPointerException- 指定されたオブジェクトがnullで、フィールドがインスタンス・フィールドの場合。ExceptionInInitializerError- このメソッドによる初期化に失敗した場合。- 関連項目:
-
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の場合、またはこのFieldオブジェクトに書込みアクセス権がない場合。IllegalArgumentException- 指定されたオブジェクトが基本となるフィールド(またはそのサブクラスか実装側)を宣言するクラスまたはインタフェースのインスタンスではない場合、あるいはラップ解除変換が失敗した場合。NullPointerException- 指定されたオブジェクトがnullで、フィールドがインスタンス・フィールドの場合。ExceptionInInitializerError- このメソッドによる初期化に失敗した場合。- 関連項目:
-
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の場合、またはこのFieldオブジェクトに書込みアクセス権がない場合。IllegalArgumentException- 指定されたオブジェクトが基本となるフィールド(またはそのサブクラスか実装側)を宣言するクラスまたはインタフェースのインスタンスではない場合、あるいはラップ解除変換が失敗した場合。NullPointerException- 指定されたオブジェクトがnullで、フィールドがインスタンス・フィールドの場合。ExceptionInInitializerError- このメソッドによる初期化に失敗した場合。- 関連項目:
-
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の場合、またはこのFieldオブジェクトに書込みアクセス権がない場合。IllegalArgumentException- 指定されたオブジェクトが基本となるフィールド(またはそのサブクラスか実装側)を宣言するクラスまたはインタフェースのインスタンスではない場合、あるいはラップ解除変換が失敗した場合。NullPointerException- 指定されたオブジェクトがnullで、フィールドがインスタンス・フィールドの場合。ExceptionInInitializerError- このメソッドによる初期化に失敗した場合。- 関連項目:
-
getAnnotation
public <T extends Annotation> T getAnnotation(Class<T> annotationClass) 存在する場合は、この要素の指定された型の注釈を返し、そうでない場合は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)であるかどうかをこのメソッドが検出し、その場合、"検索"がコンテナ注釈を使用してそのタイプの注釈を検索しようとすることです。 このメソッドの呼出し元は、返された配列を自由に変更することができ、これはほかの呼出し元に返された配列に影響を及ぼしません。このメソッドによって返される注釈は宣言注釈であることに注意してください。
- 定義:
getAnnotationsByType、インタフェースAnnotatedElement- オーバーライド:
getAnnotationsByType、クラスAccessibleObject- 型パラメータ:
T- 照会し、存在する場合に返す注釈の型。- パラメータ:
annotationClass- 注釈型に対応するClassオブジェクト- 戻り値:
- この要素に関連付けられている場合は、この要素の指定された注釈型のすべての注釈。そうでない場合は長さ0の配列
- 例外:
NullPointerException- 指定された注釈クラスがnullの場合- 導入されたバージョン:
- 1.8
-
getAnnotatedType
public AnnotatedType getAnnotatedType()このFieldによって表されるフィールドの宣言型を指定する型の使用を表すAnnotatedTypeオブジェクトを返します。- 戻り値:
- このFieldが表すフィールドの宣言型を表すオブジェクト
- 導入されたバージョン:
- 1.8
-