/**
* The XMOJO Project 5
* Copyright 2003 XMOJO.org. All rights reserved.
* NO WARRANTY
* BECAUSE THE LIBRARY IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY FOR
* THE LIBRARY, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN
* OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
* PROVIDE THE LIBRARY "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED
* OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
* MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS
* TO THE QUALITY AND PERFORMANCE OF THE LIBRARY IS WITH YOU. SHOULD THE
* LIBRARY PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING,
* REPAIR OR CORRECTION.
* IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL
* ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE
* THE LIBRARY AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
* GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
* USE OR INABILITY TO USE THE LIBRARY (INCLUDING BUT NOT LIMITED TO LOSS OF
* DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD
* PARTIES OR A FAILURE OF THE LIBRARY TO OPERATE WITH ANY OTHER SOFTWARE),
* EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF
* SUCH DAMAGES.
**/
package javax.management;
import java.io.Serializable;
/**
* QueryExp interface 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.
*/
public interface QueryExp extends Serializable
{
/**
* Applies the QueryExp on an MBean.
*
* @param object The name of the MBean on which the QueryExp will be applied.
*
* @return True if the query was successfully applied to the MBean, false otherwise
*
* @exception BadStringOperationException - This exception is thrown
* when an invalid string operation is passed to a method
* for constructing a query.
*
* @exception BadBinaryOpValueExpException This exception is thrown
* when an invalid expression is passed to a method for
* constructing a query.
*
* @exception BadAttributeValueExpException This is thrown when an invalid
* MBean attribute is passed to a query constructing method.
*
* @exception 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.
*/
public boolean apply(ObjectName object)
throws BadStringOperationException,
BadBinaryOpValueExpException,
BadAttributeValueExpException,
InvalidApplicationException;
/**
* Sets the MBeanServer on which the query is to be accessed.
*
* @param server - The MBeanServer on which the query is to be accessed.
*/
public void setMBeanServer(MBeanServer server);
}//End of class QueryExp
|