1. /*

  2.  * @(#)QueryExp.java	4.17 03/12/19

  3.  * 

  4.  * Copyright 2004 Sun Microsystems, Inc. All rights reserved.

  5.  * SUN PROPRIETARY/CONFIDENTIAL. Use is subject to license terms.

  6.  */

  7. 

  8. package javax.management;

  9. 

  10. // java import

  11. import java.io.Serializable;

  12. 

  13. 

  14. /**

  15.  * <p>Represents relational constraints that can be used in database

  16.  * query "where clauses".  Instances of QueryExp are returned by the

  17.  * static methods of the {@link Query} class.</p>

  18.  *

  19.  * <p>It is possible, but not

  20.  * recommended, to create custom queries by implementing this

  21.  * interface.  In that case, it is better to extend the {@link

  22.  * QueryEval} class than to implement the interface directly, so that

  23.  * the {@link #setMBeanServer} method works correctly.

  24.  *

  25.  * @since 1.5

  26.  */

  27. public interface QueryExp extends Serializable {

  28.      

  29.     

  30.      /**

  31.       * Applies the QueryExp on an MBean.

  32.       *

  33.       * @param name The name of the MBean on which the QueryExp will be applied.

  34.       *

  35.       * @return  True if the query was successfully applied to the MBean, false otherwise

  36.       *

  37.       * @exception BadStringOperationException

  38.       * @exception BadBinaryOpValueExpException

  39.       * @exception BadAttributeValueExpException 

  40.       * @exception InvalidApplicationException

  41.       */

  42.      public boolean apply(ObjectName name) throws BadStringOperationException, BadBinaryOpValueExpException,

  43. 	 BadAttributeValueExpException, InvalidApplicationException ;

  44. 

  45.      /**

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

  47.       *

  48.       * @param s The MBean server on which the query is to be performed.

  49.       */

  50.      public void setMBeanServer(MBeanServer s) ;

  51. 

  52.  }