OrQueryExp.java revision 11
0N/A/*
0N/A * Copyright 1999-2003 Sun Microsystems, Inc. All Rights Reserved.
0N/A * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
0N/A *
0N/A * This code is free software; you can redistribute it and/or modify it
0N/A * under the terms of the GNU General Public License version 2 only, as
0N/A * published by the Free Software Foundation. Sun designates this
0N/A * particular file as subject to the "Classpath" exception as provided
0N/A * by Sun in the LICENSE file that accompanied this code.
0N/A *
0N/A * This code is distributed in the hope that it will be useful, but WITHOUT
0N/A * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
0N/A * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
0N/A * version 2 for more details (a copy is included in the LICENSE file that
0N/A * accompanied this code).
0N/A *
0N/A * You should have received a copy of the GNU General Public License version
0N/A * 2 along with this work; if not, write to the Free Software Foundation,
0N/A * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
0N/A *
0N/A * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
0N/A * CA 95054 USA or visit www.sun.com if you need additional information or
0N/A * have any questions.
0N/A */
0N/A
0N/Apackage javax.management;
0N/A
0N/A
0N/A
0N/A/**
0N/A * This class is used by the query-building mechanism to represent
0N/A * disjunctions of relational expressions.
0N/A * @serial include
0N/A *
0N/A * @since 1.5
0N/A */
0N/Aclass OrQueryExp extends QueryEval implements QueryExp {
0N/A
0N/A /* Serial version */
0N/A private static final long serialVersionUID = 2962973084421716523L;
0N/A
0N/A /**
0N/A * @serial The left query expression
0N/A */
0N/A private QueryExp exp1;
0N/A
0N/A /**
0N/A * @serial The right query expression
0N/A */
0N/A private QueryExp exp2;
0N/A
0N/A
0N/A /**
0N/A * Basic Constructor.
0N/A */
0N/A public OrQueryExp() {
0N/A }
0N/A
0N/A /**
0N/A * Creates a new OrQueryExp with the specified ValueExps
0N/A */
0N/A public OrQueryExp(QueryExp q1, QueryExp q2) {
0N/A exp1 = q1;
0N/A exp2 = q2;
0N/A }
0N/A
0N/A
0N/A /**
0N/A * Returns the left query expression.
0N/A */
0N/A public QueryExp getLeftExp() {
0N/A return exp1;
0N/A }
0N/A
0N/A /**
0N/A * Returns the right query expression.
0N/A */
0N/A public QueryExp getRightExp() {
0N/A return exp2;
0N/A }
0N/A
0N/A /**
0N/A * Applies the OrQueryExp on a MBean.
0N/A *
0N/A * @param name The name of the MBean on which the OrQueryExp will be applied.
0N/A *
0N/A * @return True if the query was successfully applied to the MBean, false otherwise.
0N/A *
0N/A *
0N/A * @exception BadStringOperationException The string passed to the method is invalid.
0N/A * @exception BadBinaryOpValueExpException The expression passed to the method is invalid.
0N/A * @exception BadAttributeValueExpException The attribute value passed to the method is invalid.
0N/A */
0N/A public boolean apply(ObjectName name) throws BadStringOperationException,
0N/A BadBinaryOpValueExpException, BadAttributeValueExpException,
0N/A InvalidApplicationException {
0N/A return exp1.apply(name) || exp2.apply(name);
0N/A }
0N/A
0N/A /**
11N/A * Returns a string representation of this OrQueryExp
0N/A */
0N/A public String toString() {
0N/A return "(" + exp1 + ") or (" + exp2 + ")";
0N/A }
11N/A
11N/A @Override
11N/A String toQueryString() {
11N/A return parens(exp1) + " or " + parens(exp2);
11N/A }
11N/A
11N/A // Add parentheses to avoid possible confusion. If we have an expression
11N/A // such as Query.or(Query.and(a, b), c), then we return
11N/A // (a and b) or c
11N/A // rather than just
11N/A // a and b or c
11N/A // In fact the precedence rules are such that the parentheses are not
11N/A // strictly necessary, but omitting them would be confusing.
11N/A private static String parens(QueryExp exp) {
11N/A String s = Query.toString(exp);
11N/A if (exp instanceof AndQueryExp)
11N/A return "(" + s + ")";
11N/A else
11N/A return s;
11N/A }
0N/A}