com.hazelcast.org.apache.calcite.sql.SqlSyntax Maven / Gradle / Ivy
/*
* Licensed to the Apache Software Foundation (ASF) under one or more
* contributor license agreements. See the NOTICE file distributed with
* this work for additional information regarding copyright ownership.
* The ASF licenses this file to you under the Apache License, Version 2.0
* (the "License"); you may not use this file except in compliance with
* the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package com.hazelcast.org.apache.calcite.sql;
import com.hazelcast.org.apache.calcite.sql.validate.SqlConformance;
import com.hazelcast.org.apache.calcite.util.Util;
import com.hazelcast.org.checkerframework.checker.initialization.qual.NotOnlyInitialized;
import com.hazelcast.org.checkerframework.checker.nullness.qual.Nullable;
/**
* Enumeration of possible syntactic types of {@link SqlOperator operators}.
*/
public enum SqlSyntax {
/**
* Function syntax, as in "Foo(x, y)".
*/
FUNCTION {
@Override public void unparse(
SqlWriter writer,
SqlOperator operator,
SqlCall call,
int leftPrec,
int rightPrec) {
SqlUtil.unparseFunctionSyntax(operator, writer, call, false);
}
},
/**
* Function syntax, as in "Foo(x, y)", but uses "*" if there are no arguments,
* for example "COUNT(*)".
*/
FUNCTION_STAR {
@Override public void unparse(
SqlWriter writer,
SqlOperator operator,
SqlCall call,
int leftPrec,
int rightPrec) {
SqlUtil.unparseFunctionSyntax(operator, writer, call, false);
}
},
/**
* Function syntax with optional ORDER BY, as in "STRING_AGG(x, y ORDER BY z)".
*/
ORDERED_FUNCTION(FUNCTION) {
@Override public void unparse(SqlWriter writer, SqlOperator operator,
SqlCall call, int leftPrec, int rightPrec) {
SqlUtil.unparseFunctionSyntax(operator, writer, call, true);
}
},
/**
* Binary operator syntax, as in "x + y".
*/
BINARY {
@Override public void unparse(
SqlWriter writer,
SqlOperator operator,
SqlCall call,
int leftPrec,
int rightPrec) {
SqlUtil.unparseBinarySyntax(operator, call, writer, leftPrec, rightPrec);
}
},
/**
* Prefix unary operator syntax, as in "- x".
*/
PREFIX {
@Override public void unparse(
SqlWriter writer,
SqlOperator operator,
SqlCall call,
int leftPrec,
int rightPrec) {
assert call.operandCount() == 1;
writer.keyword(operator.getName());
call.operand(0).unparse(writer, operator.getLeftPrec(),
operator.getRightPrec());
}
},
/**
* Postfix unary operator syntax, as in "x ++".
*/
POSTFIX {
@Override public void unparse(
SqlWriter writer,
SqlOperator operator,
SqlCall call,
int leftPrec,
int rightPrec) {
assert call.operandCount() == 1;
call.operand(0).unparse(writer, operator.getLeftPrec(),
operator.getRightPrec());
writer.keyword(operator.getName());
}
},
/**
* Special syntax, such as that of the SQL CASE operator, "CASE x WHEN 1
* THEN 2 ELSE 3 END".
*/
SPECIAL {
@Override public void unparse(
SqlWriter writer,
SqlOperator operator,
SqlCall call,
int leftPrec,
int rightPrec) {
// You probably need to override the operator's unparse
// method.
throw Util.needToImplement(this);
}
},
/**
* Function syntax which takes no parentheses if there are no arguments, for
* example "CURRENTTIME".
*
* @see SqlConformance#allowNiladicParentheses()
*/
FUNCTION_ID {
@Override public void unparse(
SqlWriter writer,
SqlOperator operator,
SqlCall call,
int leftPrec,
int rightPrec) {
SqlUtil.unparseFunctionSyntax(operator, writer, call, false);
}
},
/**
* Syntax of an internal operator, which does not appear in the SQL.
*/
INTERNAL {
@Override public void unparse(
SqlWriter writer,
SqlOperator operator,
SqlCall call,
int leftPrec,
int rightPrec) {
throw new UnsupportedOperationException("Internal operator '"
+ operator + "' " + "cannot be un-parsed");
}
};
/** Syntax to treat this syntax as equivalent to when resolving operators. */
@NotOnlyInitialized
public final SqlSyntax family;
SqlSyntax() {
this(null);
}
SqlSyntax(@Nullable SqlSyntax family) {
this.family = family == null ? this : family;
}
/**
* Converts a call to an operator of this syntax into a string.
*/
public abstract void unparse(
SqlWriter writer,
SqlOperator operator,
SqlCall call,
int leftPrec,
int rightPrec);
}
© 2015 - 2024 Weber Informatics LLC | Privacy Policy