public class MBeanInfo extends Object implements Cloneable, Serializable, DescriptorRead
Describes the management interface exposed by an MBean; that is, the set of attributes and operations which are available for management operations. Instances of this class are immutable. Subclasses may be mutable but this is not recommended.
Usually the MBeanInfo for any given MBean does
not change over the lifetime of that MBean. Dynamic MBeans can change their
MBeanInfo and in that case it is recommended that they emit a Notification with a type of "jmx.mbean.info.changed" and a userData that is the new MBeanInfo. This is not required, but
provides a conventional way for clients of the MBean to discover the change.
See also the immutableInfo and
infoTimeout fields in the MBeanInfo Descriptor.
The contents of the MBeanInfo for a Dynamic MBean
are determined by its getMBeanInfo() method. This includes Open MBeans and Model
MBeans, which are kinds of Dynamic MBeans.
The contents of the MBeanInfo for a Standard MBean
are determined by the MBean server as follows:
getClassName() returns the Java class name of the MBean
object;
getConstructors() returns the list of all public
constructors in that object;
getAttributes() returns the list of all attributes
whose existence is deduced from the presence in the MBean interface
of a getName, isName, or
setName method that conforms to the conventions
for Standard MBeans;
getOperations() returns the list of all methods in
the MBean interface that do not represent attributes;
getNotifications() returns an empty array if the MBean
does not implement the NotificationBroadcaster interface,
otherwise the result of calling NotificationBroadcaster.getNotificationInfo() on it;
getDescriptor() returns a descriptor containing the contents
of any descriptor annotations in the MBean interface (see
@DescriptorKey).
The description returned by getDescription() and the
descriptions of the contained attributes and operations are not specified.
The remaining details of the MBeanInfo for a
Standard MBean are not specified. This includes the description of
any contained constructors, and notifications; the names
of parameters to constructors and operations; and the descriptions of
constructor parameters.
| Constructor and Description |
|---|
MBeanInfo(String className,
String description,
MBeanAttributeInfo[] attributes,
MBeanConstructorInfo[] constructors,
MBeanOperationInfo[] operations,
MBeanNotificationInfo[] notifications)
Constructs an
MBeanInfo. |
MBeanInfo(String className,
String description,
MBeanAttributeInfo[] attributes,
MBeanConstructorInfo[] constructors,
MBeanOperationInfo[] operations,
MBeanNotificationInfo[] notifications,
Descriptor descriptor)
Constructs an
MBeanInfo. |
| Modifier and Type | Method and Description |
|---|---|
Object |
clone()
Returns a shallow clone of this instance.
|
boolean |
equals(Object o)
Compare this MBeanInfo to another.
|
MBeanAttributeInfo[] |
getAttributes()
Returns the list of attributes exposed for management.
|
String |
getClassName()
Returns the name of the Java class of the MBean described by
this
MBeanInfo. |
MBeanConstructorInfo[] |
getConstructors()
Returns the list of the public constructors of the MBean.
|
String |
getDescription()
Returns a human readable description of the MBean.
|
Descriptor |
getDescriptor()
Get the descriptor of this MBeanInfo.
|
MBeanNotificationInfo[] |
getNotifications()
Returns the list of the notifications emitted by the MBean.
|
MBeanOperationInfo[] |
getOperations()
Returns the list of operations of the MBean.
|
int |
hashCode()
Returns a hash code value for the object.
|
String |
toString()
Returns a string representation of the object.
|
public MBeanInfo(String className, String description, MBeanAttributeInfo[] attributes, MBeanConstructorInfo[] constructors, MBeanOperationInfo[] operations, MBeanNotificationInfo[] notifications) throws IllegalArgumentException
MBeanInfo.className - The name of the Java class of the MBean described
by this MBeanInfo. This value may be any
syntactically legal Java class name. It does not have to be a
Java class known to the MBean server or to the MBean's
ClassLoader. If it is a Java class known to the MBean's
ClassLoader, it is recommended but not required that the
class's public methods include those that would appear in a
Standard MBean implementing the attributes and operations in
this MBeanInfo.description - A human readable description of the MBean (optional).attributes - The list of exposed attributes of the MBean.
This may be null with the same effect as a zero-length array.constructors - The list of public constructors of the
MBean. This may be null with the same effect as a zero-length
array.operations - The list of operations of the MBean. This
may be null with the same effect as a zero-length array.notifications - The list of notifications emitted. This
may be null with the same effect as a zero-length array.IllegalArgumentExceptionpublic MBeanInfo(String className, String description, MBeanAttributeInfo[] attributes, MBeanConstructorInfo[] constructors, MBeanOperationInfo[] operations, MBeanNotificationInfo[] notifications, Descriptor descriptor) throws IllegalArgumentException
MBeanInfo.className - The name of the Java class of the MBean described
by this MBeanInfo. This value may be any
syntactically legal Java class name. It does not have to be a
Java class known to the MBean server or to the MBean's
ClassLoader. If it is a Java class known to the MBean's
ClassLoader, it is recommended but not required that the
class's public methods include those that would appear in a
Standard MBean implementing the attributes and operations in
this MBeanInfo.description - A human readable description of the MBean (optional).attributes - The list of exposed attributes of the MBean.
This may be null with the same effect as a zero-length array.constructors - The list of public constructors of the
MBean. This may be null with the same effect as a zero-length
array.operations - The list of operations of the MBean. This
may be null with the same effect as a zero-length array.notifications - The list of notifications emitted. This
may be null with the same effect as a zero-length array.descriptor - The descriptor for the MBean. This may be null
which is equivalent to an empty descriptor.IllegalArgumentExceptionpublic Object clone()
Returns a shallow clone of this instance. The clone is obtained by simply calling super.clone(), thus calling the default native shallow cloning mechanism implemented by Object.clone(). No deeper cloning of any internal field is made.
Since this class is immutable, the clone method is chiefly of interest to subclasses.
public String getClassName()
MBeanInfo.public String getDescription()
public MBeanAttributeInfo[] getAttributes()
MBeanAttributeInfo object.
The returned array is a shallow copy of the internal array,
which means that it is a copy of the internal array of
references to the MBeanAttributeInfo objects
but that each referenced MBeanAttributeInfo object is not copied.MBeanAttributeInfo objects.public MBeanOperationInfo[] getOperations()
MBeanOperationInfo object.
The returned array is a shallow copy of the internal array,
which means that it is a copy of the internal array of
references to the MBeanOperationInfo objects
but that each referenced MBeanOperationInfo object is not copied.MBeanOperationInfo objects.public MBeanConstructorInfo[] getConstructors()
Returns the list of the public constructors of the MBean.
Each constructor is described by an
MBeanConstructorInfo object.
The returned array is a shallow copy of the internal array,
which means that it is a copy of the internal array of
references to the MBeanConstructorInfo objects but
that each referenced MBeanConstructorInfo object
is not copied.
The returned list is not necessarily exhaustive. That is, the MBean may have a public constructor that is not in the list. In this case, the MBean server can construct another instance of this MBean's class using that constructor, even though it is not listed here.
MBeanConstructorInfo objects.public MBeanNotificationInfo[] getNotifications()
MBeanNotificationInfo object.
The returned array is a shallow copy of the internal array,
which means that it is a copy of the internal array of
references to the MBeanNotificationInfo objects
but that each referenced MBeanNotificationInfo object is not copied.MBeanNotificationInfo objects.public Descriptor getDescriptor()
getDescriptor in interface DescriptorReadpublic String toString()
ObjecttoString method returns a string that
"textually represents" this object. The result should
be a concise but informative representation that is easy for a
person to read.
It is recommended that all subclasses override this method.
The toString method for class Object
returns a string consisting of the name of the class of which the
object is an instance, the at-sign character `@', and
the unsigned hexadecimal representation of the hash code of the
object. In other words, this method returns a string equal to the
value of:
getClass().getName() + '@' + Integer.toHexString(hashCode())
public boolean equals(Object o)
Compare this MBeanInfo to another. Two MBeanInfo objects
are equal if and only if they return equal values for getClassName(), for getDescription(), and for
getDescriptor(), and the
arrays returned by the two objects for getAttributes(), getOperations(), getConstructors(), and getNotifications() are
pairwise equal. Here "equal" means Object.equals(Object), not identity.
If two MBeanInfo objects return the same values in one of their arrays but in a different order then they are not equal.
equals in class Objecto - the object to compare to.o is an MBeanInfo that is equal
to this one according to the rules above.Object.hashCode(),
HashMappublic int hashCode()
ObjectHashMap.
The general contract of hashCode is:
hashCode method
must consistently return the same integer, provided no information
used in equals comparisons on the object is modified.
This integer need not remain consistent from one execution of an
application to another execution of the same application.
equals(Object)
method, then calling the hashCode method on each of
the two objects must produce the same integer result.
Object.equals(java.lang.Object)
method, then calling the hashCode method on each of the
two objects must produce distinct integer results. However, the
programmer should be aware that producing distinct integer results
for unequal objects may improve the performance of hash tables.
As much as is reasonably practical, the hashCode method defined by
class Object does return distinct integers for distinct
objects. (This is typically implemented by converting the internal
address of the object into an integer, but this implementation
technique is not required by the
Java™ programming language.)
hashCode in class ObjectObject.equals(java.lang.Object),
System.identityHashCode(java.lang.Object) Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2024, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.