Spec-Zone .ru
спецификации, руководства, описания, API
|
public class MBeanInfo extends Object implements Cloneable, Serializable, DescriptorRead
Описывает интерфейс управления, представленный MBean; то есть, набор атрибутов и операций, которые доступны для операций управления. Экземпляры этого class являются неизменными. Подклассы могут быть изменчивыми, но это не рекомендуется.
Обычно MBeanInfo
для любого данного MBean не переключает время жизни этого MBean. Динамический MBeans может изменить их MBeanInfo
и в этом случае рекомендуется, чтобы они испустили a Notification
с типом "jmx.mbean.info.changed"
и userData, который является новым MBeanInfo
. Это не требуется, но обеспечивает стандартный путь к клиентам MBean, чтобы обнаружить изменение. См. также immutableInfo и infoTimeout поля в MBeanInfo
Descriptor
.
Содержание MBeanInfo
поскольку Динамический MBean определяется getMBeanInfo()
метод. Это включает Открытый MBeans и Модель MBeans, которые являются видами Динамического MBeans.
Содержание MBeanInfo
поскольку Стандартный MBean определяется сервером MBean следующим образом:
getClassName()
возвращает Java имя class объекта MBean; getConstructors()
возвращает список всех общедоступных конструкторов в том объекте; getAttributes()
возвращает список всех атрибутов, существование которых выводится из присутствия в интерфейсе MBean a getName
, isName
, или setName
метод, который соответствует соглашениям для Стандартного MBeans; getOperations()
возвращает список всех методов в интерфейсе MBean, которые не представляют атрибуты; getNotifications()
возвращает пустой массив, если MBean не реализует NotificationBroadcaster
интерфейс, иначе результат вызова NotificationBroadcaster.getNotificationInfo()
на этом; getDescriptor()
возвращает дескриптор, содержащий содержание любых аннотаций дескриптора в интерфейсе MBean (см. @DescriptorKey
). Описание, возвращенное getDescription()
и описания содержавших атрибутов и операций не определяются.
Остающиеся детали MBeanInfo
поскольку Стандартный MBean не определяется. Это включает описание любых содержавших конструкторов, и уведомления; имена параметров конструкторам и операциям; и описания параметров конструктора.
Конструктор и Описание |
---|
MBeanInfo(String className, String description, MBeanAttributeInfo[] attributes, MBeanConstructorInfo[] constructors, MBeanOperationInfo[] operations, MBeanNotificationInfo[] notifications)
Конструкции
MBeanInfo . |
MBeanInfo(String className, String description, MBeanAttributeInfo[] attributes, MBeanConstructorInfo[] constructors, MBeanOperationInfo[] operations, MBeanNotificationInfo[] notifications, Descriptor descriptor)
Конструкции
MBeanInfo . |
Модификатор и Тип | Метод и Описание |
---|---|
Объект |
clone()
Возвращает мелкого клона этого экземпляра.
|
boolean |
equals(Object o)
Сравните этот MBeanInfo с другим.
|
MBeanAttributeInfo[] |
getAttributes()
Возвращает список атрибутов, представленных для управления.
|
Строка |
getClassName()
Возвращает имя Java class MBean, описанного этим
MBeanInfo . |
MBeanConstructorInfo[] |
getConstructors()
Возвращает список общедоступных конструкторов MBean.
|
Строка |
getDescription()
Возвращает удобочитаемое описание MBean.
|
Дескриптор |
getDescriptor()
Получите дескриптор этого MBeanInfo.
|
MBeanNotificationInfo[] |
getNotifications()
Возвращает список уведомлений, испускаемых MBean.
|
MBeanOperationInfo[] |
getOperations()
Возвращает список операций MBean.
|
int |
hashCode()
Возвращает значение хэш-кода для объекта.
|
Строка |
toString()
Возвращает строковое представление объекта.
|
public MBeanInfo(String className, String description, MBeanAttributeInfo[] attributes, MBeanConstructorInfo[] constructors, MBeanOperationInfo[] operations, MBeanNotificationInfo[] notifications) throws IllegalArgumentException
MBeanInfo
.className
- Имя Java class MBean описывается этим MBeanInfo
. Это значение может быть любым синтаксически юридическим Java имя class. Это не должен быть Java class, известный серверу MBean или ClassLoder MBEAN. Если это - Java class, известный ClassLoder MBEAN, это рекомендуется, но не потребовало, чтобы открытые методы class включали тех, которые казались бы в Стандартном MBean реализация атрибутов и операций в этом MBeanInfo.description
- Удобочитаемое описание (дополнительного) MBean.attributes
- Список представленных атрибутов MBean. Это может быть нулем с тем же самым эффектом как массив нулевой длиной.constructors
- Список общедоступных конструкторов MBean. Это может быть нулем с тем же самым эффектом как массив нулевой длиной.operations
- Список операций MBean. Это может быть нулем с тем же самым эффектом как массив нулевой длиной.notifications
- Список уведомлений испускается. Это может быть нулем с тем же самым эффектом как массив нулевой длиной.IllegalArgumentException
public MBeanInfo(String className, String description, MBeanAttributeInfo[] attributes, MBeanConstructorInfo[] constructors, MBeanOperationInfo[] operations, MBeanNotificationInfo[] notifications, Descriptor descriptor) throws IllegalArgumentException
MBeanInfo
.className
- Имя Java class MBean описывается этим MBeanInfo
. Это значение может быть любым синтаксически юридическим Java имя class. Это не должен быть Java class, известный серверу MBean или ClassLoder MBEAN. Если это - Java class, известный ClassLoder MBEAN, это рекомендуется, но не потребовало, чтобы открытые методы class включали тех, которые казались бы в Стандартном MBean реализация атрибутов и операций в этом MBeanInfo.description
- Удобочитаемое описание (дополнительного) MBean.attributes
- Список представленных атрибутов MBean. Это может быть нулем с тем же самым эффектом как массив нулевой длиной.constructors
- Список общедоступных конструкторов MBean. Это может быть нулем с тем же самым эффектом как массив нулевой длиной.operations
- Список операций MBean. Это может быть нулем с тем же самым эффектом как массив нулевой длиной.notifications
- Список уведомлений испускается. Это может быть нулем с тем же самым эффектом как массив нулевой длиной.descriptor
- Дескриптор для MBean. Это может быть нулем, который эквивалентен пустому дескриптору.IllegalArgumentException
public Object clone()
Возвращает мелкого клона этого экземпляра. Клон получается, просто вызывая super.clone(), таким образом вызывая значение по умолчанию собственный мелкий механизм клонирования, реализованный Object.clone(). Никакое более глубокое клонирование любого внутреннего поля не делается.
Так как этот class является неизменным, метод клона имеет в основном интерес для подклассов.
public String getClassName()
MBeanInfo
.public String getDescription()
public MBeanAttributeInfo[] getAttributes()
MBeanAttributeInfo
объект. Возвращенный массив является мелкой копией внутреннего массива, что означает, что это - копия внутреннего массива ссылок на MBeanAttributeInfo
объекты, но что каждый, на которого ссылаются MBeanAttributeInfo
объект не копируется.MBeanAttributeInfo
объекты.public MBeanOperationInfo[] getOperations()
MBeanOperationInfo
объект. Возвращенный массив является мелкой копией внутреннего массива, что означает, что это - копия внутреннего массива ссылок на MBeanOperationInfo
объекты, но что каждый, на которого ссылаются MBeanOperationInfo
объект не копируется.MBeanOperationInfo
объекты.public MBeanConstructorInfo[] getConstructors()
Возвращает список общедоступных конструкторов MBean. Каждый конструктор описывается MBeanConstructorInfo
объект.
Возвращенный массив является мелкой копией внутреннего массива, что означает, что это - копия внутреннего массива ссылок на MBeanConstructorInfo
объекты, но что каждый, на которого ссылаются MBeanConstructorInfo
объект не копируется.
Возвращенный список является не обязательно исчерпывающим. Таким образом, у MBean может быть общедоступный конструктор, который не находится в списке. В этом случае сервер MBean может создать другой экземпляр class этого MBEAN, используя того конструктора, даже при том, что это не перечисляется здесь.
MBeanConstructorInfo
объекты.public MBeanNotificationInfo[] getNotifications()
MBeanNotificationInfo
объект. Возвращенный массив является мелкой копией внутреннего массива, что означает, что это - копия внутреннего массива ссылок на MBeanNotificationInfo
объекты, но что каждый, на которого ссылаются MBeanNotificationInfo
объект не копируется.MBeanNotificationInfo
объекты.public Descriptor getDescriptor()
getDescriptor
в интерфейсе DescriptorRead
public String toString()
Object
toString
метод возвращает строку, которая "дословно представляет" этот объект. Результатом должно быть краткое, но информативное представление, которое легко для человека читать. Рекомендуется, чтобы все подклассы переопределили этот метод. toString
метод для class Object
возвращает строку, состоящую из имени class, которого объект является экземпляром, символ знака at-sign`@
', и шестнадцатеричное представление без знака хэш-кода объекта. Другими словами этот метод возвращает строку, равную значению:
getClass().getName() + '@' + Integer.toHexString(hashCode())
public boolean equals(Object o)
Сравните этот MBeanInfo с другим. Два объекта MBeanInfo равны, если и только если они возвращают равные значения для getClassName()
, для getDescription()
, и для getDescriptor()
, и массивы, возвращенные двумя объектами для getAttributes()
, getOperations()
, getConstructors()
, и getNotifications()
попарные равный. Здесь "равный" означает Object.equals(Object)
, не идентификационные данные.
Если два объекта MBeanInfo возвращают те же самые значения в одном из их массивов, но в различном порядке тогда они не равны.
equals
в class Object
o
- объект сравниться с.o
MBeanInfo, который равен этому согласно правилам выше.Object.hashCode()
, HashMap
public int hashCode()
Object
HashMap
. Общий контракт hashCode
:
hashCode
метод должен последовательно возвращать то же самое целое число, не предоставил информации, используемой в equals
сравнения на объекте изменяются. Эта целочисленная потребность не остается непротиворечивой от одного выполнения приложения к другому выполнению того же самого приложения. equals(Object)
метод, затем вызывая hashCode
метод на каждом из двух объектов должен привести к тому же самому целочисленному результату. Object.equals(java.lang.Object)
метод, затем вызывая hashCode
метод на каждом из двух объектов должен привести к отличным целочисленным результатам. Однако, программист должен знать, что приведение к отличным целочисленным результатам для неравных объектов может улучшить производительность хэш-таблиц. Столько, сколько разумно практично, метод хэш-кода, определенный class Object
действительно возвращает отличные целые числа для отличных объектов. (Это обычно реализуется, преобразовывая внутренний адрес объекта в целое число, но этот метод реализации не требуется языком программирования Java™.)
hashCode
в class Object
Object.equals(java.lang.Object)
, System.identityHashCode(java.lang.Object)
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92