org.apache.flink.table.planner.functions.inference

Class CallBindingCallContext

java.lang.Object

org.apache.flink.table.planner.functions.inference.AbstractSqlCallContext

org.apache.flink.table.planner.functions.inference.CallBindingCallContext

All Implemented Interfaces:

CallContext

@Internal
public final class CallBindingCallContext
extends AbstractSqlCallContext

A CallContext backed by SqlCallBinding. Compared to OperatorBindingCallContext, this class is able to reorder arguments.

Nested Class Summary

Nested classes/interfaces inherited from class org.apache.flink.table.planner.functions.inference.AbstractSqlCallContext

AbstractSqlCallContext.LiteralValueAccessor

Constructor Summary

Constructors

Constructor and Description
CallBindingCallContext(DataTypeFactory dataTypeFactory, FunctionDefinition definition, org.apache.calcite.sql.SqlCallBinding binding, org.apache.calcite.rel.type.RelDataType outputType)

Method Summary

Modifier and Type	Method and Description
List<DataType>	getArgumentDataTypes() Returns a resolved list of the call's argument types.
<T> Optional<T>	getArgumentValue(int pos, Class<T> clazz) Returns the literal value of the argument at the given position, given that the argument is a literal, is not null, and can be expressed as an instance of the provided class.
Optional<DataType>	getOutputDataType() Returns the inferred output data type of the function call.
boolean	isArgumentLiteral(int pos) Returns whether the argument at the given position is a value literal.
boolean	isArgumentNull(int pos) Returns true if the argument at the given position is a literal and null, false otherwise.

Methods inherited from class org.apache.flink.table.planner.functions.inference.AbstractSqlCallContext

getDataTypeFactory, getFunctionDefinition, getLiteralValueAs, getName

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.apache.flink.table.types.inference.CallContext

newValidationError

Constructor Detail

CallBindingCallContext

public CallBindingCallContext(DataTypeFactory dataTypeFactory,
                              FunctionDefinition definition,
                              org.apache.calcite.sql.SqlCallBinding binding,
                              @Nullable
                              org.apache.calcite.rel.type.RelDataType outputType)

Method Detail

isArgumentLiteral

public boolean isArgumentLiteral(int pos)

Description copied from interface: CallContext

Returns whether the argument at the given position is a value literal.

isArgumentNull

public boolean isArgumentNull(int pos)

Description copied from interface: CallContext

Returns true if the argument at the given position is a literal and null, false otherwise.

Use CallContext.isArgumentLiteral(int) before to check if the argument is actually a literal.

getArgumentValue

public <T> Optional<T> getArgumentValue(int pos,
                                        Class<T> clazz)

Description copied from interface: CallContext

Returns the literal value of the argument at the given position, given that the argument is a literal, is not null, and can be expressed as an instance of the provided class.

It supports conversions to default conversion classes of LogicalTypes. This method should not be called with other classes.

Use CallContext.isArgumentLiteral(int) before to check if the argument is actually a literal.

getArgumentDataTypes

public List<DataType> getArgumentDataTypes()

Description copied from interface: CallContext

Returns a resolved list of the call's argument types. It also includes a type for every argument in a vararg function call.

getOutputDataType

public Optional<DataType> getOutputDataType()

Description copied from interface: CallContext

Returns the inferred output data type of the function call.

It does this by inferring the input argument data type using ArgumentTypeStrategy.inferArgumentType(CallContext, int, boolean) of a wrapping call (if available) where this function call is an argument. For example, takes_string(this_function(NULL)) would lead to a DataTypes.STRING() because the wrapping call expects a string argument.