Package org.h2.expression.condition

Class CompareLike

java.lang.Object

org.h2.expression.Expression

org.h2.expression.condition.Condition

org.h2.expression.condition.CompareLike

All Implemented Interfaces:

HasSQL, Typed

public final class CompareLike
extends Condition

Pattern matching comparison expression: WHERE NAME LIKE ?

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	CompareLike.LikeType	The type of comparison.

Field Summary

Fields

Modifier and Type	Field	Description
private static int	ANY
private CompareMode	compareMode
private java.lang.String	defaultEscape
private Expression	escape
private boolean	fastCompare
private boolean	ignoreCase
private boolean	invalidPattern
private boolean	isInit
private Expression	left
private CompareLike.LikeType	likeType
private static int	MATCH
private boolean	not
private static int	ONE
private char[]	patternChars
private int	patternLength
private java.util.regex.Pattern	patternRegexp
private java.lang.String	patternString
private int[]	patternTypes	one of MATCH / ONE / ANY
private Expression	right
private boolean	shortcutToContains	indicates that we can shortcut the comparison and use contains
private boolean	shortcutToEndsWith	indicates that we can shortcut the comparison and use endsWith
private boolean	shortcutToStartsWith	indicates that we can shortcut the comparison and use startsWith
private boolean	whenOperand

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
CompareLike(Database db, Expression left, boolean not, boolean whenOperand, Expression right, Expression escape, CompareLike.LikeType likeType)
CompareLike(CompareMode compareMode, java.lang.String defaultEscape, Expression left, boolean not, boolean whenOperand, Expression right, Expression escape, CompareLike.LikeType likeType)

Method Summary

Modifier and Type	Method	Description
private boolean	compare(char[] pattern, java.lang.String s, int pi, int si)
private boolean	compareAt(java.lang.String s, int pi, int si, int sLen, char[] pattern, int[] types)
private static boolean	containsIgnoreCase(java.lang.String src, java.lang.String what)
void	createIndexConditions(SessionLocal session, TableFilter filter)	Create index conditions if possible and attach them to the table filter.
int	getCost()	Estimate the cost to process the expression.
private static java.lang.Character	getEscapeChar(java.lang.String s)
private java.lang.Character	getEscapeChar(Value e)
Expression	getNotIfPossible(SessionLocal session)	If it is possible, return the negated expression.
Expression	getSubexpression(int index)	Returns subexpression with specified index.
int	getSubexpressionCount()	Returns count of subexpressions.
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.
private Value	getValue(SessionLocal session, Value left)
java.lang.StringBuilder	getWhenSQL(java.lang.StringBuilder builder, int sqlFlags)	Appends the SQL statement of this when operand to the specified builder.
boolean	getWhenValue(SessionLocal session, Value left)	Return the resulting value of when operand for the current row.
void	initPattern(java.lang.String p, java.lang.Character escapeChar)	Initializes the pattern.
boolean	isEverything(ExpressionVisitor visitor)	Check if this expression and all sub-expressions can fulfill a criteria.
private boolean	isFullMatch()
boolean	isWhenConditionOperand()	Returns whether this expression is a right side of condition in a when operand.
void	mapColumns(ColumnResolver resolver, int level, int state)	Map the columns of the resolver to expression columns.
boolean	needParentheses()	Returns whether this expressions needs to be wrapped in parentheses when it is used as an argument of other expressions.
Expression	optimize(SessionLocal session)	Try to optimize the expression.
void	setEvaluatable(TableFilter tableFilter, boolean b)	Tell the expression columns whether the table filter can return values now.
boolean	test(java.lang.String value)	Test if the value matches the initialized pattern.
boolean	test(java.lang.String testPattern, java.lang.String value, char escapeChar)	Test if the value matches the pattern.
void	updateAggregate(SessionLocal session, int stage)	Update an aggregate value.

Methods inherited from class org.h2.expression.condition.Condition

castToBoolean, getType

Methods inherited from class org.h2.expression.Expression

addFilterConditions, getAlias, getBooleanValue, getColumnName, getColumnNameForView, getEnclosedSQL, getNonAliasExpression, getNullable, getSchemaName, getSQL, getSQL, getSQL, getSQL, getTableAlias, getTableName, isConstant, isIdentity, isNullConstant, isValueSet, 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

MATCH

private static final int MATCH

See Also:

Constant Field Values

ONE

private static final int ONE

See Also:

Constant Field Values

ANY

private static final int ANY

See Also:

Constant Field Values

compareMode

private final CompareMode compareMode

defaultEscape

private final java.lang.String defaultEscape

likeType

private final CompareLike.LikeType likeType

left

private Expression left

not

private final boolean not

whenOperand

private final boolean whenOperand

right

private Expression right

escape

private Expression escape

isInit

private boolean isInit

patternChars

private char[] patternChars

patternString

private java.lang.String patternString

patternTypes

private int[] patternTypes

one of MATCH / ONE / ANY

patternLength

private int patternLength

patternRegexp

private java.util.regex.Pattern patternRegexp

ignoreCase

private boolean ignoreCase

fastCompare

private boolean fastCompare

invalidPattern

private boolean invalidPattern

shortcutToStartsWith

private boolean shortcutToStartsWith

indicates that we can shortcut the comparison and use startsWith

shortcutToEndsWith

private boolean shortcutToEndsWith

indicates that we can shortcut the comparison and use endsWith

shortcutToContains

private boolean shortcutToContains

indicates that we can shortcut the comparison and use contains

Constructor Detail

CompareLike

public CompareLike(Database db,
                   Expression left,
                   boolean not,
                   boolean whenOperand,
                   Expression right,
                   Expression escape,
                   CompareLike.LikeType likeType)

CompareLike

public CompareLike(CompareMode compareMode,
                   java.lang.String defaultEscape,
                   Expression left,
                   boolean not,
                   boolean whenOperand,
                   Expression right,
                   Expression escape,
                   CompareLike.LikeType likeType)

Method Detail

getEscapeChar

private static java.lang.Character getEscapeChar(java.lang.String s)

needParentheses

public boolean needParentheses()

Description copied from class: Expression

Returns whether this expressions needs to be wrapped in parentheses when it is used as an argument of other expressions.

Overrides:

needParentheses in class Expression

Returns:

true if it is

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 class Expression

Parameters:

builder - string builder

sqlFlags - formatting flags

Returns:

the specified string builder

getWhenSQL

public java.lang.StringBuilder getWhenSQL(java.lang.StringBuilder builder,
                                          int sqlFlags)

Description copied from class: Expression

Appends the SQL statement of this when operand to the specified builder.

Overrides:

getWhenSQL in class Expression

Parameters:

builder - string builder

sqlFlags - formatting flags

Returns:

the specified string builder

optimize

public Expression optimize(SessionLocal session)

Description copied from class: Expression

Try to optimize the expression.

Specified by:

optimize in class Expression

Parameters:

session - the session

Returns:

the optimized expression

getEscapeChar

private java.lang.Character getEscapeChar(Value e)

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 class Expression

Parameters:

session - the session

filter - the table filter

getValue

public Value getValue(SessionLocal session)

Description copied from class: Expression

Return the resulting value for the current row.

Specified by:

getValue in class Expression

Parameters:

session - the session

Returns:

the result

getWhenValue

public boolean getWhenValue(SessionLocal session,
                            Value left)

Description copied from class: Expression

Return the resulting value of when operand for the current row.

Overrides:

getWhenValue in class Expression

Parameters:

session - the session

left - value on the left side

Returns:

the result

getValue

private Value getValue(SessionLocal session,
                       Value left)

containsIgnoreCase

private static boolean containsIgnoreCase(java.lang.String src,
                                          java.lang.String what)

compareAt

private boolean compareAt(java.lang.String s,
                          int pi,
                          int si,
                          int sLen,
                          char[] pattern,
                          int[] types)

compare

private boolean compare(char[] pattern,
                        java.lang.String s,
                        int pi,
                        int si)

isWhenConditionOperand

public boolean isWhenConditionOperand()

Description copied from class: Expression

Returns whether this expression is a right side of condition in a when operand.

Overrides:

isWhenConditionOperand in class Expression

Returns:

true if it is, false otherwise

test

public boolean test(java.lang.String testPattern,
                    java.lang.String value,
                    char escapeChar)

Test if the value matches the pattern.

Parameters:

testPattern - the pattern

value - the value

escapeChar - the escape character

Returns:

true if the value matches

test

public boolean test(java.lang.String value)

Test if the value matches the initialized pattern.

Parameters:

value - the value

Returns:

true if the value matches

initPattern

public void initPattern(java.lang.String p,
                        java.lang.Character escapeChar)

Initializes the pattern.

Parameters:

p - the pattern

escapeChar - the escape character

isFullMatch

private boolean isFullMatch()

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 class Expression

Parameters:

session - the session

Returns:

the negated expression, or null

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 class Expression

Parameters:

resolver - the column resolver

level - the subquery nesting level

state - current state for nesting checks, initial value is Expression.MAP_INITIAL

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 class Expression

Parameters:

tableFilter - the table filter

b - true if the table filter can return value

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 class Expression

Parameters:

session - the session

stage - select stage

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 class Expression

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 class Expression

Returns:

the estimated cost

getSubexpressionCount

public int getSubexpressionCount()

Description copied from class: Expression

Returns count of subexpressions.

Overrides:

getSubexpressionCount in class Expression

Returns:

count of subexpressions

getSubexpression

public Expression getSubexpression(int index)

Description copied from class: Expression

Returns subexpression with specified index.

Overrides:

getSubexpression in class Expression

Parameters:

index - 0-based index

Returns:

subexpression with specified index, may be null