Класс Field

Объект Field предоставляет информацию о и динамический доступ к одному полю класса или интерфейса. Отражённое поле может быть классовым (статическим) или экземпляром поля.

Field разрешает расширяющие преобразования во время операции доступа get или set, но выбрасывает IllegalArgumentException, если произойдёт сужающее преобразование.

Методы

getDeclaringClass

public Class<?> getDeclaringClass()

Возвращает объект Class, представляющий класс или интерфейс, в котором объявлен поле, представленное этим объектом Field.

Определено в:

getDeclaringClass в интерфейсе Member

Возвращает:

объект, представляющий класс объявления базового члена

getName

public String getName()

Возвращает имя поля, представленного этим объектом Field.

Определено в:

getName в интерфейсе Member

Возвращает:

простое имя базового члена

getModifiers

public int getModifiers()

Возвращает модификаторы языка Java для поля, представленного этим объектом Field , как целое число. Для декодирования модификаторов следует использовать класс Modifier.

Определено в:

getModifiers в интерфейсе Member

Возвращает:

модификаторы языка Java для базового члена

См. также:

Modifier

isEnumConstant

public boolean isEnumConstant()

Возвращает true , если это поле представляет элемент перечисления; в противном случае возвращает false.

Возвращает:

true если и только если это поле представляет элемент перечисления.

С тех пор как:

1.5

isSynthetic

public boolean isSynthetic()

Возвращает true , если это поле является синтетическим; в противном случае возвращает false.

Определено в:

isSynthetic в интерфейсе Member

Возвращает:

true, если и только если это поле является синтетическим по определению спецификации языка Java.

С тех пор как:

1.5

getType

public Class<?> getType()

Возвращает объект Class, идентифицирующий объявленный тип для поля, представленного этим объектом Field.

Возвращает:

объект Class, идентифицирующий объявленный тип поля, представленного этим объектом

getGenericType

public Type getGenericType()

Возвращает:

объект Type, представляющий объявленный тип для поля, представленного этим объектом Field

Исключения:

GenericSignatureFormatError - если сигнатура генерического поля не соответствует формату, указанному в Спецификации виртуальной машины Java™

TypeNotPresentException - если сигнатура генерического типа базового поля ссылается на необъявленный тип

MalformedParameterizedTypeException - если сигнатура генерического типа базового поля ссылается на параметризованный тип, который не может быть создан по какой-либо причине

С тех пор как:

1.5

equals

public boolean equals(Object obj)

Сравнивает этот объект Field со заданным объектом. Возвращает true, если объекты идентичны. Два объекта Field идентичны, если они объявлены одним и тем же классом и имеют одинаковое имя и тип.

Переопределяет:

equals в классе Object

Параметры:

obj - объект-ссылка для сравнения.

Возвращает:

true если этот объект такой же, как аргумент obj; 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()

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

Переопределяет:

toString в классе Object

Возвращает:

строку, описывающую этот объект Field

toGenericString

public String toGenericString()

Возвращает:

строку, описывающую этот объект Field, включая его генерический тип

С тех пор как:

1.5

get

public Object get(Object obj)
           throws IllegalArgumentException,
                  IllegalAccessException

Параметры:

obj - объект, из которого извлекается значение представленного поля

Возвращает:

значение представленного поля в объекте obj; примитивные значения упаковываются в соответствующий объект перед возвратом

Исключения:

IllegalAccessException - если этот объект Field применяет контроль доступа языка Java и базовое поле недоступно.

IllegalArgumentException - если указанный объект не является экземпляром класса или интерфейса, объявляющего базовое поле (или подкласса или имплементатора).

NullPointerException - если указанный объект равен null, а поле является полем экземпляра.

ExceptionInInitializerError - если инициализация, вызванная этим методом, завершилась неудачно.

getBoolean

public boolean getBoolean(Object obj)
                   throws IllegalArgumentException,
                          IllegalAccessException

Получает значение статического или экземпляра поля типа 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

Получает значение статического или экземпляра поля типа 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 с помощью расширяющего преобразования.

Параметры:

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 с помощью расширяющего преобразования.

Параметры:

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 с помощью расширяющего преобразования.

Параметры:

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 с помощью расширяющего преобразования.

Параметры:

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 с помощью расширяющего преобразования.

Параметры:

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 с помощью расширяющего преобразования.

Параметры:

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

Параметры:

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), и если это так, пытается найти одну или несколько аннотаций этого типа, «просматривая» аннотацию-контейнер. Вызывающий этот метод может свободно изменять возвращаемый массив; это не повлияет на массивы, возвращаемые другим вызывающим объектам.

Указано в:

getAnnotationsByType в интерфейсе AnnotatedElement

Переопределяет:

getAnnotationsByType в классе AccessibleObject

Параметры типа:

T - тип аннотации для запроса и возврата, если она присутствует

Параметры:

annotationClass - объект Class, соответствующий типу аннотации

Возвращает:

все аннотации этого элемента для указанного типа аннотации, если они связаны с этим элементом, иначе массив длиной ноль

Исключения:

NullPointerException - если заданный класс аннотации равен null

С версии:

1.8

getDeclaredAnnotations

public Annotation[] getDeclaredAnnotations()

Возвращает аннотации, непосредственно присутствующие в этом элементе. Этот метод игнорирует унаследованные аннотации. Если аннотации, непосредственно присутствующие в этом элементе, отсутствуют, возвращаемое значение представляет собой массив длиной 0. Вызывающий этот метод может свободно изменять возвращаемый массив; это не повлияет на массивы, возвращаемые другим вызывающим объектам.

Указано:

getDeclaredAnnotations в интерфейсе AnnotatedElement

Переопределяет:

getDeclaredAnnotations в классе AccessibleObject

Возвращает:

аннотации, непосредственно присутствующие на этом элементе

getAnnotatedType

public AnnotatedType getAnnotatedType()

Возвращает объект AnnotatedType, представляющий использование типа для указания объявленного типа поля, представленного этим полем.

Возвращает:

объект, представляющий объявленный тип поля, представленного этим полем

С:

1.8