01: /**
02: * The XMOJO Project 5
03: * Copyright © 2003 XMOJO.org. All rights reserved.
04:
05: * NO WARRANTY
06:
07: * BECAUSE THE LIBRARY IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY FOR
08: * THE LIBRARY, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN
09: * OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
10: * PROVIDE THE LIBRARY "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED
11: * OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
12: * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS
13: * TO THE QUALITY AND PERFORMANCE OF THE LIBRARY IS WITH YOU. SHOULD THE
14: * LIBRARY PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING,
15: * REPAIR OR CORRECTION.
16:
17: * IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL
18: * ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE
19: * THE LIBRARY AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
20: * GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
21: * USE OR INABILITY TO USE THE LIBRARY (INCLUDING BUT NOT LIMITED TO LOSS OF
22: * DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD
23: * PARTIES OR A FAILURE OF THE LIBRARY TO OPERATE WITH ANY OTHER SOFTWARE),
24: * EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF
25: * SUCH DAMAGES.
26: **/package javax.management;
27:
28: import java.io.Serializable;
29:
30: /**
31: * QueryExp interface represents relational constraints that can be used
32: * in database query "where clauses." Instances of QueryExp are returned by
33: * the static methods of the Query class.
34: */
35: public interface QueryExp extends Serializable {
36: /**
37: * Applies the QueryExp on an MBean.
38: *
39: * @param object The name of the MBean on which the QueryExp will be applied.
40: *
41: * @return True if the query was successfully applied to the MBean, false otherwise
42: *
43: * @exception BadStringOperationException - This exception is thrown
44: * when an invalid string operation is passed to a method
45: * for constructing a query.
46: *
47: * @exception BadBinaryOpValueExpException This exception is thrown
48: * when an invalid expression is passed to a method for
49: * constructing a query.
50: *
51: * @exception BadAttributeValueExpException This is thrown when an invalid
52: * MBean attribute is passed to a query constructing method.
53: *
54: * @exception InvalidApplicationException This exception is thrown when
55: * an attempt is made to apply either of the following:
56: * A subquery expression to an MBean
57: * A qualified attribute expression to an MBean of the wrong class.
58: */
59: public boolean apply(ObjectName object)
60: throws BadStringOperationException,
61: BadBinaryOpValueExpException,
62: BadAttributeValueExpException, InvalidApplicationException;
63:
64: /**
65: * Sets the MBeanServer on which the query is to be accessed.
66: *
67: * @param server - The MBeanServer on which the query is to be accessed.
68: */
69: public void setMBeanServer(MBeanServer server);
70:
71: }//End of class QueryExp
|