Package org.apache.flink.table.types.inference.strategies

Class VaryingSequenceInputTypeStrategy

java.lang.Object

org.apache.flink.table.types.inference.strategies.VaryingSequenceInputTypeStrategy

All Implemented Interfaces:

InputTypeStrategy

@Internal
public final class VaryingSequenceInputTypeStrategy
extends Object
implements InputTypeStrategy

Strategy for inferring and validating a varying function signature like f(INT, STRING, NUMERIC...) or f(i INT, str STRING, num NUMERIC...) using a sequence of ArgumentTypeStrategys. The first n - 1 arguments must be constant. The n-th argument can occur 0, 1, or more times.

Constructor Summary

Constructors

Constructor	Description
VaryingSequenceInputTypeStrategy(List<ArgumentTypeStrategy> argumentStrategies, List<String> argumentNames)

Method Summary

Modifier and Type	Method	Description
boolean	equals(Object o)
ArgumentCount	getArgumentCount()	Initial input validation based on the number of arguments.
List<Signature>	getExpectedSignatures(FunctionDefinition definition)	Returns a summary of the function's expected signatures.
int	hashCode()
Optional<List<DataType>>	inferInputTypes(CallContext callContext, boolean throwOnFailure)	Main logic for inferring and validating the input arguments.

Methods inherited from class java.lang.Object

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

Constructor Detail

VaryingSequenceInputTypeStrategy

public VaryingSequenceInputTypeStrategy(List<ArgumentTypeStrategy> argumentStrategies,
                                        @Nullable
                                        List<String> argumentNames)

Method Detail

getArgumentCount

public ArgumentCount getArgumentCount()

Description copied from interface: InputTypeStrategy

Initial input validation based on the number of arguments.

Specified by:

getArgumentCount in interface InputTypeStrategy

inferInputTypes

public Optional<List<DataType>> inferInputTypes(CallContext callContext,
                                                boolean throwOnFailure)

Description copied from interface: InputTypeStrategy

Main logic for inferring and validating the input arguments. Returns a list of argument data types that are valid for the given call. If the returned types differ from CallContext.getArgumentDataTypes(), a casting operation can be inserted. An empty result means that the given input is invalid.

Specified by:

inferInputTypes in interface InputTypeStrategy

Parameters:

callContext - provides details about the function call

throwOnFailure - whether this function is allowed to throw an ValidationException with a meaningful exception in case the inference is not successful or if this function should simply return an empty result.

Returns:

three-state result for either "true, same data types as arguments", "true, but arguments must be casted to returned data types", or "false, no inferred data types could be found"

See Also:

CallContext.newValidationError(String, Object...)

getExpectedSignatures

public List<Signature> getExpectedSignatures(FunctionDefinition definition)

Description copied from interface: InputTypeStrategy

Returns a summary of the function's expected signatures.

Specified by:

getExpectedSignatures in interface InputTypeStrategy

Parameters:

definition - the function definition that defines the function currently being called.

equals

public boolean equals(Object o)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object