javax.management
Interface QueryExp

All Known Implementing Classes:

QueryExpSupport, ObjectName

public interface QueryExp

extends java.io.Serializable

Represents relational constraints that can be used in database query "where clauses". Instances of QueryExp are returned by the static methods of the Query class.

It is possible, but not recommended, to create custom queries by implementing this interface. In that case, it is better to extend the QueryEval class than to implement the interface directly, so that the setMBeanServer(javax.management.MBeanServer) method works correctly.

Method Summary

boolean	apply(ObjectName name) Applies the QueryExp on an MBean.
void	setMBeanServer(MBeanServer server) Sets the MBean server on which the query is to be performed.

Method Detail

apply

public boolean apply(ObjectName name)
              throws BadStringOperationException,
                     BadBinaryOpValueExpException,
                     BadAttributeValueExpException,
                     InvalidApplicationException

Applies the QueryExp on an MBean.

Parameters:

name - The name of the MBean on which the QueryExp will be applied.

Returns:

True if the query was successfully applied to the MBean, false otherwise

Throws:

BadStringOperationException - - This exception is thrown when an invalid string operation is passed to a method for constructing a query.

BadBinaryOpValueExpException - - This exception is thrown when an invalid expression is passed to a method for constructing a query

BadAttributeValueExpException - - The exception is thrown when an invalid MBean attribute is passed to a query constructing method.

InvalidApplicationException - - This exception is thrown when an attempt is made to apply either of the following:

• A subquery expression to an MBean
• A qualified attribute expression to an MBean of the wrong class

setMBeanServer

public void setMBeanServer(MBeanServer server)

Sets the MBean server on which the query is to be performed.

Parameters:

server - The MBean server on which the query is to be performed.