public class OpenMBeanAttributeInfoSupport extends MBeanAttributeInfo implements OpenMBeanAttributeInfo
Describes an attribute of an open MBean.
description, name
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.
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
.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.
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.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) throws OpenDataException
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
- allows the compiler to check that the defaultValue
, if non-null, has the correct Java type for the given openType
.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.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) throws OpenDataException
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.
T
- allows the compiler to check that the defaultValue
and legalValues
, if non-null, have the correct Java type for the given openType
.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.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) throws OpenDataException
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
.
T
- allows the compiler to check that the defaultValue
, minValue
, and maxValue
, if non-null, have the correct Java type for the given openType
.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.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 OpenType<?> getOpenType()
Returns the open type for the values of the attribute described by this OpenMBeanAttributeInfoSupport
instance.
getOpenType
in interface OpenMBeanParameterInfo
public Object getDefaultValue()
Returns the default value for the attribute described by this OpenMBeanAttributeInfoSupport
instance, if specified, or null
otherwise.
getDefaultValue
in interface OpenMBeanParameterInfo
public Set<?> getLegalValues()
Returns an unmodifiable Set of legal values for the attribute described by this OpenMBeanAttributeInfoSupport
instance, if specified, or null
otherwise.
getLegalValues
in interface OpenMBeanParameterInfo
public Comparable<?> getMinValue()
Returns the minimal value for the attribute described by this OpenMBeanAttributeInfoSupport
instance, if specified, or null
otherwise.
getMinValue
in interface OpenMBeanParameterInfo
public Comparable<?> getMaxValue()
Returns the maximal value for the attribute described by this OpenMBeanAttributeInfoSupport
instance, if specified, or null
otherwise.
getMaxValue
in interface OpenMBeanParameterInfo
public boolean hasDefaultValue()
Returns true
if this OpenMBeanAttributeInfoSupport
instance specifies a non-null default value for the described attribute, false
otherwise.
hasDefaultValue
in interface OpenMBeanParameterInfo
public boolean hasLegalValues()
Returns true
if this OpenMBeanAttributeInfoSupport
instance specifies a non-null set of legal values for the described attribute, false
otherwise.
hasLegalValues
in interface OpenMBeanParameterInfo
public boolean hasMinValue()
Returns true
if this OpenMBeanAttributeInfoSupport
instance specifies a non-null minimal value for the described attribute, false
otherwise.
hasMinValue
in interface OpenMBeanParameterInfo
public boolean hasMaxValue()
Returns true
if this OpenMBeanAttributeInfoSupport
instance specifies a non-null maximal value for the described attribute, false
otherwise.
hasMaxValue
in interface OpenMBeanParameterInfo
public boolean isValue(Object obj)
Tests whether obj
is a valid value for the attribute described by this OpenMBeanAttributeInfoSupport
instance.
isValue
in interface OpenMBeanParameterInfo
obj
- the object to be tested.true
if obj
is a valid value for the parameter described by this OpenMBeanAttributeInfoSupport
instance, false
otherwise.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,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.
equals
in interface OpenMBeanAttributeInfo
equals
in interface OpenMBeanParameterInfo
equals
in class MBeanAttributeInfo
obj
- the object to be compared for equality with this OpenMBeanAttributeInfoSupport
instance.true
if the specified object is equal to this OpenMBeanAttributeInfoSupport
instance.Object.hashCode()
, HashMap
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.
hashCode
in interface OpenMBeanAttributeInfo
hashCode
in interface OpenMBeanParameterInfo
hashCode
in class MBeanAttributeInfo
OpenMBeanAttributeInfoSupport
instanceObject.equals(java.lang.Object)
, System.identityHashCode(java.lang.Object)
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.
toString
in interface OpenMBeanAttributeInfo
toString
in interface OpenMBeanParameterInfo
toString
in class MBeanAttributeInfo
OpenMBeanAttributeInfoSupport
instance.
© 1993–2017, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.