Spec-Zone .ru
спецификации, руководства, описания, API
|
public final class Field extends AccessibleObject implements Member
Field
предоставляет информацию о, и динамический доступ к, единственное поле класса или интерфейса. Отраженное поле может быть классом (статическое) поле или поле экземпляра. A Field
разрешения, расширяющие преобразования, чтобы произойти во время того, чтобы получать или установить работу доступа, но броски IllegalArgumentException
если сужающееся преобразование произошло бы.
Модификатор и Тип | Метод и Описание |
---|---|
boolean |
equals(Object obj)
Сравнивает это
Field против указанного объекта. |
Объект |
get(Object obj)
Возвращает значение поля, представленного этим
Field , на указанном объекте. |
<T extends Annotation> |
getAnnotation(Class<T> annotationClass)
Возвраты аннотация этого элемента для указанного типа, если такая аннотация присутствует, еще нуль.
|
boolean |
getBoolean(Object obj)
Получает значение помех или экземпляра
boolean поле. |
byte |
getByte(Object obj)
Получает значение помех или экземпляра
byte поле. |
char |
getChar(Object obj)
Получает значение статического или поля экземпляра типа
char или другого типа примитива, конвертируемого, чтобы ввести char через расширяющееся преобразование. |
Аннотация[] |
getDeclaredAnnotations()
Возвраты все аннотации, которые непосредственно присутствуют на этом элементе.
|
Class<?> |
getDeclaringClass()
Возвраты
Class объект, представляющий класс или интерфейс, который объявляет поле, представленное этим Field объект. |
double |
getDouble(Object obj)
Получает значение статического или поля экземпляра типа
double или другого типа примитива, конвертируемого, чтобы ввести double через расширяющееся преобразование. |
float |
getFloat(Object obj)
Получает значение статического или поля экземпляра типа
float или другого типа примитива, конвертируемого, чтобы ввести float через расширяющееся преобразование. |
Ввести |
getGenericType()
Возвраты a
Type объект, который представляет объявленный тип для поля, представленного этим Field объект. |
int |
getInt(Object obj)
Получает значение статического или поля экземпляра типа
int или другого типа примитива, конвертируемого, чтобы ввести int через расширяющееся преобразование. |
long |
getLong(Object obj)
Получает значение статического или поля экземпляра типа
long или другого типа примитива, конвертируемого, чтобы ввести long через расширяющееся преобразование. |
int |
getModifiers()
Возвращает модификаторы языка Java для поля, представленного этим
Field объект, как целое число. |
Строка |
getName()
Возвращает имя поля, представленного этим
Field объект. |
short |
getShort(Object obj)
Получает значение статического или поля экземпляра типа
short или другого типа примитива, конвертируемого, чтобы ввести short через расширяющееся преобразование. |
Class<?> |
getType()
Возвраты a
Class объект, который идентифицирует объявленный тип для поля, представленного этим Field объект. |
int |
hashCode()
Возвращает хэш-код для этого
Field . |
boolean |
isEnumConstant()
Возвраты
true если это поле представляет элемент перечислимого типа; возвраты false иначе. |
boolean |
isSynthetic()
Возвраты
true если это поле является синтетическим полем; возвраты false иначе. |
void |
set(Object obj, Object value)
Устанавливает поле, представленное этим
Field объект на указанном объектном параметре указанному новому значению. |
void |
setBoolean(Object obj, boolean z)
Устанавливает значение поля как a
boolean на указанном объекте. |
void |
setByte(Object obj, byte b)
Устанавливает значение поля как a
byte на указанном объекте. |
void |
setChar(Object obj, char c)
Устанавливает значение поля как a
char на указанном объекте. |
void |
setDouble(Object obj, double d)
Устанавливает значение поля как a
double на указанном объекте. |
void |
setFloat(Object obj, float f)
Устанавливает значение поля как a
float на указанном объекте. |
void |
setInt(Object obj, int i)
Устанавливает значение поля как
int на указанном объекте. |
void |
setLong(Object obj, long l)
Устанавливает значение поля как a
long на указанном объекте. |
void |
setShort(Object obj, short s)
Устанавливает значение поля как a
short на указанном объекте. |
Строка |
toGenericString()
Возвращает строку, описывающую это
Field , включая его универсальный тип. |
Строка |
toString()
Возвращает строку, описывающую это
Field . |
getAnnotations, isAccessible, isAnnotationPresent, setAccessible, setAccessible
public Class<?> getDeclaringClass()
Class
объект, представляющий класс или интерфейс, который объявляет поле, представленное этим Field
объект.getDeclaringClass
в интерфейсе Member
public String getName()
Field
объект.public int getModifiers()
Field
объект, как целое число. Modifier
класс должен использоваться, чтобы декодировать модификаторы.getModifiers
в интерфейсе Member
Modifier
public boolean isEnumConstant()
true
если это поле представляет элемент перечислимого типа; возвраты false
иначе.true
если и только если это поле представляет элемент перечислимого типа.public boolean isSynthetic()
true
если это поле является синтетическим полем; возвраты false
иначе.isSynthetic
в интерфейсе Member
public Class<?> getType()
Class
объект, который идентифицирует объявленный тип для поля, представленного этим Field
объект.Class
объект, идентифицирующий объявленный тип поля, представляется этим объектомpublic Type getGenericType()
Type
объект, который представляет объявленный тип для поля, представленного этим Field
объект. Если Type
параметризованный тип, Type
возвращенный объект должен точно отразить фактические параметры типа, используемые в исходном коде.
Если тип базового поля является переменной типа или параметризованным типом, это создается. Иначе, это разрешается.
Type
объект, который представляет объявленный тип для поля, представленного этим Field
объектGenericSignatureFormatError
- если универсальная полевая подпись не соответствует формату, определенному в Спецификации Виртуальной машины Java™TypeNotPresentException
- если универсальная подпись типа базового поля ссылается на несуществующее описание типаMalformedParameterizedTypeException
- если универсальная подпись базового поля обращается к параметризованному типу, который нельзя инстанцировать ни по какой причинеpublic boolean equals(Object obj)
Field
против указанного объекта. Возвращает true, если объекты являются тем же самым. Два Field
объекты являются тем же самым, если они были объявлены тем же самым классом и имеют то же самое имя и тип.equals
в классе Object
obj
- ссылочный объект, с которым можно сравниться.true
если этот объект является тем же самым как obj параметром; false
иначе.Object.hashCode()
, HashMap
public int hashCode()
Field
. Это вычисляется как монопольное - или хэш-кодов для объявления базового поля имени класса и его имени.hashCode
в классе Object
Object.equals(java.lang.Object)
, System.identityHashCode(java.lang.Object)
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
.
Field
, включая его универсальный типpublic Object get(Object obj) throws IllegalArgumentException, IllegalAccessException
Field
, на указанном объекте. Значение автоматически обертывается в объект, если у него есть тип примитива. Значение базового поля получается следующим образом:
Если базовое поле является статическим полем, obj
параметр игнорируется; это может быть нуль.
Иначе, базовое поле является полем экземпляра. Если указанное obj
параметром является нуль, метод бросает a NullPointerException
. Если указанный объект не является экземпляром класса или интерфейса, объявляя базовое поле, метод бросает IllegalArgumentException
.
Если это Field
объект осуществляет управление доступом языка Java, и базовое поле недоступно, метод бросает IllegalAccessException
. Если базовое поле статично, класс, который объявил, поле инициализируется, если это не было уже инициализировано.
Иначе, значение получается от базового экземпляра или статического поля. Если у поля есть тип примитива, значение обертывается в объект прежде, чем быть возвращенным, иначе это возвращается, как.
Если поле скрывается в типе obj
, значение поля получается согласно предыдущим правилам.
obj
- объект, из которого должно быть извлечено значение представленного поляobj
; примитивные значения обертываются в соответствующий объект прежде, чем быть возвращеннымIllegalAccessException
- если это Field
объект осуществляет управление доступом языка Java, и базовое поле недоступно.IllegalArgumentException
- если указанный объект не является экземпляром класса или интерфейса, объявляя базовое поле (или подкласс или конструктор этого).NullPointerException
- если указанный объект является нулем, и поле является полем экземпляра.ExceptionInInitializerError
- если инициализация вызывается этим методом сбои.public boolean getBoolean(Object obj) throws IllegalArgumentException, IllegalAccessException
boolean
поле.obj
- объект извлечь boolean
значение отboolean
полеIllegalAccessException
- если это Field
объект осуществляет управление доступом языка Java, и базовое поле недоступно.IllegalArgumentException
- если указанный объект не является экземпляром класса или интерфейса, объявляя базовое поле (или подкласс или конструктор этого), или если значение поля не может быть преобразовано в тип boolean
расширяющимся преобразованием.NullPointerException
- если указанный объект является нулем, и поле является полем экземпляра.ExceptionInInitializerError
- если инициализация вызывается этим методом сбои.get(java.lang.Object)
public byte getByte(Object obj) throws IllegalArgumentException, IllegalAccessException
byte
поле.obj
- объект извлечь byte
значение отbyte
полеIllegalAccessException
- если это Field
объект осуществляет управление доступом языка Java, и базовое поле недоступно.IllegalArgumentException
- если указанный объект не является экземпляром класса или интерфейса, объявляя базовое поле (или подкласс или конструктор этого), или если значение поля не может быть преобразовано в тип byte
расширяющимся преобразованием.NullPointerException
- если указанный объект является нулем, и поле является полем экземпляра.ExceptionInInitializerError
- если инициализация вызывается этим методом сбои.get(java.lang.Object)
public char getChar(Object obj) throws IllegalArgumentException, IllegalAccessException
char
или другого типа примитива, конвертируемого, чтобы ввести char
через расширяющееся преобразование.obj
- объект извлечь char
значение отchar
IllegalAccessException
- если это Field
объект осуществляет управление доступом языка Java, и базовое поле недоступно.IllegalArgumentException
- если указанный объект не является экземпляром класса или интерфейса, объявляя базовое поле (или подкласс или конструктор этого), или если значение поля не может быть преобразовано в тип char
расширяющимся преобразованием.NullPointerException
- если указанный объект является нулем, и поле является полем экземпляра.ExceptionInInitializerError
- если инициализация вызывается этим методом сбои.get(java.lang.Object)
public short getShort(Object obj) throws IllegalArgumentException, IllegalAccessException
short
или другого типа примитива, конвертируемого, чтобы ввести short
через расширяющееся преобразование.obj
- объект извлечь short
значение отshort
IllegalAccessException
- если это Field
объект осуществляет управление доступом языка Java, и базовое поле недоступно.IllegalArgumentException
- если указанный объект не является экземпляром класса или интерфейса, объявляя базовое поле (или подкласс или конструктор этого), или если значение поля не может быть преобразовано в тип short
расширяющимся преобразованием.NullPointerException
- если указанный объект является нулем, и поле является полем экземпляра.ExceptionInInitializerError
- если инициализация вызывается этим методом сбои.get(java.lang.Object)
public int getInt(Object obj) throws IllegalArgumentException, IllegalAccessException
int
или другого типа примитива, конвертируемого, чтобы ввести int
через расширяющееся преобразование.obj
- объект извлечь int
значение отint
IllegalAccessException
- если это Field
объект осуществляет управление доступом языка Java, и базовое поле недоступно.IllegalArgumentException
- если указанный объект не является экземпляром класса или интерфейса, объявляя базовое поле (или подкласс или конструктор этого), или если значение поля не может быть преобразовано в тип int
расширяющимся преобразованием.NullPointerException
- если указанный объект является нулем, и поле является полем экземпляра.ExceptionInInitializerError
- если инициализация вызывается этим методом сбои.get(java.lang.Object)
public long getLong(Object obj) throws IllegalArgumentException, IllegalAccessException
long
или другого типа примитива, конвертируемого, чтобы ввести long
через расширяющееся преобразование.obj
- объект извлечь long
значение отlong
IllegalAccessException
- если это Field
объект осуществляет управление доступом языка Java, и базовое поле недоступно.IllegalArgumentException
- если указанный объект не является экземпляром класса или интерфейса, объявляя базовое поле (или подкласс или конструктор этого), или если значение поля не может быть преобразовано в тип long
расширяющимся преобразованием.NullPointerException
- если указанный объект является нулем, и поле является полем экземпляра.ExceptionInInitializerError
- если инициализация вызывается этим методом сбои.get(java.lang.Object)
public float getFloat(Object obj) throws IllegalArgumentException, IllegalAccessException
float
или другого типа примитива, конвертируемого, чтобы ввести float
через расширяющееся преобразование.obj
- объект извлечь float
значение отfloat
IllegalAccessException
- если это Field
объект осуществляет управление доступом языка Java, и базовое поле недоступно.IllegalArgumentException
- если указанный объект не является экземпляром класса или интерфейса, объявляя базовое поле (или подкласс или конструктор этого), или если значение поля не может быть преобразовано в тип float
расширяющимся преобразованием.NullPointerException
- если указанный объект является нулем, и поле является полем экземпляра.ExceptionInInitializerError
- если инициализация вызывается этим методом сбои.get(java.lang.Object)
public double getDouble(Object obj) throws IllegalArgumentException, IllegalAccessException
double
или другого типа примитива, конвертируемого, чтобы ввести double
через расширяющееся преобразование.obj
- объект извлечь double
значение отdouble
IllegalAccessException
- если это Field
объект осуществляет управление доступом языка Java, и базовое поле недоступно.IllegalArgumentException
- если указанный объект не является экземпляром класса или интерфейса, объявляя базовое поле (или подкласс или конструктор этого), или если значение поля не может быть преобразовано в тип double
расширяющимся преобразованием.NullPointerException
- если указанный объект является нулем, и поле является полем экземпляра.ExceptionInInitializerError
- если инициализация вызывается этим методом сбои.get(java.lang.Object)
public void set(Object obj, Object value) throws IllegalArgumentException, IllegalAccessException
Field
объект на указанном объектном параметре указанному новому значению. Новое значение автоматически разворачивается, если у базового поля есть тип примитива. Работа продолжается следующим образом:
Если базовое поле статично, obj
параметр игнорируется; это может быть нуль.
Иначе базовое поле является полем экземпляра. Если указанным объектным параметром является нуль, метод бросает a NullPointerException
. Если указанным объектным параметром не является экземпляр класса или интерфейса, объявляя базовое поле, метод бросает IllegalArgumentException
.
Если это Field
объект осуществляет управление доступом языка Java, и базовое поле недоступно, метод бросает IllegalAccessException
.
Если базовое поле является заключительным, метод бросает IllegalAccessException
если setAccessible(true)
успешно выполнился для этого Field
возразите и поле нестатично. Установка заключительного поля таким образом значима только во время десериализации или реконструкции экземпляров классов с пустыми заключительными полями, прежде, чем они будут сделаны доступными для доступа другими частями программы. Использование в любом другом контексте может иметь непредсказуемые эффекты, включая случаи, в которых другие части программы продолжают использовать исходное значение этого поля.
Если базовое поле имеет тип примитива, преобразование разворачивания предпринимается, чтобы преобразовать новое значение в значение типа примитива. Если эта попытка перестала работать, метод бросает IllegalArgumentException
.
Если после возможного разворачивания новое значение не может быть преобразовано в тип базового поля идентификационными данными или расширяющимся преобразованием, метод бросает IllegalArgumentException
.
Если базовое поле статично, класс, который объявил, поле инициализируется, если это не было уже инициализировано.
Поле устанавливается в возможно развернутый и расширило новое значение.
Если поле скрывается в типе obj
, значение поля устанавливается согласно предыдущим правилам.
obj
- объект, поле которого должно быть измененоvalue
- новое значение для поля obj
быть измененнымIllegalAccessException
- если это Field
объект осуществляет управление доступом языка Java, и базовое поле является или недоступным или заключительным.IllegalArgumentException
- если указанный объект не является экземпляром класса или интерфейса, объявляя базовое поле (или подкласс или конструктор этого), или если преобразование разворачивания перестало работать.NullPointerException
- если указанный объект является нулем, и поле является полем экземпляра.ExceptionInInitializerError
- если инициализация вызывается этим методом сбои.public void setBoolean(Object obj, boolean z) throws IllegalArgumentException, IllegalAccessException
boolean
на указанном объекте. Этот метод эквивалентен set(obj, zObj)
, где zObj
a Boolean
объект и zObj.booleanValue() == z
.obj
- объект, поле которого должно быть измененоz
- новое значение для поля obj
быть измененнымIllegalAccessException
- если это Field
объект осуществляет управление доступом языка Java, и базовое поле является или недоступным или заключительным.IllegalArgumentException
- если указанный объект не является экземпляром класса или интерфейса, объявляя базовое поле (или подкласс или конструктор этого), или если преобразование разворачивания перестало работать.NullPointerException
- если указанный объект является нулем, и поле является полем экземпляра.ExceptionInInitializerError
- если инициализация вызывается этим методом сбои.set(java.lang.Object, java.lang.Object)
public void setByte(Object obj, byte b) throws IllegalArgumentException, IllegalAccessException
byte
на указанном объекте. Этот метод эквивалентен set(obj, bObj)
, где bObj
a Byte
объект и bObj.byteValue() == b
.obj
- объект, поле которого должно быть измененоb
- новое значение для поля obj
быть измененнымIllegalAccessException
- если это Field
объект осуществляет управление доступом языка Java, и базовое поле является или недоступным или заключительным.IllegalArgumentException
- если указанный объект не является экземпляром класса или интерфейса, объявляя базовое поле (или подкласс или конструктор этого), или если преобразование разворачивания перестало работать.NullPointerException
- если указанный объект является нулем, и поле является полем экземпляра.ExceptionInInitializerError
- если инициализация вызывается этим методом сбои.set(java.lang.Object, java.lang.Object)
public void setChar(Object obj, char c) throws IllegalArgumentException, IllegalAccessException
char
на указанном объекте. Этот метод эквивалентен set(obj, cObj)
, где cObj
a Character
объект и cObj.charValue() == c
.obj
- объект, поле которого должно быть измененоc
- новое значение для поля obj
быть измененнымIllegalAccessException
- если это Field
объект осуществляет управление доступом языка Java, и базовое поле является или недоступным или заключительным.IllegalArgumentException
- если указанный объект не является экземпляром класса или интерфейса, объявляя базовое поле (или подкласс или конструктор этого), или если преобразование разворачивания перестало работать.NullPointerException
- если указанный объект является нулем, и поле является полем экземпляра.ExceptionInInitializerError
- если инициализация вызывается этим методом сбои.set(java.lang.Object, java.lang.Object)
public void setShort(Object obj, short s) throws IllegalArgumentException, IllegalAccessException
short
на указанном объекте. Этот метод эквивалентен set(obj, sObj)
, где sObj
a Short
объект и sObj.shortValue() == s
.obj
- объект, поле которого должно быть измененоs
- новое значение для поля obj
быть измененнымIllegalAccessException
- если это Field
объект осуществляет управление доступом языка Java, и базовое поле является или недоступным или заключительным.IllegalArgumentException
- если указанный объект не является экземпляром класса или интерфейса, объявляя базовое поле (или подкласс или конструктор этого), или если преобразование разворачивания перестало работать.NullPointerException
- если указанный объект является нулем, и поле является полем экземпляра.ExceptionInInitializerError
- если инициализация вызывается этим методом сбои.set(java.lang.Object, java.lang.Object)
public void setInt(Object obj, int i) throws IllegalArgumentException, IllegalAccessException
int
на указанном объекте. Этот метод эквивалентен set(obj, iObj)
, где iObj
a Integer
объект и iObj.intValue() == i
.obj
- объект, поле которого должно быть измененоi
- новое значение для поля obj
быть измененнымIllegalAccessException
- если это Field
объект осуществляет управление доступом языка Java, и базовое поле является или недоступным или заключительным.IllegalArgumentException
- если указанный объект не является экземпляром класса или интерфейса, объявляя базовое поле (или подкласс или конструктор этого), или если преобразование разворачивания перестало работать.NullPointerException
- если указанный объект является нулем, и поле является полем экземпляра.ExceptionInInitializerError
- если инициализация вызывается этим методом сбои.set(java.lang.Object, java.lang.Object)
public void setLong(Object obj, long l) throws IllegalArgumentException, IllegalAccessException
long
на указанном объекте. Этот метод эквивалентен set(obj, lObj)
, где lObj
a Long
объект и lObj.longValue() == l
.obj
- объект, поле которого должно быть измененоl
- новое значение для поля obj
быть измененнымIllegalAccessException
- если это Field
объект осуществляет управление доступом языка Java, и базовое поле является или недоступным или заключительным.IllegalArgumentException
- если указанный объект не является экземпляром класса или интерфейса, объявляя базовое поле (или подкласс или конструктор этого), или если преобразование разворачивания перестало работать.NullPointerException
- если указанный объект является нулем, и поле является полем экземпляра.ExceptionInInitializerError
- если инициализация вызывается этим методом сбои.set(java.lang.Object, java.lang.Object)
public void setFloat(Object obj, float f) throws IllegalArgumentException, IllegalAccessException
float
на указанном объекте. Этот метод эквивалентен set(obj, fObj)
, где fObj
a Float
объект и fObj.floatValue() == f
.obj
- объект, поле которого должно быть измененоf
- новое значение для поля obj
быть измененнымIllegalAccessException
- если это Field
объект осуществляет управление доступом языка Java, и базовое поле является или недоступным или заключительным.IllegalArgumentException
- если указанный объект не является экземпляром класса или интерфейса, объявляя базовое поле (или подкласс или конструктор этого), или если преобразование разворачивания перестало работать.NullPointerException
- если указанный объект является нулем, и поле является полем экземпляра.ExceptionInInitializerError
- если инициализация вызывается этим методом сбои.set(java.lang.Object, java.lang.Object)
public void setDouble(Object obj, double d) throws IllegalArgumentException, IllegalAccessException
double
на указанном объекте. Этот метод эквивалентен set(obj, dObj)
, где dObj
a Double
объект и dObj.doubleValue() == d
.obj
- объект, поле которого должно быть измененоd
- новое значение для поля obj
быть измененнымIllegalAccessException
- если это Field
объект осуществляет управление доступом языка Java, и базовое поле является или недоступным или заключительным.IllegalArgumentException
- если указанный объект не является экземпляром класса или интерфейса, объявляя базовое поле (или подкласс или конструктор этого), или если преобразование разворачивания перестало работать.NullPointerException
- если указанный объект является нулем, и поле является полем экземпляра.ExceptionInInitializerError
- если инициализация вызывается этим методом сбои.set(java.lang.Object, java.lang.Object)
public <T extends Annotation> T getAnnotation(Class<T> annotationClass)
AnnotatedElement
getAnnotation
в интерфейсе AnnotatedElement
getAnnotation
в классе AccessibleObject
annotationClass
- соответствие объекта Класса типу аннотацииNullPointerException
- если данный класс аннотации является нулемpublic Annotation[] getDeclaredAnnotations()
AnnotatedElement
getDeclaredAnnotations
в интерфейсе AnnotatedElement
getDeclaredAnnotations
в классе AccessibleObject
Для дальнейшей ссылки API и документации разработчика, см.
Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.