001: /*--
002:
003: $Id: OrFilter.java,v 1.4 2004/02/06 09:28:31 jhunter Exp $
004:
005: Copyright (C) 2000-2004 Jason Hunter & Brett McLaughlin.
006: All rights reserved.
007:
008: Redistribution and use in source and binary forms, with or without
009: modification, are permitted provided that the following conditions
010: are met:
011:
012: 1. Redistributions of source code must retain the above copyright
013: notice, this list of conditions, and the following disclaimer.
014:
015: 2. Redistributions in binary form must reproduce the above copyright
016: notice, this list of conditions, and the disclaimer that follows
017: these conditions in the documentation and/or other materials
018: provided with the distribution.
019:
020: 3. The name "JDOM" must not be used to endorse or promote products
021: derived from this software without prior written permission. For
022: written permission, please contact <request_AT_jdom_DOT_org>.
023:
024: 4. Products derived from this software may not be called "JDOM", nor
025: may "JDOM" appear in their name, without prior written permission
026: from the JDOM Project Management <request_AT_jdom_DOT_org>.
027:
028: In addition, we request (but do not require) that you include in the
029: end-user documentation provided with the redistribution and/or in the
030: software itself an acknowledgement equivalent to the following:
031: "This product includes software developed by the
032: JDOM Project (http://www.jdom.org/)."
033: Alternatively, the acknowledgment may be graphical using the logos
034: available at http://www.jdom.org/images/logos.
035:
036: THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
037: WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
038: OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
039: DISCLAIMED. IN NO EVENT SHALL THE JDOM AUTHORS OR THE PROJECT
040: CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
041: SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
042: LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
043: USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
044: ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
045: OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
046: OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
047: SUCH DAMAGE.
048:
049: This software consists of voluntary contributions made by many
050: individuals on behalf of the JDOM Project and was originally
051: created by Jason Hunter <jhunter_AT_jdom_DOT_org> and
052: Brett McLaughlin <brett_AT_jdom_DOT_org>. For more information
053: on the JDOM Project, please see <http://www.jdom.org/>.
054:
055: */
056:
057: package org.jdom.filter;
058:
059: /**
060: * Allow two filters to be chained together with a logical
061: * <b>or</b> operation.
062: *
063: * @author Bradley S. Huffman
064: * @version $Revision: 1.4 $, $Date: 2004/02/06 09:28:31 $
065: */
066: final class OrFilter extends AbstractFilter {
067:
068: private static final String CVS_ID = "@(#) $RCSfile: OrFilter.java,v $ $Revision: 1.4 $ $Date: 2004/02/06 09:28:31 $";
069:
070: /** Filter for left side of logical <b>or</b> */
071: private Filter left;
072:
073: /** Filter for right side of logical <b>or</b> */
074: private Filter right;
075:
076: /**
077: * Match if either of the supplied filters.
078: *
079: * @param left left side of logical <b>or</b>
080: * @param right right side of logical <b>or</b>
081: * @throws IllegalArgumentException if either supplied filter is null
082: */
083: public OrFilter(Filter left, Filter right) {
084: if ((left == null) || (right == null)) {
085: throw new IllegalArgumentException(
086: "null filter not allowed");
087: }
088: this .left = left;
089: this .right = right;
090: }
091:
092: public boolean matches(Object obj) {
093: return left.matches(obj) || right.matches(obj);
094: }
095:
096: public boolean equals(Object obj) {
097: if (this == obj) {
098: return true;
099: }
100:
101: if (obj instanceof OrFilter) {
102: OrFilter filter = (OrFilter) obj;
103: if ((left.equals(filter.left) && right.equals(filter.right))
104: || (left.equals(filter.right) && right
105: .equals(filter.left))) {
106: return true;
107: }
108: }
109: return false;
110: }
111:
112: public int hashCode() {
113: return (31 * left.hashCode()) + right.hashCode();
114: }
115:
116: public String toString() {
117: return new StringBuffer(64).append("[OrFilter: ").append(
118: left.toString()).append(",\n").append(" ")
119: .append(right.toString()).append("]").toString();
120: }
121: }
|