java.lang.Object
javax.management.AttributeValueExp
- All Implemented Interfaces:
Serializable
,ValueExp
Represents attributes used as arguments to relational constraints.
Instances of this class are usually obtained using Query.attr
.
An AttributeValueExp
may be used anywhere a
ValueExp
is required.
- Since:
- 1.5
- See Also:
-
Constructor Summary
ConstructorDescriptionDeprecated.An instance created with this constructor cannot be used in a query.AttributeValueExp
(String attr) Creates a newAttributeValueExp
representing the specified object attribute, named attr. -
Method Summary
Modifier and TypeMethodDescriptionapply
(ObjectName name) Applies theAttributeValueExp
on an MBean.protected Object
getAttribute
(ObjectName name) Return the value of the given attribute in the named MBean.Returns a string representation of the name of the attribute.void
Deprecated.This method has no effect.toString()
Returns the string representing its value.
-
Constructor Details
-
AttributeValueExp
Deprecated.An instance created with this constructor cannot be used in a query.AnAttributeValueExp
with a null attribute. -
AttributeValueExp
Creates a newAttributeValueExp
representing the specified object attribute, named attr.- Parameters:
attr
- the name of the attribute whose value is the value of thisValueExp
.
-
-
Method Details
-
getAttributeName
Returns a string representation of the name of the attribute.- Returns:
- the attribute name.
-
apply
public ValueExp apply(ObjectName name) throws BadStringOperationException, BadBinaryOpValueExpException, BadAttributeValueExpException, InvalidApplicationException Applies the
AttributeValueExp
on an MBean. This method callsgetAttribute(name)
and wraps the result as aValueExp
. The value returned bygetAttribute
must be aNumber
,String
, orBoolean
; otherwise this method throws aBadAttributeValueExpException
, which will cause the containing query to be false for thisname
.- Specified by:
apply
in interfaceValueExp
- Parameters:
name
- The name of the MBean on which theAttributeValueExp
will be applied.- Returns:
- The
ValueExp
. - Throws:
BadStringOperationException
- when an invalid string operation is passed to a method for constructing a queryBadBinaryOpValueExpException
- when an invalid expression is passed to a method for constructing a queryBadAttributeValueExpException
- when an invalid MBean attribute is passed to a query constructing methodInvalidApplicationException
- when an invalid apply is attempted
-
toString
Returns the string representing its value. -
setMBeanServer
Deprecated.This method has no effect. The MBean Server used to obtain an attribute value isQueryEval.getMBeanServer()
.Sets the MBean server on which the query is to be performed.- Specified by:
setMBeanServer
in interfaceValueExp
- Parameters:
s
- The MBean server on which the query is to be performed.
-
getAttribute
Return the value of the given attribute in the named MBean. If the attempt to access the attribute generates an exception, return null.
The MBean Server used is the one returned by
QueryEval.getMBeanServer()
.- Parameters:
name
- the name of the MBean whose attribute is to be returned.- Returns:
- the value of the attribute, or null if it could not be obtained.
-