org.eigenbase.sql
Class SqlInsert

java.lang.Object
  extended by org.eigenbase.sql.SqlNode
      extended by org.eigenbase.sql.SqlCall
          extended by org.eigenbase.sql.SqlInsert
All Implemented Interfaces:
Cloneable

public class SqlInsert
extends SqlCall

A SqlInsert is a node of a parse tree which represents an INSERT statement.


Field Summary
static int KEYWORDS_OPERAND
           
static int OPERAND_COUNT
           
static int SOURCE_OPERAND
           
static int TARGET_COLUMN_LIST_OPERAND
           
static int TARGET_TABLE_OPERAND
           
 
Fields inherited from class org.eigenbase.sql.SqlCall
operands
 
Fields inherited from class org.eigenbase.sql.SqlNode
emptyArray
 
Constructor Summary
SqlInsert(SqlSpecialOperator operator, SqlNodeList keywords, SqlIdentifier targetTable, SqlNode source, SqlNodeList columnList, SqlParserPos pos)
           
 
Method Summary
 SqlNode getModifierNode(SqlInsertKeyword modifier)
           
 SqlNode getSource()
           
 SqlNodeList getTargetColumnList()
           
 SqlIdentifier getTargetTable()
           
 void unparse(SqlWriter writer, int leftPrec, int rightPrec)
          Writes a SQL representation of this node to a writer.
 void validate(SqlValidator validator, SqlValidatorScope scope)
          Validates this call.
 
Methods inherited from class org.eigenbase.sql.SqlCall
accept, clone, equalsDeep, findValidOptions, getCallSignature, getFunctionQuantifier, getKind, getMonotonicity, getOperands, getOperator, isA, isCountStar, isExpanded, isName, setOperand, setOperator
 
Methods inherited from class org.eigenbase.sql.SqlNode
clone, cloneArray, equalDeep, getParserPosition, toSqlString, toSqlString, toString, validateExpr
 
Methods inherited from class java.lang.Object
equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Field Detail

KEYWORDS_OPERAND

public static final int KEYWORDS_OPERAND
See Also:
Constant Field Values

TARGET_TABLE_OPERAND

public static final int TARGET_TABLE_OPERAND
See Also:
Constant Field Values

SOURCE_OPERAND

public static final int SOURCE_OPERAND
See Also:
Constant Field Values

TARGET_COLUMN_LIST_OPERAND

public static final int TARGET_COLUMN_LIST_OPERAND
See Also:
Constant Field Values

OPERAND_COUNT

public static final int OPERAND_COUNT
See Also:
Constant Field Values
Constructor Detail

SqlInsert

public SqlInsert(SqlSpecialOperator operator,
                 SqlNodeList keywords,
                 SqlIdentifier targetTable,
                 SqlNode source,
                 SqlNodeList columnList,
                 SqlParserPos pos)
Method Detail

getTargetTable

public SqlIdentifier getTargetTable()
Returns:
the identifier for the target table of the insertion

getSource

public SqlNode getSource()
Returns:
the source expression for the data to be inserted

getTargetColumnList

public SqlNodeList getTargetColumnList()
Returns:
the list of target column names, or null for all columns in the target table

getModifierNode

public final SqlNode getModifierNode(SqlInsertKeyword modifier)

unparse

public void unparse(SqlWriter writer,
                    int leftPrec,
                    int rightPrec)
Description copied from class: SqlNode
Writes a SQL representation of this node to a writer.

The leftPrec and rightPrec parameters give us enough context to decide whether we need to enclose the expression in parentheses. For example, we need parentheses around "2 + 3" if preceded by "5 *". This is because the precedence of the "*" operator is greater than the precedence of the "+" operator.

The algorithm handles left- and right-associative operators by giving them slightly different left- and right-precedence.

If SqlWriter.isAlwaysUseParentheses() is true, we use parentheses even when they are not required by the precedence rules.

For the details of this algorithm, see SqlCall.unparse(org.eigenbase.sql.SqlWriter, int, int).

Overrides:
unparse in class SqlCall
Parameters:
writer - Target writer
leftPrec - The precedence of the SqlNode immediately preceding this node in a depth-first scan of the parse tree
rightPrec - The precedence of the SqlNode immediately

validate

public void validate(SqlValidator validator,
                     SqlValidatorScope scope)
Description copied from class: SqlCall
Validates this call.

The default implementation delegates the validation to the operator's SqlOperator.validateCall(org.eigenbase.sql.SqlCall, org.eigenbase.sql.validate.SqlValidator, org.eigenbase.sql.validate.SqlValidatorScope, org.eigenbase.sql.validate.SqlValidatorScope). Derived classes may override (as do, for example SqlSelect and SqlUpdate).

Overrides:
validate in class SqlCall
scope - Validator