CrossApplyExpression.cs

// Licensed to the .NET Foundation under one or more agreements.
// The .NET Foundation licenses this file to you under the MIT license.

namespace Microsoft.EntityFrameworkCore.Query.SqlExpressions;

/// <summary>
///     <para>
///         An expression that represents a CROSS APPLY in a SQL tree.
///     </para>
///     <para>
///         This type is typically used by database providers (and other extensions). It is generally
///         not used in application code.
///     </para>
/// </summary>
public class CrossApplyExpression : JoinExpressionBase
{
    /// <summary>
    ///     Creates a new instance of the <see cref="CrossApplyExpression" /> class.
    /// </summary>
    /// <param name="table">A table source to CROSS APPLY with.</param>
    public CrossApplyExpression(TableExpressionBase table)
        : this(table, annotations: null)
    {
    }

    private CrossApplyExpression(TableExpressionBase table, IEnumerable<IAnnotation>? annotations)
        : base(table, annotations)
    {
    }

    /// <inheritdoc />
    protected override Expression VisitChildren(ExpressionVisitor visitor)
        => Update((TableExpressionBase)visitor.Visit(Table));

    /// <summary>
    ///     Creates a new expression that is like this one, but using the supplied children. If all of the children are the same, it will
    ///     return this expression.
    /// </summary>
    /// <param name="table">The <see cref="JoinExpressionBase.Table" /> property of the result.</param>
    /// <returns>This expression if no children changed, or an expression with the updated children.</returns>
    public override CrossApplyExpression Update(TableExpressionBase table)
        => table != Table
            ? new CrossApplyExpression(table, GetAnnotations())
            : this;

    /// <inheritdoc />
    protected override TableExpressionBase CreateWithAnnotations(IEnumerable<IAnnotation> annotations)
        => new CrossApplyExpression(Table, GetAnnotations());

    /// <inheritdoc />
    protected override void Print(ExpressionPrinter expressionPrinter)
    {
        expressionPrinter.Append("CROSS APPLY ");
        expressionPrinter.Visit(Table);
        PrintAnnotations(expressionPrinter);
    }

    /// <inheritdoc />
    public override bool Equals(object? obj)
        => obj != null
            && (ReferenceEquals(this, obj)
                || obj is CrossApplyExpression crossApplyExpression
                && Equals(crossApplyExpression));

    private bool Equals(CrossApplyExpression crossApplyExpression)
        => base.Equals(crossApplyExpression);

    /// <inheritdoc />
    public override int GetHashCode()
        => base.GetHashCode();
}