jena-arq/src/main/java/org/apache/jena/sparql/expr/ExprNode.java

/*
 * Licensed to the Apache Software Foundation (ASF) under one
 * or more contributor license agreements.  See the NOTICE file
 * distributed with this work for additional information
 * regarding copyright ownership.  The ASF licenses this file
 * to you under the Apache License, Version 2.0 (the
 * "License"); you may not use this file except in compliance
 * with the License.  You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package org.apache.jena.sparql.expr;

import java.util.Collection ;
import java.util.Set ;

import org.apache.jena.sparql.algebra.Op ;
import org.apache.jena.sparql.core.Var ;
import org.apache.jena.sparql.engine.binding.Binding ;
import org.apache.jena.sparql.expr.nodevalue.XSDFuncOp ;
import org.apache.jena.sparql.function.FunctionEnv ;
import org.apache.jena.sparql.graph.NodeTransform;
import org.apache.jena.sparql.sse.writers.WriterExpr ;

/** A node that is a constraint expression that can be evaluated
 * An Expr is already a Constraint - ExprNode is the base implementation
 * of all Expr classes that provides the Constraint machinery. */
 
public abstract class ExprNode implements Expr
{
    @Override
    public boolean isSatisfied(Binding binding, FunctionEnv funcEnv) {
        try {
            NodeValue v = eval(binding, funcEnv) ;
            boolean b = XSDFuncOp.booleanEffectiveValue(v) ;
            return b ;
        }
        catch (ExprEvalException ex) { 
            return false ;
        }
    }

    public boolean isExpr()     { return true ; }
    public final Expr getExpr() { return this ; }
    
    // --- interface Constraint
    
    @Override
    public abstract NodeValue eval(Binding binding, FunctionEnv env) ; 
    
    @Override
    public final Set<Var> getVarsMentioned()                    { return ExprVars.getVarsMentioned(this) ; }
    @Override
    public final void varsMentioned(Collection<Var> acc)        { ExprVars.varsMentioned(acc, this) ; }

    /** @deprecated Use {@link ExprVars#getVarNamesMentioned} */
    @Deprecated
    public Set<String> getVarNamesMentioned()                   { return ExprVars.getVarNamesMentioned(this) ; }

    /** @deprecated Use {@link ExprVars#varNamesMentioned} */
    @Deprecated
    public void varNamesMentioned(Collection<String> acc)       { ExprVars.varNamesMentioned(acc, this) ; }

    @Override
    public abstract int hashCode() ;
    @Override
    public final boolean equals(Object other) {
        if ( other == null ) return false ;
        if ( this == other ) return true ;
        if ( ! ( other instanceof Expr ) ) return false ;
        return equals((Expr)other, false) ;
    }
    
    @Override
    public final boolean equalsBySyntax(Expr other) {
        if ( other == null ) return false ;
        if ( this == other ) return true ;
        return equals(other, true) ;
    }
    
    @Override
    public abstract boolean equals(Expr other, boolean bySyntax) ;
    
    protected static NodeValue eval(Binding binding, FunctionEnv funcEnv, Expr expr) {   
        if ( expr == null ) return null ;
        return expr.eval(binding, funcEnv) ;
    }
    
    @Override
    final public Expr deepCopy()        { return copySubstitute(null) ; }
    
    @Override
    public abstract Expr copySubstitute(Binding binding) ;
    
    @Override
    public abstract Expr applyNodeTransform(NodeTransform transform) ;
        
    // ---- Default implementations
    @Override
    public boolean isVariable()         { return false ; }
    @Override
    public String getVarName()          { return null ; } //throw new ExprException("Expr.getVarName called on non-variable") ; }
    @Override
    public ExprVar getExprVar()         { return null ; } //throw new ExprException("Expr.getVar called on non-variable") ; }
    @Override
    public Var asVar()                  { return null ; } //throw new ExprException("Expr.getVar called on non-variable") ; }
    
    @Override
    public boolean isConstant()         { return false ; }
    @Override
    public NodeValue getConstant()      { return null ; } // throw new ExprException("Expr.getConstant called on non-constant") ; }
    
    @Override
    public boolean isFunction()         { return false ; }
    @Override
    public ExprFunction getFunction()   { return null ; }

    public boolean isGraphPattern()     { return false ; }
    public Op getGraphPattern()         { return null ; }
    @Override
    public String toString()            { return WriterExpr.asString(this) ; } 
}