gudusoft.gsqlparser.ir.semantic.joinanalysis

Class JoinEntity

Object

gudusoft.gsqlparser.ir.semantic.joinanalysis.JoinEntity

public final class JoinEntity
extends Object

A structured per-join entity (GAP 1): the type, the two input endpoints, the written order, optional USING / NATURAL metadata, how it was written, an optional span, the decomposed ON predicate list (GAP 2, attached in slice 168), and an optional verbatim conditionText (the SQL substring derived from span, never reformatted).

Endpoints are JoinEndpoints, never bare aliases, so a left-deep chain is modelled correctly: rightEndpoint is the newly added relation; leftEndpoint is the accumulated JoinEndpointKind.JOIN_RESULT of prior joins (or the first JoinEndpointKind.RELATION).

Immutable. Introduced by join-analysis slice 162 (S1); built in slice 167 (S6); predicates attached in slice 168 (S7).

Constructor Summary

Constructors

Constructor and Description
JoinEntity(SemanticJoinType joinType, JoinEndpoint leftEndpoint, JoinEndpoint rightEndpoint, int order, JoinSourceSyntax sourceSyntax, boolean naturalFlag, List<String> usingColumns, List<Predicate> conditions, SourceSpan sourceSpan, String conditionText) Original 10-arg constructor (non-lateral).
JoinEntity(SemanticJoinType joinType, JoinEndpoint leftEndpoint, JoinEndpoint rightEndpoint, int order, JoinSourceSyntax sourceSyntax, boolean naturalFlag, List<String> usingColumns, List<Predicate> conditions, SourceSpan sourceSpan, String conditionText, boolean lateralFlag) Full constructor.

Method Summary

Modifier and Type	Method and Description
boolean	equals(Object o)
List<Predicate>	getConditions() Never null; empty until ON predicates are attached (slice 168).
String	getConditionText() Optional verbatim SQL substring of the ON condition; may be null.
SemanticJoinType	getJoinType()
JoinEndpoint	getLeftEndpoint()
int	getOrder()
JoinEndpoint	getRightEndpoint()
SourceSpan	getSourceSpan() Optional; null when the parser cannot anchor the join clause.
JoinSourceSyntax	getSourceSyntax()
List<String>	getUsingColumns() Never null; empty unless a USING clause was written.
int	hashCode()
boolean	isLateral() True for a lateral join (SQL Server CROSS APPLY / OUTER APPLY).
boolean	isNatural()
String	toString()
JoinEntity	withConditions(List<Predicate> newConditions) Return a copy of this entity with its ON-condition predicate list replaced (used by slice 168 to attach predicates without mutating the immutable entity built in slice 167).

Methods inherited from class Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

JoinEntity

public JoinEntity(SemanticJoinType joinType,
                  JoinEndpoint leftEndpoint,
                  JoinEndpoint rightEndpoint,
                  int order,
                  JoinSourceSyntax sourceSyntax,
                  boolean naturalFlag,
                  List<String> usingColumns,
                  List<Predicate> conditions,
                  SourceSpan sourceSpan,
                  String conditionText)

Original 10-arg constructor (non-lateral). Retained so existing callers and tests compile unchanged; delegates with lateralFlag = false.

JoinEntity

public JoinEntity(SemanticJoinType joinType,
                  JoinEndpoint leftEndpoint,
                  JoinEndpoint rightEndpoint,
                  int order,
                  JoinSourceSyntax sourceSyntax,
                  boolean naturalFlag,
                  List<String> usingColumns,
                  List<Predicate> conditions,
                  SourceSpan sourceSpan,
                  String conditionText,
                  boolean lateralFlag)

Full constructor. lateralFlag marks a lateral join (SQL Server CROSS APPLY / OUTER APPLY); such a join carries no ON/USING and empty conditions — the correlation lives inside the right operand's own statement graph. The flag lets consumers distinguish a lateral join from a buggy cartesian INNER.

Method Detail

withConditions

public JoinEntity withConditions(List<Predicate> newConditions)

Return a copy of this entity with its ON-condition predicate list replaced (used by slice 168 to attach predicates without mutating the immutable entity built in slice 167). Preserves the lateral flag.

getJoinType

public SemanticJoinType getJoinType()

getLeftEndpoint

public JoinEndpoint getLeftEndpoint()

getRightEndpoint

public JoinEndpoint getRightEndpoint()

getOrder

public int getOrder()

getSourceSyntax

public JoinSourceSyntax getSourceSyntax()

isNatural

public boolean isNatural()

isLateral

public boolean isLateral()

True for a lateral join (SQL Server CROSS APPLY / OUTER APPLY). Such a join has empty getConditions() and getUsingColumns(); the correlation lives inside the right operand. Distinguishes a lateral join from a cartesian INNER.

getUsingColumns

public List<String> getUsingColumns()

Never null; empty unless a USING clause was written.

getConditions

public List<Predicate> getConditions()

Never null; empty until ON predicates are attached (slice 168).

getSourceSpan

public SourceSpan getSourceSpan()

Optional; null when the parser cannot anchor the join clause.

getConditionText

public String getConditionText()

Optional verbatim SQL substring of the ON condition; may be null.

equals

public boolean equals(Object o)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

toString

public String toString()

Overrides:

toString in class Object