javax.management
Class AttributeValueExp

java.lang.Object
  extended by javax.management.AttributeValueExp
All Implemented Interfaces:
Serializable, ValueExp

public class AttributeValueExp
extends Object
implements ValueExp

Represents an attribute value being used as an argument to a relational constraint.

Since:
1.5
See Also:
Serialized Form

Constructor Summary
AttributeValueExp()
          Deprecated. An instance created with a null attribute name can not be used in a query.
AttributeValueExp(String attr)
          Constructs a new AttributeValueExp using the specified attribute.
 
Method Summary
 ValueExp apply(ObjectName name)
          Applies the AttributeValueExp to the specified management bean by obtaining the attribute value from the MBeanServer and using it to create a StringValueExp.
protected  Object getAttribute(ObjectName name)
          Returns the value of the attribute by calling the MBeanServer#getAttribute(ObjectName) method of the server returned by QueryEval.getMBeanServer().
 String getAttributeName()
          Returns the attribute name.
 void setMBeanServer(MBeanServer server)
          Sets the MBeanServer on which the query will be performed.
 String toString()
          Returns the attribute name, quoted.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Constructor Detail

AttributeValueExp

@Deprecated
public AttributeValueExp()
Deprecated. An instance created with a null attribute name can not be used in a query.

Constructs a new AttributeValueExp.


AttributeValueExp

public AttributeValueExp(String attr)
Constructs a new AttributeValueExp using the specified attribute.

Parameters:
attr - the name of the attribute whose value will be used for this expression.
Method Detail

apply

public ValueExp apply(ObjectName name)
               throws BadStringOperationException,
                      BadBinaryOpValueExpException,
                      BadAttributeValueExpException,
                      InvalidApplicationException
Applies the AttributeValueExp to the specified management bean by obtaining the attribute value from the MBeanServer and using it to create a StringValueExp.

Specified by:
apply in interface ValueExp
Parameters:
name - the ObjectName of the bean to obtain the value from.
Returns:
a StringValueExp containing the result.
Throws:
BadStringOperationException - if an invalid string operation is used by the value expression.
BadBinaryOpValueExpException - if an invalid expression is used by the value expression.
BadAttributeValueExpException - if an invalid attribute is used by the value expression.
InvalidApplicationException - if the value expression is applied to the wrong type of bean.

getAttribute

protected Object getAttribute(ObjectName name)
Returns the value of the attribute by calling the MBeanServer#getAttribute(ObjectName) method of the server returned by QueryEval.getMBeanServer(). If an exception occurs, null is returned.

Parameters:
name - the ObjectName of the bean to obtain the value from.
Returns:
a StringValueExp containing the result.

getAttributeName

public String getAttributeName()
Returns the attribute name.

Returns:
the attribute name.

setMBeanServer

public void setMBeanServer(MBeanServer server)
Sets the MBeanServer on which the query will be performed.

Specified by:
setMBeanServer in interface ValueExp
Parameters:
server - the new server.

toString

public String toString()
Returns the attribute name, quoted.

Overrides:
toString in class Object
Returns:
the quoted attribute name.
See Also:
Object.getClass(), Object.hashCode(), Class.getName(), Integer.toHexString(int)