- 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 and Description OpenMBeanParameterInfoSupport(String name, String description, OpenType<?> openType)
Constructs anOpenMBeanParameterInfoSupport
instance, which describes the parameter used in one or more operations or constructors of a class of open MBeans, with the specifiedname
,openType
anddescription
.OpenMBeanParameterInfoSupport(String name, String description, OpenType<?> openType, Descriptor descriptor)
Constructs anOpenMBeanParameterInfoSupport
instance, which describes the parameter used in one or more operations or constructors of a class of open MBeans, with the specifiedname
,openType
,description
, anddescriptor
.OpenMBeanParameterInfoSupport(String name, String description, OpenType<T> openType, T defaultValue)
Constructs anOpenMBeanParameterInfoSupport
instance, which describes the parameter used in one or more operations or constructors of a class of open MBeans, with the specifiedname
,openType
,description
anddefaultValue
.OpenMBeanParameterInfoSupport(String name, String description, OpenType<T> openType, T defaultValue, Comparable<T> minValue, Comparable<T> maxValue)
Constructs anOpenMBeanParameterInfoSupport
instance, which describes the parameter used in one or more operations or constructors of a class of open MBeans, with the specifiedname
,openType
,description
,defaultValue
,minValue
andmaxValue
.OpenMBeanParameterInfoSupport(String name, String description, OpenType<T> openType, T defaultValue, T[] legalValues)
Constructs anOpenMBeanParameterInfoSupport
instance, which describes the parameter used in one or more operations or constructors of a class of open MBeans, with the specifiedname
,openType
,description
,defaultValue
andlegalValues
.
-
Method Summary
Methods Modifier and Type Method and Description boolean
equals(Object obj)
Compares the specifiedobj
parameter with thisOpenMBeanParameterInfoSupport
instance for equality.Object
getDefaultValue()
Returns the default value for the parameter described by thisOpenMBeanParameterInfoSupport
instance, if specified, ornull
otherwise.Set<?>
getLegalValues()
Returns an unmodifiable Set of legal values for the parameter described by thisOpenMBeanParameterInfoSupport
instance, if specified, ornull
otherwise.Comparable<?>
getMaxValue()
Returns the maximal value for the parameter described by thisOpenMBeanParameterInfoSupport
instance, if specified, ornull
otherwise.Comparable<?>
getMinValue()
Returns the minimal value for the parameter described by thisOpenMBeanParameterInfoSupport
instance, if specified, ornull
otherwise.OpenType<?>
getOpenType()
Returns the open type for the values of the parameter described by thisOpenMBeanParameterInfoSupport
instance.boolean
hasDefaultValue()
Returnstrue
if thisOpenMBeanParameterInfoSupport
instance specifies a non-null default value for the described parameter,false
otherwise.int
hashCode()
Returns the hash code value for thisOpenMBeanParameterInfoSupport
instance.boolean
hasLegalValues()
Returnstrue
if thisOpenMBeanParameterInfoSupport
instance specifies a non-null set of legal values for the described parameter,false
otherwise.boolean
hasMaxValue()
Returnstrue
if thisOpenMBeanParameterInfoSupport
instance specifies a non-null maximal value for the described parameter,false
otherwise.boolean
hasMinValue()
Returnstrue
if thisOpenMBeanParameterInfoSupport
instance specifies a non-null minimal value for the described parameter,false
otherwise.boolean
isValue(Object obj)
Tests whetherobj
is a valid value for the parameter described by thisOpenMBeanParameterInfo
instance.String
toString()
Returns a string representation of thisOpenMBeanParameterInfoSupport
instance.-
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 anOpenMBeanParameterInfoSupport
instance, which describes the parameter used in one or more operations or constructors of a class of open MBeans, with the specifiedname
,openType
anddescription
.- Parameters:
name
- cannot be a null or empty string.description
- cannot be a null or empty string.openType
- cannot be null.- Throws:
IllegalArgumentException
- ifname
ordescription
are null or empty string, oropenType
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 specifiedname
,openType
,description
, anddescriptor
.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
- 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
-
OpenMBeanParameterInfoSupport
public OpenMBeanParameterInfoSupport(String name, String description, OpenType<T> openType, T defaultValue) throws OpenDataException
Constructs anOpenMBeanParameterInfoSupport
instance, which describes the parameter used in one or more operations or constructors of a class of open MBeans, with the specifiedname
,openType
,description
anddefaultValue
.- 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.defaultValue
- must be a valid value for theopenType
specified for this parameter; 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
.
-
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 specifiedname
,openType
,description
,defaultValue
andlegalValues
.The contents of
legalValues
are copied, so subsequent modifications of the array referenced bylegalValues
have no impact on thisOpenMBeanParameterInfoSupport
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.defaultValue
- must be a valid value for theopenType
specified for this parameter; 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 parameter; 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
.
-
OpenMBeanParameterInfoSupport
public OpenMBeanParameterInfoSupport(String name, String description, OpenType<T> openType, T defaultValue, Comparable<T> minValue, Comparable<T> maxValue) throws OpenDataException
Constructs anOpenMBeanParameterInfoSupport
instance, which describes the parameter used in one or more operations or constructors of a class of open MBeans, with the specifiedname
,openType
,description
,defaultValue
,minValue
andmaxValue
. It is possible to specify minimal and maximal values only for an open type whose values areComparable
.- 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.defaultValue
- must be a valid value for theopenType
specified for this parameter; 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 parameter; can be null, in which case it means that no minimal value is set.maxValue
- must be valid for theopenType
specified for this parameter; 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 Detail
-
getOpenType
public OpenType<?> getOpenType()
Returns the open type for the values of the parameter described by thisOpenMBeanParameterInfoSupport
instance.- Specified by:
getOpenType
in interfaceOpenMBeanParameterInfo
- Returns:
- the open type.
-
getDefaultValue
public Object getDefaultValue()
Returns the default value for the parameter described by thisOpenMBeanParameterInfoSupport
instance, if specified, ornull
otherwise.- Specified by:
getDefaultValue
in interfaceOpenMBeanParameterInfo
- Returns:
- the default value.
-
getLegalValues
public Set<?> getLegalValues()
Returns an unmodifiable Set of legal values for the parameter described by thisOpenMBeanParameterInfoSupport
instance, if specified, ornull
otherwise.- Specified by:
getLegalValues
in interfaceOpenMBeanParameterInfo
- Returns:
- the set of legal values.
-
getMinValue
public Comparable<?> getMinValue()
Returns the minimal value for the parameter described by thisOpenMBeanParameterInfoSupport
instance, if specified, ornull
otherwise.- Specified by:
getMinValue
in interfaceOpenMBeanParameterInfo
- Returns:
- the minimum value.
-
getMaxValue
public Comparable<?> getMaxValue()
Returns the maximal value for the parameter described by thisOpenMBeanParameterInfoSupport
instance, if specified, ornull
otherwise.- Specified by:
getMaxValue
in interfaceOpenMBeanParameterInfo
- Returns:
- the maximum value.
-
hasDefaultValue
public boolean hasDefaultValue()
Returnstrue
if thisOpenMBeanParameterInfoSupport
instance specifies a non-null default value for the described parameter,false
otherwise.- Specified by:
hasDefaultValue
in interfaceOpenMBeanParameterInfo
- Returns:
- true if there is a default value.
-
hasLegalValues
public boolean hasLegalValues()
Returnstrue
if thisOpenMBeanParameterInfoSupport
instance specifies a non-null set of legal values for the described parameter,false
otherwise.- Specified by:
hasLegalValues
in interfaceOpenMBeanParameterInfo
- Returns:
- true if there is a set of legal values.
-
hasMinValue
public boolean hasMinValue()
Returnstrue
if thisOpenMBeanParameterInfoSupport
instance specifies a non-null minimal value for the described parameter,false
otherwise.- Specified by:
hasMinValue
in interfaceOpenMBeanParameterInfo
- Returns:
- true if there is a minimum value.
-
hasMaxValue
public boolean hasMaxValue()
Returnstrue
if thisOpenMBeanParameterInfoSupport
instance specifies a non-null maximal value for the described parameter,false
otherwise.- Specified by:
hasMaxValue
in interfaceOpenMBeanParameterInfo
- Returns:
- true if there is a maximum value.
-
isValue
public boolean isValue(Object obj)
Tests whetherobj
is a valid value for the parameter described by thisOpenMBeanParameterInfo
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 thisOpenMBeanParameterInfo
instance,false
otherwise.
-
equals
public boolean equals(Object obj)
Compares the specified
obj
parameter with thisOpenMBeanParameterInfoSupport
instance for equality.Returns
true
if and only if all of the following statements are true:obj
is non null,obj
also implements theOpenMBeanParameterInfo
interface,- their names are equal
- their open types are equal
- their default, min, max and legal values are equal.
equals
method works properly forobj
parameters which are different implementations of theOpenMBeanParameterInfo
interface.If
obj
also implementsDescriptorRead
, then itsgetDescriptor()
method must also return the same value as for this object.- Specified by:
equals
in interfaceOpenMBeanParameterInfo
- Overrides:
equals
in classMBeanParameterInfo
- Parameters:
obj
- the object to be compared for equality with thisOpenMBeanParameterInfoSupport
instance.- Returns:
true
if the specified object is equal to thisOpenMBeanParameterInfoSupport
instance.- See Also:
Object.hashCode()
,HashMap
-
hashCode
public int hashCode()
Returns the hash code value for this
OpenMBeanParameterInfoSupport
instance.The hash code of an
OpenMBeanParameterInfoSupport
instance is the sum of the hash codes of all elements of information used inequals
comparisons (ie: its name, its open type, its default, min, max and legal values, and its Descriptor).This ensures that
t1.equals(t2)
implies thatt1.hashCode()==t2.hashCode()
for any twoOpenMBeanParameterInfoSupport
instancest1
andt2
, as required by the general contract of the methodObject.hashCode()
.However, note that another instance of a class implementing the
OpenMBeanParameterInfo
interface may be equal to thisOpenMBeanParameterInfoSupport
instance as defined byequals(java.lang.Object)
, but may have a different hash code if it is calculated differently.As
OpenMBeanParameterInfoSupport
instances are immutable, the hash code for this instance is calculated once, on the first call tohashCode
, and then the same value is returned for subsequent calls.- Specified by:
hashCode
in interfaceOpenMBeanParameterInfo
- Overrides:
hashCode
in classMBeanParameterInfo
- Returns:
- the hash code value for this
OpenMBeanParameterInfoSupport
instance - See Also:
Object.equals(java.lang.Object)
,System.identityHashCode(java.lang.Object)
-
toString
public String toString()
Returns a string representation of thisOpenMBeanParameterInfoSupport
instance.The string representation consists of the name of this class (i.e.
javax.management.openmbean.OpenMBeanParameterInfoSupport
), 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
OpenMBeanParameterInfoSupport
instances are immutable, the string representation for this instance is calculated once, on the first call totoString
, and then the same value is returned for subsequent calls.- Specified by:
toString
in interfaceOpenMBeanParameterInfo
- Overrides:
toString
in classMBeanParameterInfo
- Returns:
- a string representation of this
OpenMBeanParameterInfoSupport
instance.
-
-
Traduction non disponible
Les API Java ne sont pas encore traduites en français sur l'infobrol. Seule la version anglaise est disponible pour l'instant.
Version en cache
25/11/2024 02:14:53 Cette version de la page est en cache (à la date du 25/11/2024 02:14:53) afin d'accélérer le traitement. Vous pouvez activer le mode utilisateur dans le menu en haut pour afficher la dernère version de la page.Document créé le 07/12/2006, dernière modification le 04/03/2020
Source du document imprimé : https://www.gaudry.be/java-api-rf-javax/management/openmbean/OpenMBeanParameterInfoSupport.html
L'infobrol est un site personnel dont le contenu n'engage que moi. Le texte est mis à disposition sous licence CreativeCommons(BY-NC-SA). Plus d'info sur les conditions d'utilisation et sur l'auteur.
Références
Ces références et liens indiquent des documents consultés lors de la rédaction de cette page, ou qui peuvent apporter un complément d'information, mais les auteurs de ces sources ne peuvent être tenus responsables du contenu de cette page.
L'auteur de ce site est seul responsable de la manière dont sont présentés ici les différents concepts, et des libertés qui sont prises avec les ouvrages de référence. N'oubliez pas que vous devez croiser les informations de sources multiples afin de diminuer les risques d'erreurs.