Class AttributeValueExp

java.lang.Object
javax.management.AttributeValueExp
All Implemented Interfaces:
Serializable, ValueExp
public class AttributeValueExp extends Object implements 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

    Constructors
    Constructor
    Description
    AttributeValueExp()
    Deprecated.
    An instance created with this constructor cannot be used in a query.
    AttributeValueExp(String attr)
    Creates a new AttributeValueExp representing the specified object attribute, named attr.

  • Method Summary

    Modifier and Type
    Method
    Description
    ValueExp
    apply(ObjectName name)
    Applies the AttributeValueExp on an MBean.
    protected Object
    getAttribute(ObjectName name)
    Return the value of the given attribute in the named MBean.
    String
    getAttributeName()
    Returns a string representation of the name of the attribute.
    void
    setMBeanServer(MBeanServer s)
    Deprecated.
    This method has no effect.
    String
    toString()
    Returns the string representing its value.

    Methods declared in class Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
    Modifier and Type
    Method
    Description
    protected Object
    clone()
    Answers a new instance of the same class as the receiver, whose slots have been filled in with the values in the slots of the receiver.
    boolean
    equals(Object o)
    Compares the argument to the receiver, and answers true if they represent the same object using a class specific comparison.
    protected void
    finalize()
    Deprecated, for removal: This API element is subject to removal in a future version.
    May cause performance issues, deadlocks and hangs.
    final Class<? extends Object>
    getClass()
    Answers the unique instance of java.lang.Class which represents the class of the receiver.
    int
    hashCode()
    Answers an integer hash code for the receiver.
    final void
    notify()
    Causes one thread which is waiting on the receiver to be made ready to run.
    final void
    notifyAll()
    Causes all threads which are waiting on the receiver to be made ready to run.
    final void
    wait()
    Causes the thread which sent this message to be made not ready to run pending some change in the receiver (as indicated by notify or notifyAll).
    final void
    wait(long time)
    Causes the thread which sent this message to be made not ready to run either pending some change in the receiver (as indicated by notify or notifyAll) or the expiration of the timeout.
    final void
    wait(long time, int frac)
    Causes the thread which sent this message to be made not ready to run either pending some change in the receiver (as indicated by notify or notifyAll) or the expiration of the timeout.

  • Constructor Details

    • AttributeValueExp

      @Deprecated public AttributeValueExp()
      Deprecated.
      An instance created with this constructor cannot be used in a query.
      An AttributeValueExp with a null attribute.

    • AttributeValueExp

      public AttributeValueExp(String attr)
      Creates a new AttributeValueExp representing the specified object attribute, named attr.
      Parameters:
      attr - the name of the attribute whose value is the value of this ValueExp.

  • Method Details

    • getAttributeName

      public String 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 calls getAttribute(name) and wraps the result as a ValueExp. The value returned by getAttribute must be a Number, String, or Boolean; otherwise this method throws a BadAttributeValueExpException, which will cause the containing query to be false for this name.

      Specified by:
      apply in interface ValueExp
      Parameters:
      name - The name of the MBean on which the AttributeValueExp will be applied.
      Returns:
      The ValueExp.
      Throws:
      BadStringOperationException - when an invalid string operation is passed to a method for constructing a query
      BadBinaryOpValueExpException - when an invalid expression is passed to a method for constructing a query
      BadAttributeValueExpException - when an invalid MBean attribute is passed to a query constructing method
      InvalidApplicationException - when an invalid apply is attempted

    • toString

      public String toString()
      Returns the string representing its value.
      Overrides:
      toString in class Object
      Returns:
      String a printable representation for the receiver.

    • setMBeanServer

      @Deprecated public void setMBeanServer(MBeanServer s)
      Deprecated.
      This method has no effect. The MBean Server used to obtain an attribute value is QueryEval.getMBeanServer().
      Sets the MBean server on which the query is to be performed.
      Specified by:
      setMBeanServer in interface ValueExp
      Parameters:
      s - The MBean server on which the query is to be performed.

    • getAttribute

      protected Object getAttribute(ObjectName name)

      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.