org.apache.calcite.rel.externalize

Class RelWriterImpl

java.lang.Object

org.apache.calcite.rel.externalize.RelWriterImpl

All Implemented Interfaces:

RelWriter

Direct Known Subclasses:

RelXmlWriter

public class RelWriterImpl
extends Object
implements RelWriter

Implementation of RelWriter.

Field Summary

Fields

Modifier and Type	Field and Description
private SqlExplainLevel	detailLevel
protected PrintWriter	pw
protected org.apache.calcite.avatica.util.Spacer	spacer
private List<Pair<String,Object>>	values
private boolean	withIdPrefix

Constructor Summary

Constructors

Constructor and Description
RelWriterImpl(PrintWriter pw)
RelWriterImpl(PrintWriter pw, SqlExplainLevel detailLevel, boolean withIdPrefix)

Method Summary

Modifier and Type	Method and Description
private boolean	checkInputsPresentInExplain(RelNode node)
RelWriter	done(RelNode node) Writes the completed explanation.
protected void	explain_(RelNode rel, List<Pair<String,Object>> values)
void	explain(RelNode rel, List<Pair<String,Object>> valueList) Prints an explanation of a node, with a list of (term, value) pairs.
private void	explainInputs(List<RelNode> inputs)
SqlExplainLevel	getDetailLevel()
RelWriter	input(String term, RelNode input) Adds an input to the explanation of the current node.
RelWriter	item(String term, Object value) Adds an attribute to the explanation of the current node.
RelWriter	itemIf(String term, Object value, boolean condition) Adds an input to the explanation of the current node, if a condition holds.
boolean	nest() Returns whether the writer prefers nested values.
String	simple() Converts the collected terms and values to a string.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

pw

protected final PrintWriter pw

detailLevel

private final SqlExplainLevel detailLevel

withIdPrefix

private final boolean withIdPrefix

spacer

protected final org.apache.calcite.avatica.util.Spacer spacer

values

private final List<Pair<String,Object>> values

Constructor Detail

RelWriterImpl

public RelWriterImpl(PrintWriter pw)

RelWriterImpl

public RelWriterImpl(PrintWriter pw,
                     SqlExplainLevel detailLevel,
                     boolean withIdPrefix)

Method Detail

explain_

protected void explain_(RelNode rel,
                        List<Pair<String,Object>> values)

explainInputs

private void explainInputs(List<RelNode> inputs)

explain

public final void explain(RelNode rel,
                          List<Pair<String,Object>> valueList)

Description copied from interface: RelWriter

Prints an explanation of a node, with a list of (term, value) pairs.

The term-value pairs are generally gathered by calling RelNode.explain(RelWriter). Each sub-class of RelNode calls RelWriter.input(String, org.apache.calcite.rel.RelNode) and RelWriter.item(String, Object) to declare term-value pairs.

Specified by:

explain in interface RelWriter

Parameters:

rel - Relational expression

valueList - List of term-value pairs

getDetailLevel

public SqlExplainLevel getDetailLevel()

Specified by:

getDetailLevel in interface RelWriter

Returns:

detail level at which plan should be generated

input

public RelWriter input(String term,
                       RelNode input)

Description copied from interface: RelWriter

Adds an input to the explanation of the current node.

Specified by:

input in interface RelWriter

Parameters:

term - Term for input, e.g. "left" or "input #1".

input - Input relational expression

item

public RelWriter item(String term,
                      Object value)

Description copied from interface: RelWriter

Adds an attribute to the explanation of the current node.

Specified by:

item in interface RelWriter

Parameters:

term - Term for attribute, e.g. "joinType"

value - Attribute value

itemIf

public RelWriter itemIf(String term,
                        Object value,
                        boolean condition)

Description copied from interface: RelWriter

Adds an input to the explanation of the current node, if a condition holds.

Specified by:

itemIf in interface RelWriter

done

public RelWriter done(RelNode node)

Description copied from interface: RelWriter

Writes the completed explanation.

Specified by:

done in interface RelWriter

checkInputsPresentInExplain

private boolean checkInputsPresentInExplain(RelNode node)

nest

public boolean nest()

Description copied from interface: RelWriter

Returns whether the writer prefers nested values. Traditional explain writers prefer flattened values.

Specified by:

nest in interface RelWriter

simple

public String simple()

Converts the collected terms and values to a string. Does not write to the parent writer.