|
Spec-Zone .ru
спецификации, руководства, описания, API
|
public final class Field extends AccessibleObject implements Member
Field предоставляет информацию о, и динамический доступ к, единственное поле class или интерфейса. Отраженным полем может быть class (статическое) поле или поле экземпляра. A Field разрешения, расширяющие преобразования, чтобы произойти во время того, чтобы получать или установить работу доступа, но броски IllegalArgumentException если сужающееся преобразование произошло бы.
| Модификатор и Тип | Метод и Описание |
|---|---|
boolean |
equals(Object obj)
Сравнивает это
Field против указанного объекта. |
Объект |
get(Object obj)
Возвращает значение поля, представленного этим
Field, на указанном объекте. |
AnnotatedType |
getAnnotatedType()
Возвращает объект AnnotatedType, который представляет использование типа, чтобы определить объявленный тип поля, представленного этим Полем.
|
<T extends Annotation> |
getAnnotation(Class<T> annotationClass)
Возвраты аннотация этого элемента для указанного типа, если такая аннотация присутствует, еще нуль.
|
<T extends Annotation> |
getAnnotationsByType(Class<T> annotationClass)
Аннотации возвратов, которые присутствуют на этом элементе.
|
boolean |
getBoolean(Object obj)
Получает значение помех или экземпляра
boolean поле. |
byte |
getByte(Object obj)
Получает значение помех или экземпляра
byte поле. |
char |
getChar(Object obj)
Получает значение статического или поля экземпляра типа
char или другого типа примитива, конвертируемого, чтобы ввести char через расширяющееся преобразование. |
Аннотация[] |
getDeclaredAnnotations()
Аннотации возвратов, которые непосредственно присутствуют на этом элементе.
|
Class<?> |
getDeclaringClass()
Возвраты
Class объект, представляющий 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, getDeclaredAnnotation, getDeclaredAnnotationsByType, isAccessible, isAnnotationPresent, setAccessible, setAccessiblepublic Class<?> getDeclaringClass()
Class объект, представляющий class или интерфейс, который объявляет поле, представленное этим Field объект.getDeclaringClass в интерфейсе Memberpublic String getName()
Field объект.public int getModifiers()
Field объект, как целое число. Modifier class должен использоваться, чтобы декодировать модификаторы.getModifiers в интерфейсе MemberModifierpublic boolean isEnumConstant()
true если это поле представляет элемент перечислимого типа; возвраты false иначе.true если и только если это поле представляет элемент перечислимого типа.public boolean isSynthetic()
true если это поле является синтетическим полем; возвраты false иначе.isSynthetic в интерфейсе Memberpublic 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 объекты являются тем же самым, если они были объявлены тем же самым class и имеют то же самое имя и тип.equals в class Objectobj - ссылочный объект, с которым можно сравниться.true если этот объект является тем же самым как obj параметром; false иначе.Object.hashCode(), HashMappublic int hashCode()
Field. Это вычисляется как монопольное - или хэш-кодов для объявления базового поля имени class и его имени.hashCode в class ObjectObject.equals(java.lang.Object), System.identityHashCode(java.lang.Object)public String toString()
Field. Формат является модификаторами доступа для поля, если таковые вообще имеются, сопровождаемый типом поля, сопровождаемым пространством, сопровождаемым полностью определенным именем class, объявляя поле, сопровождаемое периодом, сопровождаемым именем поля. Например:
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, включая его универсальный тип. Формат является модификаторами доступа для поля, если таковые вообще имеются, сопровождаемый универсальным типом поля, сопровождаемым пространством, сопровождаемым полностью определенным именем class, объявляя поле, сопровождаемое периодом, сопровождаемым именем поля. Модификаторы помещаются в канонический порядок как определено "Спецификацией языка Java". Это public, protected или private во-первых, и затем другие модификаторы в следующем порядке: static, final, transient, volatile.
Field, включая его универсальный типpublic Object get(Object obj) throws IllegalArgumentException, IllegalAccessException
Field, на указанном объекте. Значение автоматически обертывается в объект, если у него есть тип примитива. Значение базового поля получается следующим образом:
Если базовое поле является статическим полем, obj параметр игнорируется; это может быть нуль.
Иначе, базовое поле является полем экземпляра. Если указанное obj параметром является нуль, метод бросает a NullPointerException. Если указанный объект не является экземпляром class или интерфейса, объявляя базовое поле, метод бросает IllegalArgumentException.
Если это Field объект осуществляет управление доступом языка Java, и базовое поле недоступно, метод бросает IllegalAccessException. Если базовое поле статично, class, который объявил, поле инициализируется, если это не было уже инициализировано.
Иначе, значение получается от базового экземпляра или статического поля. Если у поля есть тип примитива, значение обертывается в объект прежде, чем быть возвращенным, иначе это возвращается, как.
Если поле скрывается в типе obj, значение поля получается согласно предыдущим правилам.
obj - объект, из которого должно быть извлечено значение представленного поляobj; примитивные значения обертываются в соответствующий объект прежде, чем быть возвращеннымIllegalAccessException - если это Field объект осуществляет управление доступом языка Java, и базовое поле недоступно.IllegalArgumentException - если указанный объект не является экземпляром class или интерфейса, объявляя базовое поле (или подкласс или конструктор этого).NullPointerException - если указанный объект является нулем, и поле является полем экземпляра.ExceptionInInitializerError - если инициализация вызывается этим методом сбои.public boolean getBoolean(Object obj) throws IllegalArgumentException, IllegalAccessException
boolean поле.obj - объект извлечь boolean значение отboolean полеIllegalAccessException - если это Field объект осуществляет управление доступом языка Java, и базовое поле недоступно.IllegalArgumentException - если указанный объект не является экземпляром class или интерфейса, объявляя базовое поле (или подкласс или конструктор этого), или если значение поля не может быть преобразовано в тип boolean расширяющимся преобразованием.NullPointerException - если указанный объект является нулем, и поле является полем экземпляра.ExceptionInInitializerError - если инициализация вызывается этим методом сбои.get(java.lang.Object)public byte getByte(Object obj) throws IllegalArgumentException, IllegalAccessException
byte поле.obj - объект извлечь byte значение отbyte полеIllegalAccessException - если это Field объект осуществляет управление доступом языка Java, и базовое поле недоступно.IllegalArgumentException - если указанный объект не является экземпляром class или интерфейса, объявляя базовое поле (или подкласс или конструктор этого), или если значение поля не может быть преобразовано в тип byte расширяющимся преобразованием.NullPointerException - если указанный объект является нулем, и поле является полем экземпляра.ExceptionInInitializerError - если инициализация вызывается этим методом сбои.get(java.lang.Object)public char getChar(Object obj) throws IllegalArgumentException, IllegalAccessException
char или другого типа примитива, конвертируемого, чтобы ввести char через расширяющееся преобразование.obj - объект извлечь char значение отcharIllegalAccessException - если это Field объект осуществляет управление доступом языка Java, и базовое поле недоступно.IllegalArgumentException - если указанный объект не является экземпляром class или интерфейса, объявляя базовое поле (или подкласс или конструктор этого), или если значение поля не может быть преобразовано в тип char расширяющимся преобразованием.NullPointerException - если указанный объект является нулем, и поле является полем экземпляра.ExceptionInInitializerError - если инициализация вызывается этим методом сбои.get(java.lang.Object)public short getShort(Object obj) throws IllegalArgumentException, IllegalAccessException
short или другого типа примитива, конвертируемого, чтобы ввести short через расширяющееся преобразование.obj - объект извлечь short значение отshortIllegalAccessException - если это Field объект осуществляет управление доступом языка Java, и базовое поле недоступно.IllegalArgumentException - если указанный объект не является экземпляром class или интерфейса, объявляя базовое поле (или подкласс или конструктор этого), или если значение поля не может быть преобразовано в тип short расширяющимся преобразованием.NullPointerException - если указанный объект является нулем, и поле является полем экземпляра.ExceptionInInitializerError - если инициализация вызывается этим методом сбои.get(java.lang.Object)public int getInt(Object obj) throws IllegalArgumentException, IllegalAccessException
int или другого типа примитива, конвертируемого, чтобы ввести int через расширяющееся преобразование.obj - объект извлечь int значение отintIllegalAccessException - если это Field объект осуществляет управление доступом языка Java, и базовое поле недоступно.IllegalArgumentException - если указанный объект не является экземпляром class или интерфейса, объявляя базовое поле (или подкласс или конструктор этого), или если значение поля не может быть преобразовано в тип int расширяющимся преобразованием.NullPointerException - если указанный объект является нулем, и поле является полем экземпляра.ExceptionInInitializerError - если инициализация вызывается этим методом сбои.get(java.lang.Object)public long getLong(Object obj) throws IllegalArgumentException, IllegalAccessException
long или другого типа примитива, конвертируемого, чтобы ввести long через расширяющееся преобразование.obj - объект извлечь long значение отlongIllegalAccessException - если это Field объект осуществляет управление доступом языка Java, и базовое поле недоступно.IllegalArgumentException - если указанный объект не является экземпляром class или интерфейса, объявляя базовое поле (или подкласс или конструктор этого), или если значение поля не может быть преобразовано в тип long расширяющимся преобразованием.NullPointerException - если указанный объект является нулем, и поле является полем экземпляра.ExceptionInInitializerError - если инициализация вызывается этим методом сбои.get(java.lang.Object)public float getFloat(Object obj) throws IllegalArgumentException, IllegalAccessException
float или другого типа примитива, конвертируемого, чтобы ввести float через расширяющееся преобразование.obj - объект извлечь float значение отfloatIllegalAccessException - если это Field объект осуществляет управление доступом языка Java, и базовое поле недоступно.IllegalArgumentException - если указанный объект не является экземпляром class или интерфейса, объявляя базовое поле (или подкласс или конструктор этого), или если значение поля не может быть преобразовано в тип float расширяющимся преобразованием.NullPointerException - если указанный объект является нулем, и поле является полем экземпляра.ExceptionInInitializerError - если инициализация вызывается этим методом сбои.get(java.lang.Object)public double getDouble(Object obj) throws IllegalArgumentException, IllegalAccessException
double или другого типа примитива, конвертируемого, чтобы ввести double через расширяющееся преобразование.obj - объект извлечь double значение отdoubleIllegalAccessException - если это Field объект осуществляет управление доступом языка Java, и базовое поле недоступно.IllegalArgumentException - если указанный объект не является экземпляром class или интерфейса, объявляя базовое поле (или подкласс или конструктор этого), или если значение поля не может быть преобразовано в тип double расширяющимся преобразованием.NullPointerException - если указанный объект является нулем, и поле является полем экземпляра.ExceptionInInitializerError - если инициализация вызывается этим методом сбои.get(java.lang.Object)public void set(Object obj, Object value) throws IllegalArgumentException, IllegalAccessException
Field объект на указанном объектном параметре указанному новому значению. Новое значение автоматически разворачивается, если у базового поля есть тип примитива. Работа продолжается следующим образом:
Если базовое поле статично, obj параметр игнорируется; это может быть нуль.
Иначе базовое поле является полем экземпляра. Если указанным объектным параметром является нуль, метод бросает a NullPointerException. Если указанным объектным параметром не является экземпляр class или интерфейса, объявляя базовое поле, метод бросает IllegalArgumentException.
Если это Field объект осуществляет управление доступом языка Java, и базовое поле недоступно, метод бросает IllegalAccessException.
Если базовое поле является заключительным, метод бросает IllegalAccessException если setAccessible(true) успешно выполнился для этого Field возразите и поле нестатично. Установка заключительного поля таким образом значима только во время десериализации или реконструкции экземпляров классов с пустыми заключительными полями, прежде, чем они будут сделаны доступными для доступа другими частями программы. Использование в любом другом контексте может иметь непредсказуемые эффекты, включая случаи, в которых другие части программы продолжают использовать исходное значение этого поля.
Если базовое поле имеет тип примитива, преобразование разворачивания предпринимается, чтобы преобразовать новое значение в значение типа примитива. Если эта попытка перестала работать, метод бросает IllegalArgumentException.
Если после возможного разворачивания новое значение не может быть преобразовано в тип базового поля идентификационными данными или расширяющимся преобразованием, метод бросает IllegalArgumentException.
Если базовое поле статично, class, который объявил, поле инициализируется, если это не было уже инициализировано.
Поле устанавливается в возможно развернутый и расширило новое значение.
Если поле скрывается в типе obj, значение поля устанавливается согласно предыдущим правилам.
obj - объект, поле которого должно быть измененоvalue - новое значение для поля obj быть измененнымIllegalAccessException - если это Field объект осуществляет управление доступом языка Java, и базовое поле является или недоступным или заключительным.IllegalArgumentException - если указанный объект не является экземпляром class или интерфейса, объявляя базовое поле (или подкласс или конструктор этого), или если преобразование разворачивания перестало работать.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 - если указанный объект не является экземпляром class или интерфейса, объявляя базовое поле (или подкласс или конструктор этого), или если преобразование разворачивания перестало работать.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 - если указанный объект не является экземпляром class или интерфейса, объявляя базовое поле (или подкласс или конструктор этого), или если преобразование разворачивания перестало работать.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 - если указанный объект не является экземпляром class или интерфейса, объявляя базовое поле (или подкласс или конструктор этого), или если преобразование разворачивания перестало работать.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 - если указанный объект не является экземпляром class или интерфейса, объявляя базовое поле (или подкласс или конструктор этого), или если преобразование разворачивания перестало работать.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 - если указанный объект не является экземпляром class или интерфейса, объявляя базовое поле (или подкласс или конструктор этого), или если преобразование разворачивания перестало работать.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 - если указанный объект не является экземпляром class или интерфейса, объявляя базовое поле (или подкласс или конструктор этого), или если преобразование разворачивания перестало работать.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 - если указанный объект не является экземпляром class или интерфейса, объявляя базовое поле (или подкласс или конструктор этого), или если преобразование разворачивания перестало работать.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 - если указанный объект не является экземпляром class или интерфейса, объявляя базовое поле (или подкласс или конструктор этого), или если преобразование разворачивания перестало работать.NullPointerException - если указанный объект является нулем, и поле является полем экземпляра.ExceptionInInitializerError - если инициализация вызывается этим методом сбои.set(java.lang.Object, java.lang.Object)public <T extends Annotation> T getAnnotation(Class<T> annotationClass)
AnnotatedElementgetAnnotation в интерфейсе AnnotatedElementgetAnnotation в class AccessibleObjectannotationClass - соответствие объекта Класса типу аннотацииNullPointerException - если данная аннотация class является нулемpublic <T extends Annotation> T[] getAnnotationsByType(Class<T> annotationClass)
AnnotatedElement.getAnnotation(Class) тот этот метод, обнаруживает, если его параметр является повторимым типом аннотации (JLS 9.6), и если так, пытается найти одну или более аннотаций того типа, "просматривая" контейнерную аннотацию. Вызывающая сторона этого метода свободна изменить возвращенный массив; это не будет иметь никакого эффекта на массивы, возвращенные к другим вызывающим сторонам.getAnnotationsByType в интерфейсе AnnotatedElementgetAnnotationsByType в class AccessibleObjectannotationClass - соответствие объекта Класса типу аннотацииNullPointerException - если данная аннотация class является нулемpublic Annotation[] getDeclaredAnnotations()
getDeclaredAnnotations в интерфейсе AnnotatedElementgetDeclaredAnnotations в class AccessibleObjectpublic AnnotatedType getAnnotatedType()
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92