Class OpenMBeanAttributeInfoSupport
- All Implemented Interfaces:
-
Serializable
,Cloneable
,DescriptorRead
,OpenMBeanAttributeInfo
,OpenMBeanParameterInfo
public class OpenMBeanAttributeInfoSupport extends MBeanAttributeInfo implements OpenMBeanAttributeInfo
- Since:
- 1.5
- See Also:
Field Summary
Fields declared in class javax.management.MBeanFeatureInfo
description, name
Constructor Summary
Constructor | Description |
---|---|
OpenMBeanAttributeInfoSupport |
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 |
Constructs an OpenMBeanAttributeInfoSupport instance, which describes the attribute of an open MBean with the specified name , openType ,
description , read/write access properties, and Descriptor . |
OpenMBeanAttributeInfoSupport |
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. |
OpenMBeanAttributeInfoSupport |
Constructs an OpenMBeanAttributeInfoSupport instance, which describes the attribute of an open MBean, with the specified name , openType , description , defaultValue , minValue and maxValue . |
OpenMBeanAttributeInfoSupport |
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. |
Method Summary
Modifier and Type | Method | Description |
---|---|---|
boolean |
equals |
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. |
int |
hashCode() |
Returns the hash code value for this
OpenMBeanAttributeInfoSupport instance. |
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. |
boolean |
isValue |
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. |
Methods declared in class javax.management.MBeanAttributeInfo
clone, getType, isIs, isReadable, isWritable
Methods declared in class javax.management.MBeanFeatureInfo
getDescription, getDescriptor, getName
Methods declared in interface javax.management.openmbean.OpenMBeanAttributeInfo
isIs, isReadable, isWritable
Methods declared in interface javax.management.openmbean.OpenMBeanParameterInfo
getDescription, getName
Constructor Details
OpenMBeanAttributeInfoSupport
public OpenMBeanAttributeInfoSupport(String name, String description, OpenType<?> openType, boolean isReadable, boolean isWritable, boolean isIs)
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 formisXXX
. - Throws:
-
IllegalArgumentException
- ifname
ordescription
are null or empty string, oropenType
is null.
OpenMBeanAttributeInfoSupport
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 formisXXX
. -
descriptor
- The descriptor for the attribute. This may be null which is equivalent to an empty descriptor. - Throws:
-
IllegalArgumentException
- ifname
ordescription
are null or empty string, oropenType
is null, or the descriptor entries are invalid as described in the package description. - Since:
- 1.6
OpenMBeanAttributeInfoSupport
public OpenMBeanAttributeInfoSupport(String name, String description, OpenType<T> openType, boolean isReadable, boolean isWritable, boolean isIs, T defaultValue) throws OpenDataException
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.- Type Parameters:
-
T
- allows the compiler to check that thedefaultValue
, if non-null, has the correct Java type for the givenopenType
. - 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 formisXXX
. -
defaultValue
- must be a valid value for theopenType
specified for this attribute; default value not supported forArrayType
andTabularType
; can be null, in which case it means that no default value is set. - Throws:
-
IllegalArgumentException
- ifname
ordescription
are null or empty string, oropenType
is null. -
OpenDataException
- ifdefaultValue
is not a valid value for the specifiedopenType
, ordefaultValue
is non null andopenType
is anArrayType
or aTabularType
.
OpenMBeanAttributeInfoSupport
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.
- Type Parameters:
-
T
- allows the compiler to check that thedefaultValue
andlegalValues
, if non-null, have the correct Java type for the givenopenType
. - 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 formisXXX
. -
defaultValue
- must be a valid value for theopenType
specified for this attribute; default value not supported forArrayType
andTabularType
; can be null, in which case it means that no default value is set. -
legalValues
- each contained value must be valid for theopenType
specified for this attribute; legal values not supported forArrayType
andTabularType
; can be null or empty. - Throws:
-
IllegalArgumentException
- ifname
ordescription
are null or empty string, oropenType
is null. -
OpenDataException
- ifdefaultValue
is not a valid value for the specifiedopenType
, or one value inlegalValues
is not valid for the specifiedopenType
, ordefaultValue
is non null andopenType
is anArrayType
or aTabularType
, orlegalValues
is non null and non empty andopenType
is anArrayType
or aTabularType
, orlegalValues
is non null and non empty anddefaultValue
is not contained inlegalValues
.
OpenMBeanAttributeInfoSupport
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
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
.- Type Parameters:
-
T
- allows the compiler to check that thedefaultValue
,minValue
, andmaxValue
, if non-null, have the correct Java type for the givenopenType
. - 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 formisXXX
. -
defaultValue
- must be a valid value for theopenType
specified for this attribute; default value not supported forArrayType
andTabularType
; can be null, in which case it means that no default value is set. -
minValue
- must be valid for theopenType
specified for this attribute; can be null, in which case it means that no minimal value is set. -
maxValue
- must be valid for theopenType
specified for this attribute; can be null, in which case it means that no maximal value is set. - Throws:
-
IllegalArgumentException
- ifname
ordescription
are null or empty string, oropenType
is null. -
OpenDataException
- ifdefaultValue
,minValue
ormaxValue
is not a valid value for the specifiedopenType
, ordefaultValue
is non null andopenType
is anArrayType
or aTabularType
, or bothminValue
andmaxValue
are non-null andminValue.compareTo(maxValue) > 0
istrue
, or bothdefaultValue
andminValue
are non-null andminValue.compareTo(defaultValue) > 0
istrue
, or bothdefaultValue
andmaxValue
are non-null anddefaultValue.compareTo(maxValue) > 0
istrue
.
Method Details
getOpenType
public OpenType<?> getOpenType()
OpenMBeanAttributeInfoSupport
instance.- Specified by:
-
getOpenType
in interfaceOpenMBeanParameterInfo
- Returns:
- the open type.
getDefaultValue
public Object getDefaultValue()
OpenMBeanAttributeInfoSupport
instance, if specified, or null
otherwise.- Specified by:
-
getDefaultValue
in interfaceOpenMBeanParameterInfo
- Returns:
- the default value.
getLegalValues
public Set<?> getLegalValues()
OpenMBeanAttributeInfoSupport
instance, if specified, or null
otherwise.- Specified by:
-
getLegalValues
in interfaceOpenMBeanParameterInfo
- Returns:
- the set of legal values.
getMinValue
public Comparable<?> getMinValue()
OpenMBeanAttributeInfoSupport
instance, if specified, or null
otherwise.- Specified by:
-
getMinValue
in interfaceOpenMBeanParameterInfo
- Returns:
- the minimum value.
getMaxValue
public Comparable<?> getMaxValue()
OpenMBeanAttributeInfoSupport
instance, if specified, or null
otherwise.- Specified by:
-
getMaxValue
in interfaceOpenMBeanParameterInfo
- Returns:
- the maximum value.
hasDefaultValue
public boolean hasDefaultValue()
true
if this
OpenMBeanAttributeInfoSupport
instance specifies a non-null default value for the described attribute, false
otherwise.- Specified by:
-
hasDefaultValue
in interfaceOpenMBeanParameterInfo
- Returns:
- true if there is a default value.
hasLegalValues
public boolean hasLegalValues()
true
if this
OpenMBeanAttributeInfoSupport
instance specifies a non-null set of legal values for the described attribute, false
otherwise.- Specified by:
-
hasLegalValues
in interfaceOpenMBeanParameterInfo
- Returns:
- true if there is a set of legal values.
hasMinValue
public boolean hasMinValue()
true
if this
OpenMBeanAttributeInfoSupport
instance specifies a non-null minimal value for the described attribute, false
otherwise.- Specified by:
-
hasMinValue
in interfaceOpenMBeanParameterInfo
- Returns:
- true if there is a minimum value.
hasMaxValue
public boolean hasMaxValue()
true
if this
OpenMBeanAttributeInfoSupport
instance specifies a non-null maximal value for the described attribute, false
otherwise.- Specified by:
-
hasMaxValue
in interfaceOpenMBeanParameterInfo
- Returns:
- true if there is a maximum value.
isValue
public boolean isValue(Object obj)
obj
is a valid value for the attribute described by this OpenMBeanAttributeInfoSupport
instance.- Specified by:
-
isValue
in interfaceOpenMBeanParameterInfo
- Parameters:
-
obj
- the object to be tested. - Returns:
-
true
ifobj
is a valid value for the parameter described by thisOpenMBeanAttributeInfoSupport
instance,false
otherwise.
equals
public boolean equals(Object obj)
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 theOpenMBeanAttributeInfo
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.
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.
- Specified by:
-
equals
in interfaceOpenMBeanAttributeInfo
- Specified by:
-
equals
in interfaceOpenMBeanParameterInfo
- Overrides:
-
equals
in classMBeanAttributeInfo
- Parameters:
-
obj
- the object to be compared for equality with thisOpenMBeanAttributeInfoSupport
instance. - Returns:
-
true
if the specified object is equal to thisOpenMBeanAttributeInfoSupport
instance. - See Also:
hashCode
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.
- Specified by:
-
hashCode
in interfaceOpenMBeanAttributeInfo
- Specified by:
-
hashCode
in interfaceOpenMBeanParameterInfo
- Overrides:
-
hashCode
in classObject
- Returns:
- the hash code value for this
OpenMBeanAttributeInfoSupport
instance - See Also:
toString
public String toString()
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.
- Specified by:
-
toString
in interfaceOpenMBeanAttributeInfo
- Specified by:
-
toString
in interfaceOpenMBeanParameterInfo
- Overrides:
-
toString
in classObject
- Returns:
- a string representation of this
OpenMBeanAttributeInfoSupport
instance.
© 1993, 2021, 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.
https://docs.oracle.com/en/java/javase/17/docs/api/java.management/javax/management/openmbean/OpenMBeanAttributeInfoSupport.html