| java.lang.Object | |||
| ↳ | javax.management.MBeanFeatureInfo | ||
| ↳ | javax.management.MBeanAttributeInfo | ||
| ↳ | javax.management.modelmbean.ModelMBeanAttributeInfo | ||
The ModelMBeanAttributeInfo object describes an attribute of the ModelMBean. It is a subclass of MBeanAttributeInfo with the addition of an associated Descriptor and an implementation of the DescriptorAccess interface.
The fields in the descriptor are defined, but not limited to, the following:
name : attribute name
descriptorType : must be "attribute"
value : current value for attribute
default : default value for attribute
displayName : name of attribute to be used in displays
getMethod : name of operation descriptor for get method
setMethod : name of operation descriptor for set method
protocolMap : object which implements the Descriptor interface: mappings must be appropriate for the attribute
and entries can be updated or augmented at runtime.
persistPolicy : OnUpdate|OnTimer|NoMoreOftenThan|OnUnregister|Always|Never
persistPeriod : seconds - frequency of persist cycle. Used when persistPolicy is"OnTimer" or "NoMoreOftenThan".
currencyTimeLimit : how long value is valid, <0 never, =0 always, >0 seconds
lastUpdatedTimeStamp : when value was set
visibility : 1-4 where 1: always visible 4: rarely visible
presentationString : xml formatted string to allow presentation of data
The default descriptor contains the name, descriptorType and displayName fields.
Note: because of inconsistencies in previous versions of
this specification, it is recommended not to use negative or zero
values for currencyTimeLimit. To indicate that a
cached value is never valid, omit the
currencyTimeLimit field. To indicate that it is
always valid, use a very large number for this field.
The serialVersionUID of this class is 6181543027787327345L.
|
[Expand]
Inherited Fields | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
From class
javax.management.MBeanFeatureInfo
| |||||||||||
| Public Constructors | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
Constructs a ModelMBeanAttributeInfo object with a default
descriptor.
| |||||||||||
Constructs a ModelMBeanAttributeInfo object.
| |||||||||||
Constructs a ModelMBeanAttributeInfo object with a default descriptor.
| |||||||||||
Constructs a ModelMBeanAttributeInfo object with a default descriptor.
| |||||||||||
Constructs a new ModelMBeanAttributeInfo object from this ModelMBeanAttributeInfo Object.
| |||||||||||
| Public Methods | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
Creates and returns a new ModelMBeanAttributeInfo which is a duplicate of this ModelMBeanAttributeInfo.
| |||||||||||
Gets a copy of the associated Descriptor for the
ModelMBeanAttributeInfo.
| |||||||||||
Sets associated Descriptor (full replace) for the
ModelMBeanAttributeDescriptor.
| |||||||||||
Returns a human-readable version of the
ModelMBeanAttributeInfo instance.
| |||||||||||
|
[Expand]
Inherited Methods | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
From class
javax.management.MBeanAttributeInfo
| |||||||||||
From class
javax.management.MBeanFeatureInfo
| |||||||||||
From class
java.lang.Object
| |||||||||||
From interface
javax.management.DescriptorAccess
| |||||||||||
From interface
javax.management.DescriptorRead
| |||||||||||
Constructs a ModelMBeanAttributeInfo object with a default
descriptor. The Descriptor of the constructed
object will include fields contributed by any annotations
on the Method objects that contain the DescriptorKey meta-annotation.
| name | The name of the attribute. |
|---|---|
| description | A human readable description of the attribute. Optional. |
| getter | The method used for reading the attribute value. May be null if the property is write-only. |
| setter | The method used for writing the attribute value. May be null if the attribute is read-only. |
| There is a consistency problem in the definition of this attribute. | |
| IntrospectionException |
Constructs a ModelMBeanAttributeInfo object. The Descriptor of the constructed object will include fields
contributed by any annotations on the Method
objects that contain the DescriptorKey
meta-annotation.
| name | The name of the attribute. |
|---|---|
| description | A human readable description of the attribute. Optional. |
| getter | The method used for reading the attribute value. May be null if the property is write-only. |
| setter | The method used for writing the attribute value. May be null if the attribute is read-only. |
| descriptor | An instance of Descriptor containing the appropriate metadata for this instance of the Attribute. If it is null, then a default descriptor will be created. If the descriptor does not contain the field "displayName" this field is added in the descriptor with its default value. |
| There is a consistency problem in the definition of this attribute. | |
| RuntimeOperationsException | Wraps an IllegalArgumentException. The descriptor is invalid, or descriptor field "name" is not equal to name parameter, or descriptor field "DescriptorType" is not equal to "attribute". |
| IntrospectionException |
Constructs a ModelMBeanAttributeInfo object with a default descriptor.
| name | The name of the attribute |
|---|---|
| type | The type or class name of the attribute |
| description | A human readable description of the attribute. |
| isReadable | True if the attribute has a getter method, false otherwise. |
| isWritable | True if the attribute has a setter method, false otherwise. |
| isIs | True if the attribute has an "is" getter, false otherwise. |
Constructs a ModelMBeanAttributeInfo object with a default descriptor.
| name | The name of the attribute |
|---|---|
| type | The type or class name of the attribute |
| description | A human readable description of the attribute. |
| isReadable | True if the attribute has a getter method, false otherwise. |
| isWritable | True if the attribute has a setter method, false otherwise. |
| isIs | True if the attribute has an "is" getter, false otherwise. |
| descriptor | An instance of Descriptor containing the appropriate metadata for this instance of the Attribute. If it is null then a default descriptor will be created. If the descriptor does not contain the field "displayName" this field is added in the descriptor with its default value. |
| RuntimeOperationsException | Wraps an IllegalArgumentException. The descriptor is invalid, or descriptor field "name" is not equal to name parameter, or descriptor field "DescriptorType" is not equal to "attribute". |
|---|
Constructs a new ModelMBeanAttributeInfo object from this ModelMBeanAttributeInfo Object. A default descriptor will be created.
| inInfo | the ModelMBeanAttributeInfo to be duplicated |
|---|
Creates and returns a new ModelMBeanAttributeInfo which is a duplicate of this ModelMBeanAttributeInfo.
| RuntimeOperationsException | for illegal value for field Names or field Values. If the descriptor construction fails for any reason, this exception will be thrown. |
|---|
Gets a copy of the associated Descriptor for the ModelMBeanAttributeInfo.
Sets associated Descriptor (full replace) for the ModelMBeanAttributeDescriptor. If the new Descriptor is null, then the associated Descriptor reverts to a default descriptor. The Descriptor is validated before it is assigned. If the new Descriptor is invalid, then a RuntimeOperationsException wrapping an IllegalArgumentException is thrown.
| inDescriptor | replaces the Descriptor associated with the ModelMBeanAttributeInfo |
|---|
| RuntimeOperationsException | Wraps an IllegalArgumentException for an invalid Descriptor |
|---|
Returns a human-readable version of the ModelMBeanAttributeInfo instance.