Package org.h2.expression
Class ExpressionColumn
- java.lang.Object
-
- org.h2.expression.Expression
-
- org.h2.expression.ExpressionColumn
-
public final class ExpressionColumn extends Expression
A column reference expression that represents a column of a table or view.
-
-
Field Summary
Fields Modifier and Type Field Description private Column
column
private java.lang.String
columnName
private ColumnResolver
columnResolver
private Database
database
private int
queryLevel
private boolean
quotedName
private boolean
rowId
private java.lang.String
schemaName
private java.lang.String
tableAlias
-
Fields inherited from class org.h2.expression.Expression
AUTO_PARENTHESES, MAP_IN_AGGREGATE, MAP_IN_WINDOW, MAP_INITIAL, WITH_PARENTHESES, WITHOUT_PARENTHESES
-
Fields inherited from interface org.h2.util.HasSQL
ADD_PLAN_INFORMATION, DEFAULT_SQL_FLAGS, NO_CASTS, QUOTE_ONLY_WHEN_REQUIRED, REPLACE_LOBS_FOR_TRACE, TRACE_SQL_FLAGS
-
-
Constructor Summary
Constructors Constructor Description ExpressionColumn(Database database, java.lang.String schemaName, java.lang.String tableAlias)
Creates a new instance of column reference for_ROWID_
column as normal expression.ExpressionColumn(Database database, java.lang.String schemaName, java.lang.String tableAlias, java.lang.String columnName)
Creates a new instance of column reference for regular columns as normal expression.ExpressionColumn(Database database, java.lang.String schemaName, java.lang.String tableAlias, java.lang.String columnName, boolean quotedName)
Creates a new instance of column reference for regular columns as normal expression.ExpressionColumn(Database database, Column column)
Creates a new column reference for metadata of queries; should not be used as normal expression.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description void
createIndexConditions(SessionLocal session, TableFilter filter)
Create index conditions if possible and attach them to the table filter.java.lang.String
getAlias(SessionLocal session, int columnIndex)
Get the alias name of a column or SQL expression if it is not an aliased expression.Column
getColumn()
DbException
getColumnException(int code)
Get exception to throw, with column and table info addedjava.lang.String
getColumnName(SessionLocal session, int columnIndex)
Get the column name or alias name of this expression.java.lang.String
getColumnNameForView(SessionLocal session, int columnIndex)
Get the column name of this expression for a view.int
getCost()
Estimate the cost to process the expression.Expression
getNotIfPossible(SessionLocal session)
If it is possible, return the negated expression.int
getNullable()
Check whether this expression is a column and can store NULL.java.lang.String
getOriginalColumnName()
java.lang.String
getOriginalTableAliasName()
java.lang.String
getSchemaName()
Get the schema name, or nullTableFilter
getTableFilter()
java.lang.String
getTableName()
Get the table name, or nullTypeInfo
getType()
Returns the data type.java.lang.StringBuilder
getUnenclosedSQL(java.lang.StringBuilder builder, int sqlFlags)
Get the SQL statement of this expression.Value
getValue(SessionLocal session)
Return the resulting value for the current row.boolean
isEverything(ExpressionVisitor visitor)
Check if this expression and all sub-expressions can fulfill a criteria.boolean
isIdentity()
Check if this is an identity column.private void
mapColumn(ColumnResolver resolver, Column col, int level)
void
mapColumns(ColumnResolver resolver, int level, int state)
Map the columns of the resolver to expression columns.Expression
optimize(SessionLocal session)
Try to optimize the expression.private Expression
optimizeOther()
void
setEvaluatable(TableFilter tableFilter, boolean b)
Tell the expression columns whether the table filter can return values now.void
updateAggregate(SessionLocal session, int stage)
Update an aggregate value.-
Methods inherited from class org.h2.expression.Expression
addFilterConditions, getBooleanValue, getEnclosedSQL, getNonAliasExpression, getSQL, getSQL, getSQL, getSQL, getSubexpression, getSubexpressionCount, getTableAlias, getWhenSQL, getWhenValue, isConstant, isNullConstant, isValueSet, isWhenConditionOperand, needParentheses, optimizeCondition, toString, writeExpressions, writeExpressions
-
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
-
Methods inherited from interface org.h2.util.HasSQL
getTraceSQL
-
-
-
-
Field Detail
-
database
private final Database database
-
schemaName
private final java.lang.String schemaName
-
tableAlias
private final java.lang.String tableAlias
-
columnName
private final java.lang.String columnName
-
rowId
private final boolean rowId
-
quotedName
private final boolean quotedName
-
columnResolver
private ColumnResolver columnResolver
-
queryLevel
private int queryLevel
-
column
private Column column
-
-
Constructor Detail
-
ExpressionColumn
public ExpressionColumn(Database database, Column column)
Creates a new column reference for metadata of queries; should not be used as normal expression.- Parameters:
database
- the databasecolumn
- the column
-
ExpressionColumn
public ExpressionColumn(Database database, java.lang.String schemaName, java.lang.String tableAlias, java.lang.String columnName)
Creates a new instance of column reference for regular columns as normal expression.- Parameters:
database
- the databaseschemaName
- the schema name, ornull
tableAlias
- the table alias name, table name, ornull
columnName
- the column name
-
ExpressionColumn
public ExpressionColumn(Database database, java.lang.String schemaName, java.lang.String tableAlias, java.lang.String columnName, boolean quotedName)
Creates a new instance of column reference for regular columns as normal expression.- Parameters:
database
- the databaseschemaName
- the schema name, ornull
tableAlias
- the table alias name, table name, ornull
columnName
- the column namequotedName
- whether name was quoted
-
ExpressionColumn
public ExpressionColumn(Database database, java.lang.String schemaName, java.lang.String tableAlias)
Creates a new instance of column reference for_ROWID_
column as normal expression.- Parameters:
database
- the databaseschemaName
- the schema name, ornull
tableAlias
- the table alias name, table name, ornull
-
-
Method Detail
-
getUnenclosedSQL
public java.lang.StringBuilder getUnenclosedSQL(java.lang.StringBuilder builder, int sqlFlags)
Description copied from class:Expression
Get the SQL statement of this expression. This may not always be the original SQL statement, especially after optimization. Enclosing '(' and ')' are never appended.- Specified by:
getUnenclosedSQL
in classExpression
- Parameters:
builder
- string buildersqlFlags
- formatting flags- Returns:
- the specified string builder
-
getTableFilter
public TableFilter getTableFilter()
-
mapColumns
public void mapColumns(ColumnResolver resolver, int level, int state)
Description copied from class:Expression
Map the columns of the resolver to expression columns.- Specified by:
mapColumns
in classExpression
- Parameters:
resolver
- the column resolverlevel
- the subquery nesting levelstate
- current state for nesting checks, initial value isExpression.MAP_INITIAL
-
mapColumn
private void mapColumn(ColumnResolver resolver, Column col, int level)
-
optimize
public Expression optimize(SessionLocal session)
Description copied from class:Expression
Try to optimize the expression.- Specified by:
optimize
in classExpression
- Parameters:
session
- the session- Returns:
- the optimized expression
-
optimizeOther
private Expression optimizeOther()
-
getColumnException
public DbException getColumnException(int code)
Get exception to throw, with column and table info added- Parameters:
code
- SQL error code- Returns:
- DbException
-
updateAggregate
public void updateAggregate(SessionLocal session, int stage)
Description copied from class:Expression
Update an aggregate value. This method is called at statement execution time. It is usually called once for each row, but if the expression is used multiple times (for example in the column list, and as part of the HAVING expression) it is called multiple times - the row counter needs to be used to make sure the internal state is only updated once.- Specified by:
updateAggregate
in classExpression
- Parameters:
session
- the sessionstage
- select stage
-
getValue
public Value getValue(SessionLocal session)
Description copied from class:Expression
Return the resulting value for the current row.- Specified by:
getValue
in classExpression
- Parameters:
session
- the session- Returns:
- the result
-
getType
public TypeInfo getType()
Description copied from class:Expression
Returns the data type. The data type may be unknown before the optimization phase.- Specified by:
getType
in interfaceTyped
- Specified by:
getType
in classExpression
- Returns:
- the data type
-
setEvaluatable
public void setEvaluatable(TableFilter tableFilter, boolean b)
Description copied from class:Expression
Tell the expression columns whether the table filter can return values now. This is used when optimizing the query.- Specified by:
setEvaluatable
in classExpression
- Parameters:
tableFilter
- the table filterb
- true if the table filter can return value
-
getColumn
public Column getColumn()
-
getOriginalColumnName
public java.lang.String getOriginalColumnName()
-
getOriginalTableAliasName
public java.lang.String getOriginalTableAliasName()
-
getColumnName
public java.lang.String getColumnName(SessionLocal session, int columnIndex)
Description copied from class:Expression
Get the column name or alias name of this expression.- Overrides:
getColumnName
in classExpression
- Parameters:
session
- the sessioncolumnIndex
- 0-based column index- Returns:
- the column name
-
getSchemaName
public java.lang.String getSchemaName()
Description copied from class:Expression
Get the schema name, or null- Overrides:
getSchemaName
in classExpression
- Returns:
- the schema name
-
getTableName
public java.lang.String getTableName()
Description copied from class:Expression
Get the table name, or null- Overrides:
getTableName
in classExpression
- Returns:
- the table name
-
getAlias
public java.lang.String getAlias(SessionLocal session, int columnIndex)
Description copied from class:Expression
Get the alias name of a column or SQL expression if it is not an aliased expression.- Overrides:
getAlias
in classExpression
- Parameters:
session
- the sessioncolumnIndex
- 0-based column index- Returns:
- the alias name
-
getColumnNameForView
public java.lang.String getColumnNameForView(SessionLocal session, int columnIndex)
Description copied from class:Expression
Get the column name of this expression for a view.- Overrides:
getColumnNameForView
in classExpression
- Parameters:
session
- the sessioncolumnIndex
- 0-based column index- Returns:
- the column name for a view
-
isIdentity
public boolean isIdentity()
Description copied from class:Expression
Check if this is an identity column.- Overrides:
isIdentity
in classExpression
- Returns:
- true if it is an identity column
-
getNullable
public int getNullable()
Description copied from class:Expression
Check whether this expression is a column and can store NULL.- Overrides:
getNullable
in classExpression
- Returns:
- whether NULL is allowed
-
isEverything
public boolean isEverything(ExpressionVisitor visitor)
Description copied from class:Expression
Check if this expression and all sub-expressions can fulfill a criteria. If any part returns false, the result is false.- Specified by:
isEverything
in classExpression
- Parameters:
visitor
- the visitor- Returns:
- if the criteria can be fulfilled
-
getCost
public int getCost()
Description copied from class:Expression
Estimate the cost to process the expression. Used when optimizing the query, to calculate the query plan with the lowest estimated cost.- Specified by:
getCost
in classExpression
- Returns:
- the estimated cost
-
createIndexConditions
public void createIndexConditions(SessionLocal session, TableFilter filter)
Description copied from class:Expression
Create index conditions if possible and attach them to the table filter.- Overrides:
createIndexConditions
in classExpression
- Parameters:
session
- the sessionfilter
- the table filter
-
getNotIfPossible
public Expression getNotIfPossible(SessionLocal session)
Description copied from class:Expression
If it is possible, return the negated expression. This is used to optimize NOT expressions: NOT ID>10 can be converted to ID<=10. Returns null if negating is not possible.- Overrides:
getNotIfPossible
in classExpression
- Parameters:
session
- the session- Returns:
- the negated expression, or null
-
-