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 dataThe 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 | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
![]() |
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 | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
![]() | |||||||||||
![]() | |||||||||||
![]() | |||||||||||
![]() | |||||||||||
![]() |
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.