All Downloads are FREE. Search and download functionalities are using the official Maven repository.

com.blazebit.persistence.impl.JoinVisitor Maven / Gradle / Ivy

/*
 * Copyright 2014 - 2020 Blazebit.
 *
 * Licensed 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 com.blazebit.persistence.impl;

import com.blazebit.persistence.SubqueryInitiator;
import com.blazebit.persistence.impl.builder.predicate.PredicateBuilderEndedListener;
import com.blazebit.persistence.parser.expression.ArrayExpression;
import com.blazebit.persistence.parser.expression.Expression;
import com.blazebit.persistence.parser.expression.FunctionExpression;
import com.blazebit.persistence.parser.expression.ListIndexExpression;
import com.blazebit.persistence.parser.expression.MapKeyExpression;
import com.blazebit.persistence.parser.expression.ParameterExpression;
import com.blazebit.persistence.parser.expression.PathElementExpression;
import com.blazebit.persistence.parser.expression.PathExpression;
import com.blazebit.persistence.parser.expression.PathReference;
import com.blazebit.persistence.parser.expression.PropertyExpression;
import com.blazebit.persistence.parser.expression.SubqueryExpression;
import com.blazebit.persistence.parser.expression.TreatExpression;
import com.blazebit.persistence.parser.expression.VisitorAdapter;
import com.blazebit.persistence.parser.predicate.CompoundPredicate;
import com.blazebit.persistence.parser.predicate.EqPredicate;
import com.blazebit.persistence.parser.predicate.ExistsPredicate;
import com.blazebit.persistence.parser.predicate.InPredicate;
import com.blazebit.persistence.parser.predicate.IsEmptyPredicate;
import com.blazebit.persistence.parser.predicate.IsNullPredicate;
import com.blazebit.persistence.parser.predicate.MemberOfPredicate;
import com.blazebit.persistence.parser.predicate.Predicate;
import com.blazebit.persistence.parser.predicate.PredicateBuilder;
import com.blazebit.persistence.parser.util.ExpressionUtils;
import com.blazebit.persistence.spi.ExtendedManagedType;

import javax.persistence.metamodel.EntityType;
import javax.persistence.metamodel.ManagedType;
import javax.persistence.metamodel.Type;
import java.util.ArrayList;
import java.util.Collection;
import java.util.HashSet;
import java.util.List;
import java.util.Set;

/**
 *
 * @author Christian Beikov
 * @author Moritz Becker
 * @since 1.0.0
 */
public class JoinVisitor extends VisitorAdapter implements SelectInfoVisitor, JoinNodeVisitor, PredicateBuilderEndedListener, SubqueryBuilderListener {

    private final AssociationParameterTransformerFactory parameterTransformerFactory;
    private final EntityMetamodelImpl metamodel;
    private final WindowManager windowManager;
    private final JoinVisitor parentVisitor;
    private final JoinManager joinManager;
    private final ParameterManager parameterManager;
    private final boolean needsSingleValuedAssociationIdRemoval;
    private final List fetchableNodes;
    private final Set currentlyResolvingAliases;
    private final ImplicitJoinCorrelationPathReplacementVisitor correlationPathReplacementVisitor;
    private JoinNode currentJoinNode;
    private boolean reuseExisting;
    private boolean joinRequired;
    private boolean joinWithObjectLeafAllowed = true;
    private boolean joinAllowed;
    private PathElementExpression relativeExpressionPrefix;
    private ClauseType fromClause;
    private ConjunctionPathExpressionFindingVisitor conjunctionPathExpressionFindingVisitor;

    public JoinVisitor(MainQuery mainQuery, WindowManager windowManager, JoinVisitor parentVisitor, JoinManager joinManager, ParameterManager parameterManager, boolean needsSingleValuedAssociationIdRemoval) {
        this.parameterTransformerFactory = mainQuery.parameterTransformerFactory;
        this.metamodel = mainQuery.metamodel;
        this.windowManager = windowManager;
        this.parentVisitor = parentVisitor;
        this.joinManager = joinManager;
        this.parameterManager = parameterManager;
        this.needsSingleValuedAssociationIdRemoval = needsSingleValuedAssociationIdRemoval;
        this.fetchableNodes = new ArrayList<>();
        this.currentlyResolvingAliases = new HashSet<>();
        this.correlationPathReplacementVisitor = new ImplicitJoinCorrelationPathReplacementVisitor();
        // By default we require joins
        this.joinRequired = true;
    }

    public void reset() {
        this.currentJoinNode = null;
        this.reuseExisting = false;
        this.joinRequired = true;
        this.joinWithObjectLeafAllowed = true;
        this.joinAllowed = false;
        this.relativeExpressionPrefix = null;
        this.fromClause = null;
    }

    public PathElementExpression getRelativeExpressionPrefix() {
        return relativeExpressionPrefix;
    }

    public void setRelativeExpressionPrefix(PathElementExpression relativeExpressionPrefix) {
        this.relativeExpressionPrefix = relativeExpressionPrefix;
    }

    public ClauseType getFromClause() {
        return fromClause;
    }

    public void setFromClause(ClauseType fromClause) {
        this.fromClause = fromClause;
        this.joinAllowed = fromClause != ClauseType.JOIN;
    }

    public boolean setReuseExisting(boolean reuseExisting) {
        boolean old = this.reuseExisting;
        this.reuseExisting = reuseExisting;
        return old;
    }

    public List getFetchableNodes() {
        return fetchableNodes;
    }

    @Override
    public void onBuilderEnded(PredicateBuilder o) {
        // No-op
    }

    @Override
    public void onReplaceBuilder(SubqueryInternalBuilder oldBuilder, SubqueryInternalBuilder newBuilder) {
        // No-op
    }

    @Override
    public void onBuilderEnded(SubqueryInternalBuilder builder) {
        // No-op
    }

    @Override
    public void onBuilderStarted(SubqueryInternalBuilder builder) {
        // No-op
    }

    @Override
    public void onInitiatorStarted(SubqueryInitiator initiator) {
        // No-op
    }

    @Override
    public void visit(JoinNode node) {
        if (node.getOnPredicate() != null) {
            currentJoinNode = node;
            try {
                node.getOnPredicate().accept(this);
                if (!correlationPathReplacementVisitor.getPathsToCorrelate().isEmpty()) {
                    // We rewrite the predicate to use correlated subqueries for implicit joins
                    SubqueryInitiatorImpl subqueryInitiator = (SubqueryInitiatorImpl) joinManager.getSubqueryInitFactory().createSubqueryInitiator(null, this, true, fromClause);
                    SubqueryBuilderImpl subqueryBuilder = null;
                    List additionalPredicates = new ArrayList<>(correlationPathReplacementVisitor.getRootsToCorrelate().size());
                    for (ImplicitJoinCorrelationPathReplacementVisitor.RootCorrelationEntry entry : correlationPathReplacementVisitor.getRootsToCorrelate()) {
                        if (subqueryBuilder == null) {
                            subqueryBuilder = (SubqueryBuilderImpl) subqueryInitiator.from(entry.getEntityClass(), entry.getAlias());
                        } else {
                            subqueryBuilder.from(entry.getEntityClass(), entry.getAlias());
                        }
                        additionalPredicates.add(entry.getAdditionalPredicate());
                    }
                    for (ImplicitJoinCorrelationPathReplacementVisitor.CorrelationTransformEntry correlationTransformEntry : correlationPathReplacementVisitor.getPathsToCorrelate()) {
                        String alias = correlationTransformEntry.getAlias();
                        String correlationExpression = correlationTransformEntry.getCorrelationExpression();
                        if (correlationTransformEntry.isInConjunction()) {
                            if (subqueryBuilder == null) {
                                subqueryBuilder = (SubqueryBuilderImpl) subqueryInitiator.from(correlationExpression, alias);
                            } else {
                                subqueryBuilder.from(correlationExpression, alias);
                            }
                        } else {
                            subqueryBuilder.leftJoinDefault(correlationExpression, alias);
                        }
                    }

                    subqueryBuilder.whereManager.restrictSetExpression(correlationPathReplacementVisitor.rewritePredicate(node.getOnPredicate()));
                    for (Predicate additionalPredicate : additionalPredicates) {
                        subqueryBuilder.whereManager.restrictExpression(additionalPredicate);
                    }
                    node.setOnPredicate(new CompoundPredicate(CompoundPredicate.BooleanOperator.AND, new ExistsPredicate(new SubqueryExpression(subqueryBuilder), false)));
                    node.getOnPredicate().accept(this);
                }
            } finally {
                currentJoinNode = null;
            }
        }
        node.registerDependencies();
        if (node.isFetch()) {
            fetchableNodes.add(node);
        }
    }

    @Override
    public void visit(PathExpression expression) {
        visit(expression, false);
    }

    private void visit(PathExpression expression, boolean idRemovable) {
        Expression aliasedExpression;
        String alias = expression.getExpressions().size() == 1 ? expression.toString() : null;
        if (alias != null && !currentlyResolvingAliases.contains(alias) && (aliasedExpression = joinManager.getJoinableSelectAlias(expression, fromClause == ClauseType.SELECT, false)) != null) {
            try {
                currentlyResolvingAliases.add(alias);
                aliasedExpression.accept(this);
                // We initialize the aliased PathExpression properly
                if (aliasedExpression instanceof PathExpression) {
                    PathExpression aliasedPathExpression = (PathExpression) aliasedExpression;
                    if (aliasedPathExpression.isCollectionQualifiedPath()) {
                        expression.setCollectionQualifiedPath(true);
                    }
                    if (aliasedPathExpression.isUsedInCollectionFunction()) {
                        expression.setUsedInCollectionFunction(true);
                    }
                }
            } finally {
                currentlyResolvingAliases.remove(alias);
            }
        } else if (ArrayExpression.ELEMENT_NAME.equals(alias)) {
            // We will not resolve the ArrayExpression.ELEMENT_NAME alias, this must be done in the join manager and is only allowed within an ArrayExpression
        } else {
            if (relativeExpressionPrefix != null) {
                PathExpression leftMost = ExpressionUtils.getLeftMostPathExpression(expression);
                String leftMostAlias;
                if (leftMost.getExpressions().get(0) instanceof ArrayExpression) {
                    leftMostAlias = ((ArrayExpression) leftMost.getExpressions().get(0)).getBase().toString();
                } else {
                    leftMostAlias = ((PropertyExpression) leftMost.getExpressions().get(0)).getProperty();
                }

                if (ArrayExpression.ELEMENT_NAME.equals(leftMostAlias)) {
                    return;
                }
                JoinAliasInfo aliasInfo = (JoinAliasInfo) joinManager.getAliasManager().getAliasInfo(leftMostAlias);
                if (aliasInfo == null) {
                    leftMost.getExpressions().add(0, new PropertyExpression(ArrayExpression.ELEMENT_NAME));
                    return;
                }
            }
            try {
                // But allow joins if this expression was joined before already to avoid possible side-effects of implicit joining multiple times
                if (expression.getBaseNode() != null) {

                }
                joinManager.implicitJoin(expression, joinAllowed, true, joinWithObjectLeafAllowed, null, fromClause, null, currentJoinNode, currentlyResolvingAliases, false, false, joinRequired, idRemovable, false, reuseExisting);
                if (parentVisitor != null) {
                    JoinNode baseNode = (JoinNode) expression.getBaseNode();
                    AliasManager aliasOwner = baseNode.getAliasInfo().getAliasOwner();
                    if (aliasOwner != joinManager.getAliasManager()) {
                        addParentClauseDependencies(baseNode, aliasOwner);
                    }
                }
            } catch (ImplicitJoinNotAllowedException ex) {
                if (conjunctionPathExpressionFindingVisitor == null) {
                    conjunctionPathExpressionFindingVisitor = new ConjunctionPathExpressionFindingVisitor();
                }
                correlationPathReplacementVisitor.addPathExpression(expression, ex, conjunctionPathExpressionFindingVisitor.isInConjunction(currentJoinNode.getOnPredicate(), expression));
            }
        }
    }

    private void addParentClauseDependencies(JoinNode node, AliasManager aliasOwner) {
        if (parentVisitor.getFromClause() == null) {
            try {
                ClauseType parentClause = joinManager.getQueryBuilder().queryContext.getParentClause();
                // Inlined lateral CTEs act in the JOIN clause of the parent query
                if (parentClause == ClauseType.CTE) {
                    parentClause = ClauseType.JOIN;
                }
                parentVisitor.setFromClause(parentClause);
                parentVisitor.addClauseDependencies(node, aliasOwner);
            } finally {
                parentVisitor.setFromClause(null);
            }
        } else {
            parentVisitor.addClauseDependencies(node, aliasOwner);
        }
    }

    private void addClauseDependencies(JoinNode node, AliasManager aliasOwner) {
        if (aliasOwner != joinManager.getAliasManager()) {
            if (parentVisitor == null) {
                throw new IllegalStateException("Couldn't update clause dependencies because implicit joined node does not seem to belong to the query: " + node);
            }
            addParentClauseDependencies(node, aliasOwner);
        } else {
            node.getClauseDependencies().add(fromClause);
        }
    }

    @Override
    public void visit(ListIndexExpression expression) {
        boolean allowed = joinWithObjectLeafAllowed;
        joinWithObjectLeafAllowed = true;
        super.visit(expression);
        joinWithObjectLeafAllowed = allowed;
    }

    @Override
    public void visit(MapKeyExpression expression) {
        boolean allowed = joinWithObjectLeafAllowed;
        joinWithObjectLeafAllowed = true;
        super.visit(expression);
        joinWithObjectLeafAllowed = allowed;
    }

    @Override
    public void visit(TreatExpression expression) {
        throw new IllegalArgumentException("Treat should not be a root of an expression: " + expression.toString());
    }

    public boolean isJoinRequired() {
        return joinRequired;
    }
    
    public void setJoinRequired(boolean joinRequired) {
        this.joinRequired = joinRequired;
    }

    @Override
    public void visit(FunctionExpression expression) {
        if (ExpressionUtils.isOuterFunction(expression)) {
            // let the parent visitor handle the path expression of an outer expression
            expression.getExpressions().get(0).accept(parentVisitor);
        } else {
            super.visit(expression);
            if (expression.getWindowDefinition() != null) {
                expression.setResolvedWindowDefinition(windowManager.resolve(expression.getWindowDefinition()));
            }
        }
    }

    // Added eager initialization of subqueries
    @Override
    public void visit(SubqueryExpression expression) {
        if (expression.getSubquery() instanceof AbstractCommonQueryBuilder) {
            ((AbstractCommonQueryBuilder) expression.getSubquery()).applyImplicitJoins(this);
        }
    }

    public boolean isJoinWithObjectLeafAllowed() {
        return joinWithObjectLeafAllowed;
    }

    public void setJoinWithObjectLeafAllowed(boolean joinWithObjectLeafAllowed) {
        this.joinWithObjectLeafAllowed = joinWithObjectLeafAllowed;
    }

    @Override
    public void visit(EqPredicate predicate) {
        boolean original = joinRequired;
        joinRequired = false;
        removeAssociationIdIfPossible(predicate.getLeft(), predicate.getRight());
        joinRequired = original;
    }

    @Override
    public void visit(InPredicate predicate) {
        boolean original = joinRequired;
        joinRequired = false;

        boolean rewritten = false;
        if (predicate.getRight().size() == 1) {
            Expression right = predicate.getRight().get(0);
            if (right instanceof PathExpression || right instanceof ParameterExpression) {
                removeAssociationIdIfPossible(predicate.getLeft(), right);
                rewritten = true;
            }
        }

        if (!rewritten) {
            predicate.getLeft().accept(this);
            for (Expression right : predicate.getRight()) {
                right.accept(this);
            }
        }

        joinRequired = original;
    }

    private void removeAssociationIdIfPossible(Expression left, Expression right) {
        if (needsSingleValuedAssociationIdRemoval && fromClause == ClauseType.JOIN) {
            if (removeAssociationIdIfPossible(left)) {
                // The left expression was successfully rewritten
                if (!removeAssociationIdIfPossible(right)) {
                    // But the right expression failed
                    Type associationType = getAssociationType(left, right);
                    ParameterValueTransformer tranformer = parameterTransformerFactory.getToEntityTranformer(associationType.getJavaType());
                    if (!rewriteToAssociationParam(tranformer, right)) {
                        // If the other part wasn't a parameter, we have to do a "normal" implicit join
                        left.accept(this);
                        right.accept(this);
                    }
                }
            } else {
                if (removeAssociationIdIfPossible(right)) {
                    // The right expression was successfully rewritten, but not the left
                    Type associationType = getAssociationType(left, right);
                    ParameterValueTransformer tranformer = parameterTransformerFactory.getToEntityTranformer(associationType.getJavaType());
                    if (!rewriteToAssociationParam(tranformer, left)) {
                        // If the other part wasn't a parameter, we have to do a "normal" implicit join
                        left.accept(this);
                        right.accept(this);
                    }
                } else {
                    left.accept(this);
                    right.accept(this);
                }
            }
        } else {
            String naturalIdAttribute;
            if (fromClause == ClauseType.JOIN && left instanceof PathExpression && right instanceof PathExpression
                    && (naturalIdAttribute = getNaturalIdAttribute(left, right)) != null) {
                // We can only fix this if both expressions are path expressions
                ((PathExpression) left).getExpressions().add(new PropertyExpression(naturalIdAttribute));
                ((PathExpression) right).getExpressions().add(new PropertyExpression(naturalIdAttribute));
                // Re-visit to update path reference
                left.accept(this);
                right.accept(this);
            } else {
                left.accept(this);
                right.accept(this);
            }
        }
    }

    private boolean removeAssociationIdIfPossible(Expression expression) {
        if (expression instanceof PathExpression) {
            PathExpression pathExpression = (PathExpression) expression;
            visit(pathExpression, true);
            String lastElement = pathExpression.getExpressions().get(pathExpression.getExpressions().size() - 1).toString();
            PathReference pathReference = pathExpression.getPathReference();
            if (pathReference == null) {
                return false;
            }
            JoinNode node = (JoinNode) pathReference.getBaseNode();
            String field = pathReference.getField();
            if (field == null) {
                // If there is no field, we can only check if the last element is the join nodes relation name
                // If it is, then this is a plain association use like "alias.association" and we didn't remove anything
                if (node.getParentTreeNode() == null) {
                    // A root node
                    if (!lastElement.equals(node.getAlias())) {
                        return true;
                    }
                } else {
                    // A normal join node that could be used either via association name or alias
                    if (!lastElement.equals(node.getParentTreeNode().getRelationName()) && !lastElement.equals(node.getAlias())) {
                        return true;
                    }
                }
            } else {
                if (field.endsWith(lastElement) && (field.length() == lastElement.length() || field.charAt(field.length() - lastElement.length() - 1) == '.')) {
                    // If there is a field, we only have to check if the last element is in the field
                    return false;
                } else {
                    // If it isn't we have removed the id part
                    return true;
                }
            }
        }

        return false;
    }

    private Type getAssociationType(Expression expression1, Expression expression2) {
        if (expression1 instanceof PathExpression) {
            return ((PathExpression) expression1).getPathReference().getType();
        }

        return ((PathExpression) expression2).getPathReference().getType();
    }

    private String getNaturalIdAttribute(Expression expression1, Expression expression2) {
        String naturalIdAttribute = getNaturalIdAttribute(expression1);
        if (naturalIdAttribute != null) {
            return naturalIdAttribute;
        }
        return getNaturalIdAttribute(expression2);
    }

    private String getNaturalIdAttribute(Expression expression) {
        // When comparing an alias with a natural key joined relation, we have to append the natural id to the paths
        // Hibernate fails to do this and instead compares the primary key with the natural key which might go by unnoticed
        if (expression instanceof PathExpression) {
            PathExpression pathExpression = (PathExpression) expression;
            visit(pathExpression, false);
            PathReference pathReference = (pathExpression).getPathReference();
            // We only attach the natural id to paths referring to entity types
            if (pathReference != null && pathReference.getField() != null && pathReference.getType() instanceof EntityType) {
                JoinNode node = (JoinNode) pathReference.getBaseNode();
                // We need a parent tree node to determine the natural id attribute
                Collection identifierOrUniqueKeyEmbeddedPropertyNames = metamodel.getJpaProvider()
                        .getJoinMappingPropertyNames(node.getEntityType(), null, pathReference.getField()).keySet();
                if (identifierOrUniqueKeyEmbeddedPropertyNames.size() == 1) {
                    // This "fix" only works if we have a single id attribute
                    String naturalIdAttribute = identifierOrUniqueKeyEmbeddedPropertyNames.iterator().next();
                    ExtendedManagedType extendedManagedType = metamodel.getManagedType(ExtendedManagedType.class, (ManagedType) pathReference.getType());
                    if (!extendedManagedType.getIdAttribute().getName().equals(naturalIdAttribute)) {
                        // Now we finally know the natural id attribute name
                        return naturalIdAttribute;
                    }
                }
            }
        }

        return null;
    }

    private boolean rewriteToAssociationParam(ParameterValueTransformer tranformer, Expression expression) {
        if (!(expression instanceof ParameterExpression)) {
            return false;
        }
        ParameterExpression parameterExpression = (ParameterExpression) expression;
        ParameterManager.ParameterImpl param = (ParameterManager.ParameterImpl) parameterManager.getParameter(parameterExpression.getName());
        param.setTranformer(tranformer);
        return true;
    }

    @Override
    public void visit(IsNullPredicate predicate) {
        boolean original = joinRequired;
        joinRequired = false;
        if (!removeAssociationIdIfPossible(predicate.getExpression())) {
            predicate.getExpression().accept(this);
        }
        joinRequired = original;
    }

    @Override
    public void visit(IsEmptyPredicate predicate) {
        boolean original = joinRequired;
        joinRequired = false;
        predicate.getExpression().accept(this);
        joinRequired = original;
    }

    @Override
    public void visit(MemberOfPredicate predicate) {
        boolean original = joinRequired;
        joinRequired = false;
        predicate.getLeft().accept(this);
        predicate.getRight().accept(this);
        joinRequired = original;
    }

    @Override
    public void visit(SelectInfo selectInfo) {
        String alias = selectInfo.getAlias();
        try {
            if (alias != null) {
                currentlyResolvingAliases.add(alias);
            }
            selectInfo.getExpression().accept(this);
        } finally {
            currentlyResolvingAliases.remove(alias);
        }
    }
}