|
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 - Список уведомлений испускается. Это может быть нулем с тем же самым эффектом как массив нулевой длиной.IllegalArgumentExceptionpublic 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. Это может быть нулем, который эквивалентен пустому дескриптору.IllegalArgumentExceptionpublic 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 в интерфейсе DescriptorReadpublic String toString()
ObjecttoString метод возвращает строку, которая "дословно представляет" этот объект. Результатом должно быть краткое, но информативное представление, которое легко для человека читать. Рекомендуется, чтобы все подклассы переопределили этот метод. 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 Objecto - объект сравниться с.o MBeanInfo, который равен этому согласно правилам выше.Object.hashCode(), HashMappublic int hashCode()
ObjectHashMap. Общий контракт hashCode :
hashCode метод должен последовательно возвращать то же самое целое число, не предоставил информации, используемой в equals сравнения на объекте изменяются. Эта целочисленная потребность не остается непротиворечивой от одного выполнения приложения к другому выполнению того же самого приложения. equals(Object) метод, затем вызывая hashCode метод на каждом из двух объектов должен привести к тому же самому целочисленному результату. Object.equals(java.lang.Object) метод, затем вызывая hashCode метод на каждом из двух объектов должен привести к отличным целочисленным результатам. Однако, программист должен знать, что приведение к отличным целочисленным результатам для неравных объектов может улучшить производительность хэш-таблиц. Столько, сколько разумно практично, метод хэш-кода, определенный class Object действительно возвращает отличные целые числа для отличных объектов. (Это обычно реализуется, преобразовывая внутренний адрес объекта в целое число, но этот метод реализации не требуется языком программирования Java™.)
hashCode в class ObjectObject.equals(java.lang.Object), System.identityHashCode(java.lang.Object)
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92