compact3

javax.management.openmbean

Class OpenMBeanParameterInfoSupport

java.lang.Object

javax.management.MBeanFeatureInfo

javax.management.MBeanParameterInfo

javax.management.openmbean.OpenMBeanParameterInfoSupport

All Implemented Interfaces:

Serializable, Cloneable, DescriptorRead, OpenMBeanParameterInfo

public class OpenMBeanParameterInfoSupport
extends MBeanParameterInfo
implements OpenMBeanParameterInfo

Describes a parameter used in one or more operations or constructors of an open MBean.

Since:

1.5

See Also:

Serialized Form

Field Summary

Fields inherited from class javax.management.MBeanFeatureInfo

description, name

Constructor Summary

Constructors

Constructor	Description
OpenMBeanParameterInfoSupport(String name, String description, OpenType<?> openType)	Constructs an OpenMBeanParameterInfoSupport instance, which describes the parameter used in one or more operations or constructors of a class of open MBeans, with the specified name, openType and description.
OpenMBeanParameterInfoSupport(String name, String description, OpenType<?> openType, Descriptor descriptor)	Constructs an OpenMBeanParameterInfoSupport instance, which describes the parameter used in one or more operations or constructors of a class of open MBeans, with the specified name, openType, description, and descriptor.
OpenMBeanParameterInfoSupport(String name, String description, OpenType<T> openType, T defaultValue)	Constructs an OpenMBeanParameterInfoSupport instance, which describes the parameter used in one or more operations or constructors of a class of open MBeans, with the specified name, openType, description and defaultValue.
OpenMBeanParameterInfoSupport(String name, String description, OpenType<T> openType, T defaultValue, Comparable<T> minValue, Comparable<T> maxValue)	Constructs an OpenMBeanParameterInfoSupport instance, which describes the parameter used in one or more operations or constructors of a class of open MBeans, with the specified name, openType, description, defaultValue, minValue and maxValue.
OpenMBeanParameterInfoSupport(String name, String description, OpenType<T> openType, T defaultValue, T[] legalValues)	Constructs an OpenMBeanParameterInfoSupport instance, which describes the parameter used in one or more operations or constructors of a class of open MBeans, with the specified name, openType, description, defaultValue and legalValues.

Method Summary

Modifier and Type	Method	Description
boolean	equals(Object obj)	Compares the specified obj parameter with this OpenMBeanParameterInfoSupport instance for equality.
Object	getDefaultValue()	Returns the default value for the parameter described by this OpenMBeanParameterInfoSupport instance, if specified, or null otherwise.
Set<?>	getLegalValues()	Returns an unmodifiable Set of legal values for the parameter described by this OpenMBeanParameterInfoSupport instance, if specified, or null otherwise.
Comparable<?>	getMaxValue()	Returns the maximal value for the parameter described by this OpenMBeanParameterInfoSupport instance, if specified, or null otherwise.
Comparable<?>	getMinValue()	Returns the minimal value for the parameter described by this OpenMBeanParameterInfoSupport instance, if specified, or null otherwise.
OpenType<?>	getOpenType()	Returns the open type for the values of the parameter described by this OpenMBeanParameterInfoSupport instance.
boolean	hasDefaultValue()	Returns true if this OpenMBeanParameterInfoSupport instance specifies a non-null default value for the described parameter, false otherwise.
int	hashCode()	Returns the hash code value for this OpenMBeanParameterInfoSupport instance.
boolean	hasLegalValues()	Returns true if this OpenMBeanParameterInfoSupport instance specifies a non-null set of legal values for the described parameter, false otherwise.
boolean	hasMaxValue()	Returns true if this OpenMBeanParameterInfoSupport instance specifies a non-null maximal value for the described parameter, false otherwise.
boolean	hasMinValue()	Returns true if this OpenMBeanParameterInfoSupport instance specifies a non-null minimal value for the described parameter, false otherwise.
boolean	isValue(Object obj)	Tests whether obj is a valid value for the parameter described by this OpenMBeanParameterInfo instance.
String	toString()	Returns a string representation of this OpenMBeanParameterInfoSupport instance.

Methods inherited from class javax.management.MBeanParameterInfo

clone, getType

Methods inherited from class javax.management.MBeanFeatureInfo

getDescription, getDescriptor, getName

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface javax.management.openmbean.OpenMBeanParameterInfo

getDescription, getName

Constructor Detail

OpenMBeanParameterInfoSupport

public OpenMBeanParameterInfoSupport(String name,
                                     String description,
                                     OpenType<?> openType)

Constructs an OpenMBeanParameterInfoSupport instance, which describes the parameter used in one or more operations or constructors of a class of open MBeans, with the specified name, openType and description.

Parameters:

name - cannot be a null or empty string.

description - cannot be a null or empty string.

openType - cannot be null.

Throws:

IllegalArgumentException - if name or description are null or empty string, or openType is null.

OpenMBeanParameterInfoSupport

public OpenMBeanParameterInfoSupport(String name,
                                     String description,
                                     OpenType<?> openType,
                                     Descriptor descriptor)

Constructs an OpenMBeanParameterInfoSupport instance, which describes the parameter used in one or more operations or constructors of a class of open MBeans, with the specified name, openType, description, 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.

descriptor - The descriptor for the parameter. 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.

Since:

1.6

OpenMBeanParameterInfoSupport

public OpenMBeanParameterInfoSupport(String name,
                                     String description,
                                     OpenType<T> openType,
                                     T defaultValue)
                              throws OpenDataException

Constructs an OpenMBeanParameterInfoSupport instance, which describes the parameter used in one or more operations or constructors of a class of open MBeans, with the specified name, openType, description and defaultValue.

Type Parameters:

T - allows the compiler to check that the defaultValue, if non-null, has the correct Java type for the given openType.

Parameters:

name - cannot be a null or empty string.

description - cannot be a null or empty string.

openType - cannot be null.

defaultValue - must be a valid value for the openType specified for this parameter; 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.

OpenMBeanParameterInfoSupport

public OpenMBeanParameterInfoSupport(String name,
                                     String description,
                                     OpenType<T> openType,
                                     T defaultValue,
                                     T[] legalValues)
                              throws OpenDataException

Constructs an OpenMBeanParameterInfoSupport instance, which describes the parameter used in one or more operations or constructors of a class of open MBeans, with the specified name, openType, description, defaultValue and legalValues.

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

Type Parameters:

T - allows the compiler to check that the defaultValue and legalValues, if non-null, have the correct Java type for the given openType.

Parameters:

name - cannot be a null or empty string.

description - cannot be a null or empty string.

openType - cannot be null.

defaultValue - must be a valid value for the openType specified for this parameter; 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 parameter; 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.

OpenMBeanParameterInfoSupport

public OpenMBeanParameterInfoSupport(String name,
                                     String description,
                                     OpenType<T> openType,
                                     T defaultValue,
                                     Comparable<T> minValue,
                                     Comparable<T> maxValue)
                              throws OpenDataException

Constructs an OpenMBeanParameterInfoSupport instance, which describes the parameter used in one or more operations or constructors of a class of open MBeans, 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 the defaultValue, minValue, and maxValue, if non-null, have the correct Java type for the given openType.

Parameters:

name - cannot be a null or empty string.

description - cannot be a null or empty string.

openType - cannot be null.

defaultValue - must be a valid value for the openType specified for this parameter; 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 parameter; can be null, in which case it means that no minimal value is set.

maxValue - must be valid for the openType specified for this parameter; 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.

Method Detail

getOpenType

public OpenType<?> getOpenType()

Returns the open type for the values of the parameter described by this OpenMBeanParameterInfoSupport instance.

Specified by:

getOpenType in interface OpenMBeanParameterInfo

Returns:

the open type.

getDefaultValue

public Object getDefaultValue()

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

Specified by:

getDefaultValue in interface OpenMBeanParameterInfo

Returns:

the default value.

getLegalValues

public Set<?> getLegalValues()

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

Specified by:

getLegalValues in interface OpenMBeanParameterInfo

Returns:

the set of legal values.

getMinValue

public Comparable<?> getMinValue()

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

Specified by:

getMinValue in interface OpenMBeanParameterInfo

Returns:

the minimum value.

getMaxValue

public Comparable<?> getMaxValue()

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

Specified by:

getMaxValue in interface OpenMBeanParameterInfo

Returns:

the maximum value.

hasDefaultValue

public boolean hasDefaultValue()

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

Specified by:

hasDefaultValue in interface OpenMBeanParameterInfo

Returns:

true if there is a default value.

hasLegalValues

public boolean hasLegalValues()

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

Specified by:

hasLegalValues in interface OpenMBeanParameterInfo

Returns:

true if there is a set of legal values.

hasMinValue

public boolean hasMinValue()

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

Specified by:

hasMinValue in interface OpenMBeanParameterInfo

Returns:

true if there is a minimum value.

hasMaxValue

public boolean hasMaxValue()

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

Specified by:

hasMaxValue in interface OpenMBeanParameterInfo

Returns:

true if there is a maximum value.