JoinAssociateRule (Apache Calcite API)

java.lang.Object
- org.apache.calcite.plan.RelOptRule
- - org.apache.calcite.rel.rules.JoinAssociateRule

```
public class JoinAssociateRule
extends RelOptRule
```
Planner rule that changes a join based on the associativity rule.
((a JOIN b) JOIN c) → (a JOIN (b JOIN c))

We do not need a rule to convert (a JOIN (b JOIN c)) → ((a JOIN b) JOIN c) because we have JoinCommuteRule.

See Also:

JoinCommuteRule

- Field Summary
  
  Fields
  Modifier and Type Field Description
  
  static JoinAssociateRule INSTANCE
  The singleton.
  - Fields inherited from class org.apache.calcite.plan.RelOptRule
    description, operands, relBuilderFactory
- Constructor Summary
  
  Constructors
  Constructor Description
  
  JoinAssociateRule(RelBuilderFactory relBuilderFactory)
  Creates a JoinAssociateRule.
- Method Summary
  
  All Methods Instance Methods Concrete Methods
  Modifier and Type Method Description
  
  void onMatch(RelOptRuleCall call)
  Receives notification about a rule match.
  - Methods inherited from class org.apache.calcite.plan.RelOptRule
    any, convert, convert, convertList, convertOperand, convertOperand, equals, equals, getOperand, getOperands, getOutConvention, getOutTrait, hashCode, matches, none, operand, operand, operand, operand, operand, operandJ, operandJ, some, toString, unordered
  - Methods inherited from class java.lang.Object
    clone, finalize, getClass, notify, notifyAll, wait, wait, wait

- Field Detail
  - INSTANCE
```
public static final JoinAssociateRule INSTANCE
```
    The singleton.
- Constructor Detail
  - JoinAssociateRule
```
public JoinAssociateRule(RelBuilderFactory relBuilderFactory)
```
    Creates a JoinAssociateRule.
- Method Detail
  - onMatch
```
public void onMatch(RelOptRuleCall call)
```
    Description copied from class: RelOptRule
    
    Receives notification about a rule match. At the time that this method is called, call.rels holds the set of relational expressions which match the operands to the rule; call.rels[0] is the root expression.
    Typically a rule would check that the nodes are valid matches, creates a new expression, then calls back RelOptRuleCall.transformTo(org.apache.calcite.rel.RelNode, java.util.Map<org.apache.calcite.rel.RelNode, org.apache.calcite.rel.RelNode>) to register the expression.
    
    Specified by:
    
    onMatch in class RelOptRule
    
    Parameters:
    
    call - Rule call
    
    See Also:
    
    RelOptRule.matches(RelOptRuleCall)