public class

OpenMBeanAttributeInfoSupport

extends MBeanAttributeInfo
implements OpenMBeanAttributeInfo
java.lang.Object
   ↳ javax.management.MBeanFeatureInfo
     ↳ javax.management.MBeanAttributeInfo
       ↳ javax.management.openmbean.OpenMBeanAttributeInfoSupport

Class Overview

Describes an attribute of an open MBean.

Summary

[Expand]
Inherited Fields
From class javax.management.MBeanFeatureInfo
Public Constructors
OpenMBeanAttributeInfoSupport(String name, String description, OpenType<?> openType, boolean isReadable, boolean isWritable, boolean isIs)
Constructs an OpenMBeanAttributeInfoSupport instance, which describes the attribute of an open MBean with the specified name, openType and description, and the specified read/write access properties.
OpenMBeanAttributeInfoSupport(String name, String description, OpenType<?> openType, boolean isReadable, boolean isWritable, boolean isIs, Descriptor descriptor)

Constructs an OpenMBeanAttributeInfoSupport instance, which describes the attribute of an open MBean with the specified name, openType, description, read/write access properties, and Descriptor.

<T> OpenMBeanAttributeInfoSupport(String name, String description, OpenType<T> openType, boolean isReadable, boolean isWritable, boolean isIs, T defaultValue)
Constructs an OpenMBeanAttributeInfoSupport instance, which describes the attribute of an open MBean with the specified name, openType, description and defaultValue, and the specified read/write access properties.
<T> OpenMBeanAttributeInfoSupport(String name, String description, OpenType<T> openType, boolean isReadable, boolean isWritable, boolean isIs, T defaultValue, T[] legalValues)

Constructs an OpenMBeanAttributeInfoSupport instance, which describes the attribute of an open MBean with the specified name, openType, description, defaultValue and legalValues, and the specified read/write access properties.

<T> OpenMBeanAttributeInfoSupport(String name, String description, OpenType<T> openType, boolean isReadable, boolean isWritable, boolean isIs, T defaultValue, Comparable<T> minValue, Comparable<T> maxValue)
Constructs an OpenMBeanAttributeInfoSupport instance, which describes the attribute of an open MBean, with the specified name, openType, description, defaultValue, minValue and maxValue.
Public Methods
boolean equals(Object obj)
Compares the specified obj parameter with this OpenMBeanAttributeInfoSupport instance for equality.
Object getDefaultValue()
Returns the default value for the attribute described by this OpenMBeanAttributeInfoSupport instance, if specified, or null otherwise.
Set<?> getLegalValues()
Returns an unmodifiable Set of legal values for the attribute described by this OpenMBeanAttributeInfoSupport instance, if specified, or null otherwise.
Comparable<?> getMaxValue()
Returns the maximal value for the attribute described by this OpenMBeanAttributeInfoSupport instance, if specified, or null otherwise.
Comparable<?> getMinValue()
Returns the minimal value for the attribute described by this OpenMBeanAttributeInfoSupport instance, if specified, or null otherwise.
OpenType<?> getOpenType()
Returns the open type for the values of the attribute described by this OpenMBeanAttributeInfoSupport instance.
boolean hasDefaultValue()
Returns true if this OpenMBeanAttributeInfoSupport instance specifies a non-null default value for the described attribute, false otherwise.
boolean hasLegalValues()
Returns true if this OpenMBeanAttributeInfoSupport instance specifies a non-null set of legal values for the described attribute, false otherwise.
boolean hasMaxValue()
Returns true if this OpenMBeanAttributeInfoSupport instance specifies a non-null maximal value for the described attribute, false otherwise.
boolean hasMinValue()
Returns true if this OpenMBeanAttributeInfoSupport instance specifies a non-null minimal value for the described attribute, false otherwise.
int hashCode()

Returns the hash code value for this OpenMBeanAttributeInfoSupport instance.

boolean isValue(Object obj)
Tests whether obj is a valid value for the attribute described by this OpenMBeanAttributeInfoSupport instance.
String toString()
Returns a string representation of this OpenMBeanAttributeInfoSupport instance.
[Expand]
Inherited Methods
From class javax.management.MBeanAttributeInfo
From class javax.management.MBeanFeatureInfo
From class java.lang.Object
From interface javax.management.DescriptorRead
From interface javax.management.openmbean.OpenMBeanAttributeInfo
From interface javax.management.openmbean.OpenMBeanParameterInfo

Public Constructors

public OpenMBeanAttributeInfoSupport (String name, String description, OpenType<?> openType, boolean isReadable, boolean isWritable, boolean isIs)

Constructs an OpenMBeanAttributeInfoSupport instance, which describes the attribute of an open MBean with the specified name, openType and description, and the specified read/write access properties.

Parameters
name cannot be a null or empty string.
description cannot be a null or empty string.
openType cannot be null.
isReadable true if the attribute has a getter exposed for management.
isWritable true if the attribute has a setter exposed for management.
isIs true if the attribute's getter is of the form isXXX.
Throws
IllegalArgumentException if name or description are null or empty string, or openType is null.

public OpenMBeanAttributeInfoSupport (String name, String description, OpenType<?> openType, boolean isReadable, boolean isWritable, boolean isIs, Descriptor descriptor)

Constructs an OpenMBeanAttributeInfoSupport instance, which describes the attribute of an open MBean with the specified name, openType, description, read/write access properties, and Descriptor.

The descriptor can contain entries that will define the values returned by certain methods of this class, as explained in the package description.

Parameters
name cannot be a null or empty string.
description cannot be a null or empty string.
openType cannot be null.
isReadable true if the attribute has a getter exposed for management.
isWritable true if the attribute has a setter exposed for management.
isIs true if the attribute's getter is of the form isXXX.
descriptor The descriptor for the attribute. This may be null which is equivalent to an empty descriptor.
Throws
IllegalArgumentException if name or description are null or empty string, or openType is null, or the descriptor entries are invalid as described in the package description.

public OpenMBeanAttributeInfoSupport (String name, String description, OpenType<T> openType, boolean isReadable, boolean isWritable, boolean isIs, T defaultValue)

Constructs an OpenMBeanAttributeInfoSupport instance, which describes the attribute of an open MBean with the specified name, openType, description and defaultValue, and the specified read/write access properties.

Parameters
name cannot be a null or empty string.
description cannot be a null or empty string.
openType cannot be null.
isReadable true if the attribute has a getter exposed for management.
isWritable true if the attribute has a setter exposed for management.
isIs true if the attribute's getter is of the form isXXX.
defaultValue must be a valid value for the openType specified for this attribute; default value not supported for ArrayType and TabularType; can be null, in which case it means that no default value is set.
Throws
IllegalArgumentException if name or description are null or empty string, or openType is null.
OpenDataException if defaultValue is not a valid value for the specified openType, or defaultValue is non null and openType is an ArrayType or a TabularType.

public OpenMBeanAttributeInfoSupport (String name, String description, OpenType<T> openType, boolean isReadable, boolean isWritable, boolean isIs, T defaultValue, T[] legalValues)

Constructs an OpenMBeanAttributeInfoSupport instance, which describes the attribute of an open MBean with the specified name, openType, description, defaultValue and legalValues, and the specified read/write access properties.

The contents of legalValues are copied, so subsequent modifications of the array referenced by legalValues have no impact on this OpenMBeanAttributeInfoSupport instance.

Parameters
name cannot be a null or empty string.
description cannot be a null or empty string.
openType cannot be null.
isReadable true if the attribute has a getter exposed for management.
isWritable true if the attribute has a setter exposed for management.
isIs true if the attribute's getter is of the form isXXX.
defaultValue must be a valid value for the openType specified for this attribute; default value not supported for ArrayType and TabularType; can be null, in which case it means that no default value is set.
legalValues each contained value must be valid for the openType specified for this attribute; legal values not supported for ArrayType and TabularType; can be null or empty.
Throws
IllegalArgumentException if name or description are null or empty string, or openType is null.
OpenDataException if defaultValue is not a valid value for the specified openType, or one value in legalValues is not valid for the specified openType, or defaultValue is non null and openType is an ArrayType or a TabularType, or legalValues is non null and non empty and openType is an ArrayType or a TabularType, or legalValues is non null and non empty and defaultValue is not contained in legalValues.

public OpenMBeanAttributeInfoSupport (String name, String description, OpenType<T> openType, boolean isReadable, boolean isWritable, boolean isIs, T defaultValue, Comparable<T> minValue, Comparable<T> maxValue)

Constructs an OpenMBeanAttributeInfoSupport instance, which describes the attribute of an open MBean, with the specified name, openType, description, defaultValue, minValue and maxValue. It is possible to specify minimal and maximal values only for an open type whose values are Comparable.

Parameters
name cannot be a null or empty string.
description cannot be a null or empty string.
openType cannot be null.
isReadable true if the attribute has a getter exposed for management.
isWritable true if the attribute has a setter exposed for management.
isIs true if the attribute's getter is of the form isXXX.
defaultValue must be a valid value for the openType specified for this attribute; default value not supported for ArrayType and TabularType; can be null, in which case it means that no default value is set.
minValue must be valid for the openType specified for this attribute; can be null, in which case it means that no minimal value is set.
maxValue must be valid for the openType specified for this attribute; can be null, in which case it means that no maximal value is set.
Throws
IllegalArgumentException if name or description are null or empty string, or openType is null.
OpenDataException if defaultValue, minValue or maxValue is not a valid value for the specified openType, or defaultValue is non null and openType is an ArrayType or a TabularType, or both minValue and maxValue are non-null and minValue.compareTo(maxValue) > 0 is true, or both defaultValue and minValue are non-null and minValue.compareTo(defaultValue) > 0 is true, or both defaultValue and maxValue are non-null and defaultValue.compareTo(maxValue) > 0 is true.

Public Methods

public boolean equals (Object obj)

Compares the specified obj parameter with this OpenMBeanAttributeInfoSupport instance for equality.

Returns true if and only if all of the following statements are true:

  • obj is non null,
  • obj also implements the OpenMBeanAttributeInfo interface,
  • their names are equal
  • their open types are equal
  • their access properties (isReadable, isWritable and isIs) are equal
  • their default, min, max and legal values are equal.
This ensures that this equals method works properly for obj parameters which are different implementations of the OpenMBeanAttributeInfo interface.

If obj also implements DescriptorRead, then its getDescriptor() method must also return the same value as for this object.

Parameters
obj the object to be compared for equality with this OpenMBeanAttributeInfoSupport instance.
Returns
  • true if the specified object is equal to this OpenMBeanAttributeInfoSupport instance.

public Object getDefaultValue ()

Returns the default value for the attribute described by this OpenMBeanAttributeInfoSupport instance, if specified, or null otherwise.

Returns
  • the default value.

public Set<?> getLegalValues ()

Returns an unmodifiable Set of legal values for the attribute described by this OpenMBeanAttributeInfoSupport instance, if specified, or null otherwise.

Returns
  • the set of legal values.

public Comparable<?> getMaxValue ()

Returns the maximal value for the attribute described by this OpenMBeanAttributeInfoSupport instance, if specified, or null otherwise.

Returns
  • the maximum value.

public Comparable<?> getMinValue ()

Returns the minimal value for the attribute described by this OpenMBeanAttributeInfoSupport instance, if specified, or null otherwise.

Returns
  • the minimum value.

public OpenType<?> getOpenType ()

Returns the open type for the values of the attribute described by this OpenMBeanAttributeInfoSupport instance.

Returns
  • the open type.

public boolean hasDefaultValue ()

Returns true if this OpenMBeanAttributeInfoSupport instance specifies a non-null default value for the described attribute, false otherwise.

Returns
  • true if there is a default value.

public boolean hasLegalValues ()

Returns true if this OpenMBeanAttributeInfoSupport instance specifies a non-null set of legal values for the described attribute, false otherwise.

Returns
  • true if there is a set of legal values.

public boolean hasMaxValue ()

Returns true if this OpenMBeanAttributeInfoSupport instance specifies a non-null maximal value for the described attribute, false otherwise.

Returns
  • true if there is a maximum value.

public boolean hasMinValue ()

Returns true if this OpenMBeanAttributeInfoSupport instance specifies a non-null minimal value for the described attribute, false otherwise.

Returns
  • true if there is a minimum value.

public int hashCode ()

Returns the hash code value for this OpenMBeanAttributeInfoSupport instance.

The hash code of an OpenMBeanAttributeInfoSupport instance is the sum of the hash codes of all elements of information used in equals comparisons (ie: its name, its open type, its default, min, max and legal values, and its Descriptor).

This ensures that t1.equals(t2) implies that t1.hashCode()==t2.hashCode() for any two OpenMBeanAttributeInfoSupport instances t1 and t2, as required by the general contract of the method Object.hashCode().

However, note that another instance of a class implementing the OpenMBeanAttributeInfo interface may be equal to this OpenMBeanAttributeInfoSupport instance as defined by equals(java.lang.Object), but may have a different hash code if it is calculated differently.

As OpenMBeanAttributeInfoSupport instances are immutable, the hash code for this instance is calculated once, on the first call to hashCode, and then the same value is returned for subsequent calls.

Returns
  • the hash code value for this OpenMBeanAttributeInfoSupport instance

public boolean isValue (Object obj)

Tests whether obj is a valid value for the attribute described by this OpenMBeanAttributeInfoSupport instance.

Parameters
obj the object to be tested.
Returns
  • true if obj is a valid value for the parameter described by this OpenMBeanAttributeInfoSupport instance, false otherwise.

public String toString ()

Returns a string representation of this OpenMBeanAttributeInfoSupport instance.

The string representation consists of the name of this class (i.e. javax.management.openmbean.OpenMBeanAttributeInfoSupport), the string representation of the name and open type of the described parameter, the string representation of its default, min, max and legal values and the string representation of its descriptor.

As OpenMBeanAttributeInfoSupport instances are immutable, the string representation for this instance is calculated once, on the first call to toString, and then the same value is returned for subsequent calls.

Returns
  • a string representation of this OpenMBeanAttributeInfoSupport instance.