Spec-Zone.ru › OpenJDK 24

Класс OpenMBeanAttributeInfoSupport

java.lang.Object
javax.management.MBeanFeatureInfo
javax.management.MBeanAttributeInfo
javax.management.openmbean.OpenMBeanAttributeInfoSupport
Все реализованные интерфейсы:
Serializable, Cloneable, DescriptorRead, OpenMBeanAttributeInfo, OpenMBeanParameterInfo
public class OpenMBeanAttributeInfoSupport extends MBeanAttributeInfo implements OpenMBeanAttributeInfo
Описание атрибута открытого MBean.
С момента:
1.5
См. также:
  • Сериализованная форма

Краткое описание полей

Поля, объявленные в классе javax.management.MBeanFeatureInfo

description, name

Краткое описание конструкторов

OpenMBeanAttributeInfoSupport(String name, String description, OpenType<?> openType, boolean isReadable, boolean isWritable, boolean isIs)
OpenMBeanAttributeInfoSupport(String name, String description, OpenType<?> openType, boolean isReadable, boolean isWritable, boolean isIs, Descriptor descriptor)
OpenMBeanAttributeInfoSupport(String name, String description, OpenType<T> openType, boolean isReadable, boolean isWritable, boolean isIs, T defaultValue)
OpenMBeanAttributeInfoSupport(String name, String description, OpenType<T> openType, boolean isReadable, boolean isWritable, boolean isIs, T defaultValue, Comparable<T> minValue, Comparable<T> maxValue)
OpenMBeanAttributeInfoSupport(String name, String description, OpenType<T> openType, boolean isReadable, boolean isWritable, boolean isIs, T defaultValue, T[] legalValues)
Модификатор Конструктор Описание
Создает экземпляр OpenMBeanAttributeInfoSupport, который описывает атрибут открытого MBean со значениями name, openType и description, а также свойствами доступа на чтение/запись.
Создает экземпляр OpenMBeanAttributeInfoSupport, который описывает атрибут открытого MBean со значениями name, openType, description, свойствами доступа на чтение/запись и Descriptor.
 <T> 
Создает экземпляр OpenMBeanAttributeInfoSupport, который описывает атрибут открытого MBean со значениями name, openType, description и defaultValue, а также свойствами доступа на чтение/запись.
 <T> 
Создает экземпляр OpenMBeanAttributeInfoSupport, который описывает атрибут открытого MBean со значениями name, openType, description, defaultValue, minValue и maxValue.
 <T> 
Создает экземпляр OpenMBeanAttributeInfoSupport, который описывает атрибут открытого MBean со значениями name, openType, description, defaultValue и legalValues, а также свойствами доступа на чтение/запись.

Краткое описание методов

Модификатор и тип Метод Описание
boolean equals(Object obj)
Сравнивает переданный параметр obj с этим экземпляром OpenMBeanAttributeInfoSupport на равенство.
Object getDefaultValue()
Возвращает значение по умолчанию для атрибута, описанного этим экземпляром OpenMBeanAttributeInfoSupport, если оно задано, или null в противном случае.
Set<?> getLegalValues()
Возвращает неизменяемый набор допустимых значений для атрибута, описанного этим экземпляром OpenMBeanAttributeInfoSupport, если он задан, или null в противном случае.
Comparable<?> getMaxValue()
Возвращает максимальное значение для атрибута, описанного этим экземпляром OpenMBeanAttributeInfoSupport, если оно задано, или null в противном случае.
Comparable<?> getMinValue()
Возвращает минимальное значение для атрибута, описанного этим экземпляром OpenMBeanAttributeInfoSupport, если оно задано, или null в противном случае.
OpenType<?> getOpenType()
Возвращает открытый тип значений атрибута, описанного этим экземпляром OpenMBeanAttributeInfoSupport.
boolean hasDefaultValue()
Возвращает true, если этот экземпляр OpenMBeanAttributeInfoSupport задает ненулевое значение по умолчанию для описываемого атрибута, false в противном случае.
int hashCode()
Возвращает код хэша для этого экземпляра OpenMBeanAttributeInfoSupport.
boolean hasLegalValues()
Возвращает true, если этот экземпляр OpenMBeanAttributeInfoSupport задает ненулевой набор допустимых значений для описанного атрибута, false в противном случае.
boolean hasMaxValue()
Возвращает true, если этот экземпляр OpenMBeanAttributeInfoSupport задает ненулевое максимальное значение для описанного атрибута, false в противном случае.
boolean hasMinValue()
Возвращает true, если этот экземпляр OpenMBeanAttributeInfoSupport задает ненулевое минимальное значение для описанного атрибута, false в противном случае.
boolean isValue(Object obj)
Проверяет, является ли obj допустимым значением для атрибута, описанного этим экземпляром OpenMBeanAttributeInfoSupport.
String toString()
Возвращает строковое представление этого экземпляра OpenMBeanAttributeInfoSupport.

Методы, объявленные в классе javax.management.MBeanAttributeInfo

clone, getType, isIs, isReadable, isWritable

Методы, объявленные в классе javax.management.MBeanFeatureInfo

getDescription, getDescriptor, getName

Методы, объявленные в классе java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Методы, объявленные в интерфейсе javax.management.openmbean.OpenMBeanAttributeInfo

isIs, isReadable, isWritable

Методы, объявленные в интерфейсе javax.management.openmbean.OpenMBeanParameterInfo

getDescription, getName

Подробное описание конструкторов

OpenMBeanAttributeInfoSupport

public OpenMBeanAttributeInfoSupport(String name, String description, OpenType<?> openType, boolean isReadable, boolean isWritable, boolean isIs)
Создаёт экземпляр OpenMBeanAttributeInfoSupport, описывающий атрибут открытого MBean со специфицированными name, openType и description, а также свойствами доступа на чтение/запись.
Параметры:
name - не может быть null или пустой строкой.
description - не может быть null или пустой строкой.
openType - не может быть null.
isReadable - true, если для атрибута доступен getter для управления.
isWritable - true, если для атрибута доступен setter для управления.
isIs - true, если getter атрибута имеет вид isXXX.
Исключения:
IllegalArgumentException - если name или description равны null или пустой строке, или openType равен null.

OpenMBeanAttributeInfoSupport

public OpenMBeanAttributeInfoSupport(String name, String description, OpenType<?> openType, boolean isReadable, boolean isWritable, boolean isIs, Descriptor descriptor)

Создаёт экземпляр OpenMBeanAttributeInfoSupport, описывающий атрибут открытого MBean со специфицированными name, openType, description, свойствами доступа на чтение/запись и Descriptor.

descriptor может содержать записи, которые определяют значения, возвращаемые определёнными методами этого класса, как описано в описании пакета.

Параметры:
name - не может быть null или пустой строкой.
description - не может быть null или пустой строкой.
openType - не может быть null.
isReadable - true, если для атрибута доступен getter для управления.
isWritable - true, если для атрибута доступен setter для управления.
isIs - true, если getter атрибута имеет вид isXXX.
descriptor - Дескриптор атрибута. Может быть null, что эквивалентно пустому дескриптору.
Исключения:
IllegalArgumentException - если name или description равны null или пустой строке, или openType равен null, или записи дескриптора невалидны, как описано в описании пакета.
С:
1.6

OpenMBeanAttributeInfoSupport

public <T> OpenMBeanAttributeInfoSupport(String name, String description, OpenType<T> openType, boolean isReadable, boolean isWritable, boolean isIs, T defaultValue) throws OpenDataException
Создаёт экземпляр OpenMBeanAttributeInfoSupport, описывающий атрибут открытого MBean со специфицированными name, openType, description и defaultValue, а также свойствами доступа на чтение/запись.
Тип параметров:
T - позволяет компилятору проверить, что defaultValue, если не null, имеет правильный тип Java для данного openType.
Параметры:
name - не может быть null или пустой строкой.
description - не может быть null или пустой строкой.
openType - не может быть null.
isReadable - true, если для атрибута доступен getter для управления.
isWritable - true, если для атрибута доступен setter для управления.
isIs - true, если getter атрибута имеет вид isXXX.
defaultValue - должно быть допустимым значением для openType, указанного для данного атрибута; значение по умолчанию не поддерживается для ArrayType и TabularType; может быть null, что означает, что значение по умолчанию не задано.
Исключения:
IllegalArgumentException - если name или description равны null или пустой строке, или openType равен null.
OpenDataException - если defaultValue не является допустимым значением для указанного openType, или defaultValue не null и openType является ArrayType или TabularType.

OpenMBeanAttributeInfoSupport

public <T> OpenMBeanAttributeInfoSupport(String name, String description, OpenType<T> openType, boolean isReadable, boolean isWritable, boolean isIs, T defaultValue, T[] legalValues) throws OpenDataException

Создаёт экземпляр OpenMBeanAttributeInfoSupport, описывающий атрибут открытого MBean со специфицированными name, openType, description, defaultValue и legalValues, а также свойствами доступа на чтение/запись.

Содержимое legalValues копируется, поэтому последующие изменения массива, на который ссылается legalValues, не оказывают влияния на этот экземпляр OpenMBeanAttributeInfoSupport.

Тип параметров:
T - позволяет компилятору проверить, что defaultValue и legalValues, если не null, имеют правильный тип Java для данного openType.
Параметры:
name - не может быть null или пустой строкой.
description - не может быть null или пустой строкой.
openType - не может быть null.
isReadable - true, если для атрибута доступен getter для управления.
isWritable - true, если для атрибута доступен setter для управления.
isIs - true, если getter атрибута имеет вид isXXX.
defaultValue - должно быть допустимым значением для openType, указанного для данного атрибута; значение по умолчанию не поддерживается для ArrayType и TabularType; может быть null, что означает, что значение по умолчанию не задано.
legalValues - каждое содержащееся значение должно быть допустимым для openType, указанного для данного атрибута; допустимые значения не поддерживаются для ArrayType и TabularType; может быть null или пустым.
Исключения:
IllegalArgumentException - если name или description равны null или пустой строке, или openType равен null.
OpenDataException - если defaultValue не является допустимым значением для указанного openType, или одно значение в legalValues не является допустимым для указанного openType, или defaultValue не null и openType является ArrayType или TabularType, или legalValues не null и не пусто и openType является ArrayType или TabularType, или legalValues не null и не пусто и defaultValue не содержится в legalValues.

OpenMBeanAttributeInfoSupport

public <T> OpenMBeanAttributeInfoSupport(String name, String description, OpenType<T> openType, boolean isReadable, boolean isWritable, boolean isIs, T defaultValue, Comparable<T> minValue, Comparable<T> maxValue) throws OpenDataException
Создает экземпляр OpenMBeanAttributeInfoSupport, который описывает атрибут открытого MBean, с указанными name, openType, description, defaultValue, minValue и maxValue. Можно указать минимальные и максимальные значения только для открытого типа, значения которого являются Comparable.
Параметры типа:
T - позволяет компилятору проверять, что defaultValue, minValue и maxValue, если они не равны null, имеют правильный тип Java для данного openType.
Параметры:
name - не может быть пустой или нулевой строкой.
description - не может быть пустой или нулевой строкой.
openType - не может быть null.
isReadable - true, если у атрибута есть геттер, доступный для управления.
isWritable - true, если у атрибута есть сеттер, доступный для управления.
isIs - true, если геттер атрибута имеет вид isXXX.
defaultValue - должно быть допустимым значением для openType, указанного для этого атрибута; значение по умолчанию не поддерживается для ArrayType и TabularType; может быть null, в этом случае это означает, что значение по умолчанию не установлено.
minValue - должно быть допустимым для openType, указанного для этого атрибута; может быть null, в этом случае это означает, что минимальное значение не установлено.
maxValue - должно быть допустимым для openType, указанного для этого атрибута; может быть null, в этом случае это означает, что максимальное значение не установлено.
Исключения:
IllegalArgumentException - если name или description являются null или пустой строкой, или openType равен null.
OpenDataException - если defaultValue, minValue или maxValue не является допустимым значением для указанного openType, или defaultValue не равен null, и openType является ArrayType или TabularType, или и minValue, и maxValue не равны null, и minValue.compareTo(maxValue) > 0 равен true, или и defaultValue, и minValue не равны null, и minValue.compareTo(defaultValue) > 0 равен true, или и defaultValue, и maxValue не равны null, и defaultValue.compareTo(maxValue) > 0 равен true.

Подробное описание методов

getOpenType

public OpenType<?> getOpenType()
Возвращает открытый тип для значений атрибута, описываемого этим экземпляром OpenMBeanAttributeInfoSupport.
Указано в:
getOpenType в интерфейсе OpenMBeanParameterInfo
Возвращает:
открытый тип.

getDefaultValue

public Object getDefaultValue()
Возвращает значение по умолчанию для атрибута, описываемого этим экземпляром OpenMBeanAttributeInfoSupport, если указано, или null в противном случае.
Указано в:
getDefaultValue в интерфейсе OpenMBeanParameterInfo
Возвращает:
значение по умолчанию.

getLegalValues

public Set<?> getLegalValues()
Возвращает неизменяемый набор допустимых значений для атрибута, описываемого этим экземпляром OpenMBeanAttributeInfoSupport, если указано, или null в противном случае.
Указано в:
getLegalValues в интерфейсе OpenMBeanParameterInfo
Возвращает:
набор допустимых значений.

getMinValue

public Comparable<?> getMinValue()
Возвращает минимальное значение для атрибута, описываемого этим экземпляром OpenMBeanAttributeInfoSupport, если указано, или null в противном случае.
Указано в:
getMinValue в интерфейсе OpenMBeanParameterInfo
Возвращает:
минимальное значение.

getMaxValue

public Comparable<?> getMaxValue()
Возвращает максимальное значение для атрибута, описываемого этим экземпляром OpenMBeanAttributeInfoSupport, если указано, или null в противном случае.
Указано в:
getMaxValue в интерфейсе OpenMBeanParameterInfo
Возвращает:
максимальное значение.

hasDefaultValue

public boolean hasDefaultValue()
Возвращает true, если этот экземпляр OpenMBeanAttributeInfoSupport указывает ненулевое значение по умолчанию для описанного атрибута, false в противном случае.
Указано в:
hasDefaultValue в интерфейсе OpenMBeanParameterInfo
Возвращает:
true, если есть значение по умолчанию.

hasLegalValues

public boolean hasLegalValues()
Возвращает true, если этот экземпляр OpenMBeanAttributeInfoSupport указывает ненулевой набор допустимых значений для описанного атрибута, false в противном случае.
Указано в:
hasLegalValues в интерфейсе OpenMBeanParameterInfo
Возвращает:
true, если есть набор допустимых значений.

hasMinValue

public boolean hasMinValue()
Возвращает true, если этот экземпляр OpenMBeanAttributeInfoSupport указывает ненулевое минимальное значение для описанного атрибута, false в противном случае.
Указано в:
hasMinValue в интерфейсе OpenMBeanParameterInfo
Возвращает:
true, если есть минимальное значение.

hasMaxValue

public boolean hasMaxValue()
Возвращает true, если этот экземпляр OpenMBeanAttributeInfoSupport указывает ненулевое максимальное значение для описанного атрибута, false в противном случае.
Указано в:
hasMaxValue в интерфейсе OpenMBeanParameterInfo
Возвращает:
true, если есть максимальное значение.

isValue

public boolean isValue(Object obj)
Проверяет, является ли obj допустимым значением для атрибута, описываемого этим экземпляром OpenMBeanAttributeInfoSupport.
Указано в:
isValue в интерфейсе OpenMBeanParameterInfo
Параметры:
obj - объект, который необходимо проверить.
Возвращает:
true, если obj является допустимым значением для параметра, описываемого этим экземпляром OpenMBeanAttributeInfoSupport, false в противном случае.

equals

public boolean equals(Object obj)
Сравнивает указанный параметр obj с этим экземпляром OpenMBeanAttributeInfoSupport на равенство.

Возвращает true тогда и только тогда, когда истинны все следующие утверждения:

  • obj не равен null,
  • obj также реализует интерфейс OpenMBeanAttributeInfo,
  • их имена равны
  • их открытые типы равны
  • их свойства доступа (isReadable, isWritable и isIs) равны
  • их значения по умолчанию, min, max и допустимые значения равны.
Это гарантирует, что этот метод equals работает правильно для параметров obj, которые являются различными реализациями интерфейса OpenMBeanAttributeInfo.

Если obj также реализует DescriptorRead, то его метод getDescriptor() также должен возвращать то же значение, что и для этого объекта.

Указано в:
equals в интерфейсе OpenMBeanAttributeInfo
Указано в:
equals в интерфейсе OpenMBeanParameterInfo
Переопределяет:
equals в классе MBeanAttributeInfo
Параметры:
obj - объект, который необходимо сравнить на равенство с этим экземпляром OpenMBeanAttributeInfoSupport.
Возвращает:
true, если указанный объект равен этому экземпляру OpenMBeanAttributeInfoSupport.
См. также:
  • Object.hashCode()
  • HashMap

hashCode

public int hashCode()

Возвращает значение хэш-кода для этого экземпляра OpenMBeanAttributeInfoSupport.

Хэш-код экземпляра OpenMBeanAttributeInfoSupport — это сумма хэш-кодов всех элементов информации, используемых в сравнениях equals (то есть его имя, его открытый тип, его значения по умолчанию, min, max и допустимые значения, а также его дескриптор).

Это гарантирует, что t1.equals(t2) подразумевает, что t1.hashCode()==t2.hashCode() для любых двух экземпляров OpenMBeanAttributeInfoSupport t1 и t2, как того требует общее соглашение метода Object.hashCode().

Однако обратите внимание, что другой экземпляр класса, реализующего интерфейс OpenMBeanAttributeInfo, может быть равен этому экземпляру OpenMBeanAttributeInfoSupport, как определено в equals(java.lang.Object), но может иметь другой хэш-код, если он вычисляется по-другому.

Поскольку экземпляры OpenMBeanAttributeInfoSupport неизменяемы, хэш-код для этого экземпляра вычисляется один раз при первом вызове hashCode, а затем то же значение возвращается для последующих вызовов.

Specified by:
hashCode в интерфейсе OpenMBeanAttributeInfo
Specified by:
hashCode в интерфейсе OpenMBeanParameterInfo
Overrides:
hashCode в классе Object
Returns:
значение хэш-кода для этого экземпляра OpenMBeanAttributeInfoSupport
See Also:
  • Object.equals(java.lang.Object)
  • System.identityHashCode(java.lang.Object)

toString

public String toString()
Возвращает строковое представление этого экземпляра OpenMBeanAttributeInfoSupport.

Строковое представление состоит из имени этого класса (т.е. javax.management.openmbean.OpenMBeanAttributeInfoSupport), строкового представления имени и открытого типа описываемого параметра, строкового представления его значений по умолчанию, min, max и допустимых значений, а также строкового представления его дескриптора.

Поскольку экземпляры OpenMBeanAttributeInfoSupport неизменяемы, строковое представление для этого экземпляра вычисляется один раз при первом вызове toString, а затем то же значение возвращается для последующих вызовов.

Specified by:
toString в интерфейсе OpenMBeanAttributeInfo
Specified by:
toString в интерфейсе OpenMBeanParameterInfo
Overrides:
toString в классе Object
Returns:
строковое представление этого экземпляра OpenMBeanAttributeInfoSupport.

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://download.java.net/java/early_access/jdk24/docs/api/java.management/javax/management/openmbean/OpenMBeanAttributeInfoSupport.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API