it.unibz.inf.ontop.model.term.ImmutableFunctionalTerm Maven / Gradle / Ivy

Go to download
package it.unibz.inf.ontop.model.term;

import com.google.common.collect.ImmutableList;
import com.google.common.collect.ImmutableSet;
import it.unibz.inf.ontop.iq.node.VariableNullability;
import it.unibz.inf.ontop.model.term.functionsymbol.FunctionSymbol;
import it.unibz.inf.ontop.model.type.TermTypeInference;
import it.unibz.inf.ontop.substitution.Substitution;
import it.unibz.inf.ontop.utils.VariableGenerator;

import java.util.Optional;
import java.util.stream.Stream;

/**
 * Functional term that is declared as immutable.
 *
 */
public interface ImmutableFunctionalTerm extends NonVariableTerm, NonConstantTerm {

    ImmutableList getTerms();

    ImmutableTerm getTerm(int index);

    FunctionSymbol getFunctionSymbol();

    int getArity();

    ImmutableSet getVariables();

    @Override
    default Optional inferType() {
        FunctionSymbol functionSymbol = getFunctionSymbol();
        return functionSymbol.inferType(getTerms());
    }

    /**
     * Returns true if it can be post-processed modulo some decomposition
     * (i.e. some sub-terms may not post-processed, but the top function symbol yes)
     */
    boolean canBePostProcessed();

    /**
     * Returns an empty optional when no decomposition is possible
     *
     * In the decomposition, the liftable term is injective.
     *
     */
    Optional analyzeInjectivity(ImmutableSet nonFreeVariables,
                                                             VariableNullability variableNullability,
                                                             VariableGenerator variableGenerator);

    /**
     * Returns some variables are required to non-null for the functional term to be non-null.
     *
     * The stream is NOT guaranteed to be COMPLETE
     *
     * TODO: find a better name
     */
    Stream proposeProvenanceVariables();

    /**
     * In some occasions, we now that a functional term will never produce a NULL in a given context
     * (e.g. after applying a filter). This method propagates this information to the functional term
     * as to let it simplify itself.
     *
     * Very useful for NULLIF. For instance "NULLIF(NULLIF(a, 0), 1)" would simplify to "a" as "a" is in the
     * current context guaranteed to be non-null and different from 0 and 1.
     *
     */
    FunctionalTermSimplification simplifyAsGuaranteedToBeNonNull();

    interface FunctionalTermDecomposition {

        /**
         * Part of the functional that is liftable (e.g. injective).
         *
         * Is usually an ImmutableFunctionalTerm itself, but in some cases it might be for instance a NULL constant
         */
        ImmutableTerm getLiftableTerm();

        /**
         * Contains the sub-terms that are not liftable.
         * For each of them, a fresh variable has been created.
         */
        Substitution getSubstitution();
    }
}