001/*
002 * Licensed to the Apache Software Foundation (ASF) under one or more
003 * contributor license agreements.  See the NOTICE file distributed with
004 * this work for additional information regarding copyright ownership.
005 * The ASF licenses this file to You under the Apache License, Version 2.0
006 * (the "License"); you may not use this file except in compliance with
007 * the License.  You may obtain a copy of the License at
008 *
009 *     http://www.apache.org/licenses/LICENSE-2.0
010 *
011 * Unless required by applicable law or agreed to in writing, software
012 * distributed under the License is distributed on an "AS IS" BASIS,
013 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
014 * See the License for the specific language governing permissions and
015 * limitations under the License.
016 */
017package org.apache.commons.el;
018
019import javax.servlet.jsp.el.ELException;
020
021/**
022 *
023 * <p>The implementation of the or operator
024 * 
025 * @author Nathan Abramson - Art Technology Group
026 * @version $Change: 181177 $$DateTime: 2001/06/26 08:45:09 $$Author: bayard $
027 **/
028
029public class OrOperator
030  extends BinaryOperator
031{
032  //-------------------------------------
033  // Singleton
034  //-------------------------------------
035
036  public static final OrOperator SINGLETON =
037    new OrOperator ();
038
039  //-------------------------------------
040  /**
041   *
042   * Constructor
043   **/
044  public OrOperator ()
045  {
046  }
047
048  //-------------------------------------
049  // Expression methods
050  //-------------------------------------
051  /**
052   *
053   * Returns the symbol representing the operator
054   **/
055  public String getOperatorSymbol ()
056  {
057    return "or";
058  }
059
060  //-------------------------------------
061  /**
062   *
063   * Applies the operator to the given value
064   **/
065  public Object apply (Object pLeft, Object pRight)
066    throws ELException
067  {
068    // Coerce the values to booleans
069    boolean left = 
070      Coercions.coerceToBoolean (pLeft).booleanValue ();
071    boolean right = 
072      Coercions.coerceToBoolean (pRight).booleanValue ();
073
074    return PrimitiveObjects.getBoolean (left || right);
075  }
076
077  //-------------------------------------
078  /**
079   *
080   * Returns true if evaluation is necessary given the specified Left
081   * value.  The And/OrOperators make use of this
082   **/
083  public boolean shouldEvaluate (Object pLeft)
084  {
085    return
086      (pLeft instanceof Boolean) &&
087      ((Boolean) pLeft).booleanValue () == false;
088  }
089
090  //-------------------------------------
091  /**
092   *
093   * Returns true if the operator expects its arguments to be coerced
094   * to Booleans.  The And/Or operators set this to true.
095   **/
096  public boolean shouldCoerceToBoolean ()
097  {
098    return true;
099  }
100
101  //-------------------------------------
102}