Класс Поле

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 находится в безымянном или открытом модуле.

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

• Член является public и D находится в пакете, в котором модуль, содержащий D exports безусловно.

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

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

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

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

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

public Class<?> getDeclaringClass()

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

public String getName()

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

public int getModifiers()

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

public Set<AccessFlag> accessFlags()

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

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()

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

    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()

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

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

public Object get(Object obj) throws IllegalArgumentException, IllegalAccessException

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

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

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

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

Если этот Field объект проверяет контроль доступа языка 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.

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

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

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

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

Если базовое поле имеет примитивный тип, выполняется попытка распаковки преобразования для преобразования нового значения в значение примитивного типа. Если эта попытка завершается неудачно, метод выбрасывает 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

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

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

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

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

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

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

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

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

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

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

Устанавливает значение поля как double на указанном объекте. Этот метод эквивалентен 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.