1 /*
2 * Copyright 1999-2004 Sun Microsystems, Inc. All Rights Reserved.
3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
4 *
5 * This code is free software; you can redistribute it and/or modify it
6 * under the terms of the GNU General Public License version 2 only, as
7 * published by the Free Software Foundation. Sun designates this
8 * particular file as subject to the "Classpath" exception as provided
9 * by Sun in the LICENSE file that accompanied this code.
10 *
11 * This code is distributed in the hope that it will be useful, but WITHOUT
12 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
13 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
14 * version 2 for more details (a copy is included in the LICENSE file that
15 * accompanied this code).
16 *
17 * You should have received a copy of the GNU General Public License version
18 * 2 along with this work; if not, write to the Free Software Foundation,
19 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
20 *
21 * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
22 * CA 95054 USA or visit www.sun.com if you need additional information or
23 * have any questions.
24 */
25
26 package javax.management;
27
28
29 /**
30 * This class is used by the query building mechanism to represent conjunctions
31 * of relational expressions.
32 * @serial include
33 *
34 * @since 1.5
35 */
36 class AndQueryExp extends QueryEval implements QueryExp {
37
38 /* Serial version */
39 private static final long serialVersionUID = -1081892073854801359L;
40
41 /**
42 * @serial The first QueryExp of the conjunction
43 */
44 private QueryExp exp1;
45
46 /**
47 * @serial The second QueryExp of the conjunction
48 */
49 private QueryExp exp2;
50
51
52 /**
53 * Default constructor.
54 */
55 public AndQueryExp() {
56 }
57
58 /**
59 * Creates a new AndQueryExp with q1 and q2 QueryExp.
60 */
61 public AndQueryExp(QueryExp q1, QueryExp q2) {
62 exp1 = q1;
63 exp2 = q2;
64 }
65
66
67 /**
68 * Returns the left query expression.
69 */
70 public QueryExp getLeftExp() {
71 return exp1;
72 }
73
74 /**
75 * Returns the right query expression.
76 */
77 public QueryExp getRightExp() {
78 return exp2;
79 }
80
81 /**
82 * Applies the AndQueryExp on a MBean.
83 *
84 * @param name The name of the MBean on which the AndQueryExp will be applied.
85 *
86 * @return True if the query was successfully applied to the MBean, false otherwise.
87 *
88 *
89 * @exception BadStringOperationException The string passed to the method is invalid.
90 * @exception BadBinaryOpValueExpException The expression passed to the method is invalid.
91 * @exception BadAttributeValueExpException The attribute value passed to the method is invalid.
92 * @exception InvalidApplicationException An attempt has been made to apply a subquery expression to a
93 * managed object or a qualified attribute expression to a managed object of the wrong class.
94 */
95 public boolean apply(ObjectName name) throws BadStringOperationException, BadBinaryOpValueExpException,
96 BadAttributeValueExpException, InvalidApplicationException {
97 return exp1.apply(name) && exp2.apply(name);
98 }
99
100 /**
101 * Returns a string representation of this AndQueryExp
102 */
103 @Override
104 public String toString() {
105 return "(" + exp1 + ") and (" + exp2 + ")";
106 }
107
108 @Override
109 String toQueryString() {
110 // Parentheses are only added if needed to disambiguate.
111 return parens(exp1) + " and " + parens(exp2);
112 }
113
114 // Add parens if needed to disambiguate an expression such as
115 // Query.and(Query.or(a, b), c). We need to return
116 // (a or b) and c
117 // in such a case, because
118 // a or b and c
119 // would mean
120 // a or (b and c)
121 private static String parens(QueryExp exp) {
122 String s = Query.toString(exp);
123 if (exp instanceof OrQueryExp)
124 return "(" + s + ")";
125 else
126 return s;
127 }
128
129 }
Save This Page