Класс Field

public void setAccessible(boolean flag)

Установите флаг accessible для этого отражённого объекта на указанное булево значение. Значение true указывает, что отражённый объект должен подавлять проверки контроля доступа языка Java при его использовании. Значение false указывает, что отражённый объект должен применять проверки контроля доступа языка Java при его использовании, с отличием, отмеченным в описании класса.

Этот метод может быть использован вызывающим классом C для включения доступа к member поля declaring class D в случае, если выполняются следующие условия:

• C и D находятся в одном модуле.
• Член является public, а D находится в пакете, в котором модуль, содержащий D exports по меньшей мере модулю, содержащему C.
• Член является protected static, D находится в пакете, в котором модуль, содержащий D экспортирует по меньшей мере в модуль, содержащий C, а C является подклассом D.
• D находится в пакете, в котором модуль, содержащий D opens по меньшей мере модулю, содержащему C. Все пакеты в безымянных и открытых модулях открыты для всех модулей, поэтому этот метод всегда выполняется успешно, когда D находится в безымянном или открытом модуле.

Этот метод не может использоваться для включения доступа к закрытым членам, членам с доступом по умолчанию (пакет), защищённым экземплярам членов или защищённым конструкторам, когда класс объявления находится в другом модуле, чем вызывающий, и пакет, содержащий класс объявления, не открыт для модуля вызывающего.

Этот метод не может использоваться для включения записи доступа к неизменяемому конечному полю. Следующие поля являются неизменяемыми:

• статические конечные поля, объявленные в любом классе или интерфейсе
• конечные поля, объявленные в скрытом классе
• конечные поля, объявленные в записи

Флаг accessible при true подавляет проверки контроля доступа языка Java только для включения чтения доступа к этим неизменяемым конечным полям.

Если существует менеджер безопасности, его метод checkPermission сначала вызывается с разрешением ReflectPermission("suppressAccessChecks").

public Class<?> getDeclaringClass()

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

public String getName()

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

public int getModifiers()

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

public boolean isEnumConstant()

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

public boolean isSynthetic()

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

public Class<?> getType()

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

public Type getGenericType()

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

Если объявленный тип поля является параметризованным типом, объект Type должен точно отражать фактические типы аргументов, используемые в исходном коде.

Если тип базового поля является переменной типа или параметризованным типом, он создаётся. В противном случае он разрешается.

public boolean equals(Object obj)

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

public int hashCode()

Возвращает хэш-код для этого объекта Field . Вычисляется как исключительное ИЛИ хэш-кодов имени класса объявления базового поля и его имени.

public String toString()

Возвращает строку, описывающую это поле. Формат: модификаторы доступа к полю (если есть), тип поля, пробел, полное имя класса, объявившего поле, точка и имя поля. Например:

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

Модификаторы упорядочены в соответствии с «Спецификацией языка Java». Это public, protected или private вначале, а затем другие модификаторы в следующем порядке: static, final, transient, volatile.

public String toGenericString()

Возвращает строку, описывающую это поле, включая его дженерик-тип. Формат: модификаторы доступа к полю (если есть), дженерик-тип поля, пробел, полное имя класса, объявившего поле, точка и имя поля.

Модификаторы упорядочены в соответствии с «Спецификацией языка Java». Это public, protected или private вначале, а затем другие модификаторы в следующем порядке: static, final, transient, volatile.

public Object get(Object obj) throws IllegalArgumentException, IllegalAccessException

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

Значение базового поля извлекается следующим образом:

Если базовое поле статическое, аргумент obj игнорируется; он может быть null.

В противном случае, базовое поле - это поле экземпляра. Если указанный аргумент obj равен null, метод выбрасывает исключение NullPointerException. Если указанный объект не является экземпляром класса или интерфейса, объявляющего базовое поле, метод выбрасывает исключение IllegalArgumentException.

Если этот объект проверяет контроль доступа языка Java, и базовое поле недоступно, метод выбрасывает исключение IllegalAccessException. Если базовое поле статическое, класс, объявивший поле, инициализируется, если он ещё не инициализирован.

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

Если поле скрыто в типе obj, значение поля извлекается в соответствии с предыдущими правилами.

public boolean getBoolean(Object obj) throws IllegalArgumentException, IllegalAccessException

Получает значение статического или экземпляра поля boolean.

public byte getByte(Object obj) throws IllegalArgumentException, IllegalAccessException

Получает значение статического или экземпляра поля byte.

public char getChar(Object obj) throws IllegalArgumentException, IllegalAccessException

Получает значение статического или экземпляра поля типа char или другого примитивного типа, преобразуемого в тип char с помощью расширяющего преобразования.

public short getShort(Object obj) throws IllegalArgumentException, IllegalAccessException

Получает значение статического или экземпляра поля типа short или другого примитивного типа, преобразуемого в тип short с помощью расширяющего преобразования.

public int getInt(Object obj) throws IllegalArgumentException, IllegalAccessException

Получает значение статического или экземпляра поля типа int или другого примитивного типа, преобразуемого в тип int с помощью расширяющего преобразования.

public long getLong(Object obj) throws IllegalArgumentException, IllegalAccessException

Получение значения статического или экземпляра поля типа long или другого примитивного типа, преобразуемого к типу long с помощью расширяющего преобразования.

public float getFloat(Object obj) throws IllegalArgumentException, IllegalAccessException

Получение значения статического или экземпляра поля типа float или другого примитивного типа, преобразуемого к типу float с помощью расширяющего преобразования.

public double getDouble(Object obj) throws IllegalArgumentException, IllegalAccessException

Получение значения статического или экземпляра поля типа double или другого примитивного типа, преобразуемого к типу double с помощью расширяющего преобразования.

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

Устанавливает значение поля, представленного этим объектом Field, в указанном объекте аргумента на указанное новое значение. Новое значение автоматически распаковывается, если базовое поле имеет примитивный тип.

Операция выполняется следующим образом:

Если базовое поле статическое, аргумент obj игнорируется; он может быть null.

В противном случае базовое поле является полем экземпляра. Если указанный объект аргумент равен null, метод выбрасывает NullPointerException. Если указанный объект аргумент не является экземпляром класса или интерфейса, объявляющего базовое поле, метод выбрасывает IllegalArgumentException.

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

Если базовое поле является final, этот объект Field имеет доступ для записи тогда и только тогда, когда выполнены следующие условия:

• setAccessible(true) успешно выполнился для этого объекта Field;
• поле не статическое; и
• класс, объявляющий поле, не является скрытым классом; и
• класс, объявляющий поле, не является классом-записью.

Если какое-либо из вышеперечисленных проверок не выполнено, этот метод выбрасывает IllegalAccessException.

Установка final-поля таким способом имеет смысл только во время десериализации или реконструкции экземпляров классов с полями blank final, прежде чем они станут доступными для доступа другим частям программы. Использование в любом другом контексте может иметь непредсказуемые последствия, включая случаи, в которых другие части программы продолжают использовать исходное значение этого поля.

Если базовое поле имеет примитивный тип, пытается выполнить преобразование распаковки для преобразования нового значения в значение примитивного типа. Если эта попытка завершается неудачно, метод выбрасывает IllegalArgumentException.

Если после возможного распаковки новое значение не может быть преобразовано к типу базового поля с помощью идентичного или расширяющего преобразования, метод выбрасывает IllegalArgumentException.

Если базовое поле статическое, класс, который объявлял поле, инициализируется, если он еще не был инициализирован.

Поле устанавливается на возможно распакованное и расширенное новое значение.

Если поле скрыто в типе obj, значение поля устанавливается в соответствии с предыдущими правилами.

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

Устанавливает значение поля как boolean в указанном объекте. Этот метод эквивалентен set(obj, zObj), где zObj - это объект Boolean, и zObj.booleanValue() == z.

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

Устанавливает значение поля как byte в указанном объекте. Этот метод эквивалентен set(obj, bObj), где bObj - это объект Byte, и bObj.byteValue() == b.

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

Устанавливает значение поля в качестве символа на указанном объекте. Этот метод эквивалентен set(obj, cObj), где cObj — объект Character и cObj.charValue() == c.

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

Устанавливает значение поля в качестве короткого целого на указанном объекте. Этот метод эквивалентен set(obj, sObj), где sObj — объект Short и sObj.shortValue() == s.

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

Устанавливает значение поля в качестве целого числа на указанном объекте. Этот метод эквивалентен set(obj, iObj), где iObj — объект Integer и iObj.intValue() == i.

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

Устанавливает значение поля в качестве длинного целого на указанном объекте. Этот метод эквивалентен set(obj, lObj), где lObj — объект Long и lObj.longValue() == l.

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

Устанавливает значение поля в качестве числа с плавающей точкой на указанном объекте. Этот метод эквивалентен set(obj, fObj), где fObj — объект Float и fObj.floatValue() == f.

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

Устанавливает значение поля в качестве двойного числа с плавающей точкой на указанном объекте. Этот метод эквивалентен set(obj, dObj), где dObj — объект Double и dObj.doubleValue() == d.

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

Возвращает аннотацию этого элемента для указанного типа, если такая аннотация есть, иначе null.

Обратите внимание, что любая аннотация, возвращаемая этим методом, является аннотацией объявления.

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

Возвращает аннотации, ассоциированные с этим элементом. Если с этим элементом нет ассоциированных аннотаций, возвращается массив длиной 0. Разница между этим методом и AnnotatedElement.getAnnotation(Class) заключается в том, что этот метод определяет, является ли его аргумент повторяемым типом аннотации (JLS 9.6), и если да, то пытается найти одну или несколько аннотаций этого типа, "просматривая" контейнерную аннотацию. Вызывающий этот метод может свободно изменять возвращаемый массив; это не повлияет на массивы, возвращаемые другим вызывающим сторонам.

Обратите внимание, что любые аннотации, возвращаемые этим методом, являются аннотациями объявления.

public AnnotatedType getAnnotatedType()

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