- java.lang.Object
-
- org.jooq.impl.CustomCondition
-
- All Implemented Interfaces:
Serializable
,Condition
,QueryPart
,QueryPartInternal
public abstract class CustomCondition extends Object
A base class for customCondition
implementations in client code.Client code may provide proper
Condition
implementations extending this useful base class. All necessary parts of theCondition
interface are already implemented. Only this method needs further implementation:accept(Context)
.Refer to that methods' Javadoc for further details about their expected behaviour.
- Author:
- Lukas Eder
- See Also:
- Serialized Form
-
-
Constructor Summary
Constructors Modifier Constructor Description protected
CustomCondition()
-
Method Summary
All Methods Instance Methods Abstract Methods Concrete Methods Deprecated Methods Modifier and Type Method Description abstract void
accept(Context<?> ctx)
Subclasses must implement this method.Condition
and(Boolean other)
Combine this condition with another one using theOperator.AND
operator.Condition
and(String sql)
Combine this condition with another one using theOperator.AND
operator.Condition
and(String sql, Object... bindings)
Combine this condition with another one using theOperator.AND
operator.Condition
and(String sql, QueryPart... parts)
Combine this condition with another one using theOperator.AND
operator.Condition
and(Condition other)
Combine this condition with another one using theOperator.AND
operator.Condition
and(Field<Boolean> other)
Combine this condition with another one using theOperator.AND
operator.Condition
and(SQL sql)
Combine this condition with another one using theOperator.AND
operator.Condition
andExists(Select<?> select)
Combine this condition with an EXISTS clause using theOperator.AND
operator.Condition
andNot(Boolean other)
Combine this condition with a negated other one using theOperator.AND
operator.Condition
andNot(Condition other)
Combine this condition with a negated other one using theOperator.AND
operator.Condition
andNot(Field<Boolean> other)
Combine this condition with a negated other one using theOperator.AND
operator.Condition
andNotExists(Select<?> select)
Combine this condition with a NOT EXIST clause using theOperator.AND
operator.void
bind(BindContext context)
Deprecated.- 3.4.0 - [#2694] - UseQueryPartInternal.accept(Context)
instead.Clause[]
clauses(Context<?> ctx)
TheClause
s that are represented by this query part.protected DSLContext
create()
Deprecated.- 3.11.0 - [#6722] - UseAttachable.configuration()
andConfiguration.dsl()
instead.protected DSLContext
create(Configuration configuration)
Deprecated.- 3.11.0 - [#6722] - UseAttachable.configuration()
andConfiguration.dsl()
instead.protected DSLContext
create(Context<?> ctx)
Deprecated.- 3.11.0 - [#6722] - UseAttachable.configuration()
andConfiguration.dsl()
instead.boolean
declaresCTE()
Subclasses may override thisboolean
declaresFields()
Subclasses may override thisboolean
declaresTables()
Subclasses may override thisboolean
declaresWindows()
Subclasses may override thisboolean
equals(Object that)
Check whether thisQueryPart
can be considered equal to anotherQueryPart
.boolean
generatesCast()
Subclasses may override thisint
hashCode()
Generate a hash code from thisQueryPart
.Condition
not()
Invert this conditionCondition
or(Boolean other)
Combine this condition with another one using theOperator.OR
operator.Condition
or(String sql)
Combine this condition with another one using theOperator.OR
operator.Condition
or(String sql, Object... bindings)
Combine this condition with another one using theOperator.OR
operator.Condition
or(String sql, QueryPart... parts)
Combine this condition with another one using theOperator.OR
operator.Condition
or(Condition other)
Combine this condition with another one using theOperator.OR
operator.Condition
or(Field<Boolean> other)
Combine this condition with another one using theOperator.OR
operator.Condition
or(SQL sql)
Combine this condition with another one using theOperator.OR
operator.Condition
orExists(Select<?> select)
Combine this condition with an EXISTS clause using theOperator.OR
operator.Condition
orNot(Boolean other)
Combine this condition with a negated other one using theOperator.OR
operator.Condition
orNot(Condition other)
Combine this condition with a negated other one using theOperator.OR
operator.Condition
orNot(Field<Boolean> other)
Combine this condition with a negated other one using theOperator.OR
operator.Condition
orNotExists(Select<?> select)
Combine this condition with a NOT EXIST clause using theOperator.OR
operator.boolean
rendersContent(Context<?> ctx)
Subclasses may override thisvoid
toSQL(RenderContext context)
Deprecated.- 3.4.0 - [#2694] - UseQueryPartInternal.accept(Context)
instead.String
toString()
Render a SQL string representation of thisQueryPart
.protected DataAccessException
translate(String sql, SQLException e)
Internal convenience method
-
-
-
Method Detail
-
accept
public abstract void accept(Context<?> ctx)
-
clauses
public final Clause[] clauses(Context<?> ctx)
Description copied from interface:QueryPartInternal
TheClause
s that are represented by this query part.QueryPart
s can specify severalClause
s for which an event will be emittedbefore
(in forward order) andafter
(in reverse order) visiting the the query part throughContext.visit(QueryPart)
This method is for JOOQ INTERNAL USE only. Do not reference directly
- Specified by:
clauses
in interfaceQueryPartInternal
- Returns:
- The
Clause
s represented by this query part ornull
or an empty array if this query part does not represent a clause.
-
declaresFields
public final boolean declaresFields()
Subclasses may override this- Specified by:
declaresFields
in interfaceQueryPartInternal
-
declaresTables
public final boolean declaresTables()
Subclasses may override this- Specified by:
declaresTables
in interfaceQueryPartInternal
-
and
public final Condition and(Condition other)
Description copied from interface:Condition
Combine this condition with another one using theOperator.AND
operator.
-
and
public Condition and(Field<Boolean> other)
Description copied from interface:Condition
Combine this condition with another one using theOperator.AND
operator.
-
and
public Condition and(Boolean other)
Description copied from interface:Condition
Combine this condition with another one using theOperator.AND
operator.
-
or
public final Condition or(Condition other)
Description copied from interface:Condition
Combine this condition with another one using theOperator.OR
operator.
-
or
public final Condition or(Field<Boolean> other)
Description copied from interface:Condition
Combine this condition with another one using theOperator.OR
operator.
-
or
public final Condition or(Boolean other)
Description copied from interface:Condition
Combine this condition with another one using theOperator.OR
operator.
-
and
public final Condition and(SQL sql)
Description copied from interface:Condition
Combine this condition with another one using theOperator.AND
operator.NOTE: When inserting plain SQL into jOOQ objects, you must guarantee syntax integrity. You may also create the possibility of malicious SQL injection. Be sure to properly use bind variables and/or escape literals when concatenated into SQL clauses!
- Specified by:
and
in interfaceCondition
- Parameters:
sql
- The other condition- Returns:
- The combined condition
- See Also:
DSL.condition(SQL)
,SQL
-
and
public final Condition and(String sql)
Description copied from interface:Condition
Combine this condition with another one using theOperator.AND
operator.NOTE: When inserting plain SQL into jOOQ objects, you must guarantee syntax integrity. You may also create the possibility of malicious SQL injection. Be sure to properly use bind variables and/or escape literals when concatenated into SQL clauses!
- Specified by:
and
in interfaceCondition
- Parameters:
sql
- The other condition- Returns:
- The combined condition
- See Also:
DSL.condition(String)
,SQL
-
and
public final Condition and(String sql, Object... bindings)
Description copied from interface:Condition
Combine this condition with another one using theOperator.AND
operator.NOTE: When inserting plain SQL into jOOQ objects, you must guarantee syntax integrity. You may also create the possibility of malicious SQL injection. Be sure to properly use bind variables and/or escape literals when concatenated into SQL clauses!
- Specified by:
and
in interfaceCondition
- Parameters:
sql
- The other conditionbindings
- The bindings- Returns:
- The combined condition
- See Also:
DSL.condition(String, Object...)
,DSL.sql(String, Object...)
,SQL
-
and
public final Condition and(String sql, QueryPart... parts)
Description copied from interface:Condition
Combine this condition with another one using theOperator.AND
operator.NOTE: When inserting plain SQL into jOOQ objects, you must guarantee syntax integrity. You may also create the possibility of malicious SQL injection. Be sure to properly use bind variables and/or escape literals when concatenated into SQL clauses!
- Specified by:
and
in interfaceCondition
- Parameters:
sql
- The SQL clause, containing {numbered placeholders} where query parts can be injectedparts
- TheQueryPart
objects that are rendered at the {numbered placeholder} locations- Returns:
- The combined condition
- See Also:
DSL.condition(String, QueryPart...)
,DSL.sql(String, QueryPart...)
,SQL
-
or
public final Condition or(SQL sql)
Description copied from interface:Condition
Combine this condition with another one using theOperator.OR
operator.NOTE: When inserting plain SQL into jOOQ objects, you must guarantee syntax integrity. You may also create the possibility of malicious SQL injection. Be sure to properly use bind variables and/or escape literals when concatenated into SQL clauses!
- Specified by:
or
in interfaceCondition
- Parameters:
sql
- The other condition- Returns:
- The combined condition
- See Also:
DSL.condition(SQL)
,SQL
-
or
public final Condition or(String sql)
Description copied from interface:Condition
Combine this condition with another one using theOperator.OR
operator.NOTE: When inserting plain SQL into jOOQ objects, you must guarantee syntax integrity. You may also create the possibility of malicious SQL injection. Be sure to properly use bind variables and/or escape literals when concatenated into SQL clauses!
- Specified by:
or
in interfaceCondition
- Parameters:
sql
- The other condition- Returns:
- The combined condition
- See Also:
DSL.condition(String)
,SQL
-
or
public final Condition or(String sql, Object... bindings)
Description copied from interface:Condition
Combine this condition with another one using theOperator.OR
operator.NOTE: When inserting plain SQL into jOOQ objects, you must guarantee syntax integrity. You may also create the possibility of malicious SQL injection. Be sure to properly use bind variables and/or escape literals when concatenated into SQL clauses!
- Specified by:
or
in interfaceCondition
- Parameters:
sql
- The other conditionbindings
- The bindings- Returns:
- The combined condition
- See Also:
DSL.condition(String, Object...)
,DSL.sql(String, Object...)
,SQL
-
or
public final Condition or(String sql, QueryPart... parts)
Description copied from interface:Condition
Combine this condition with another one using theOperator.OR
operator.NOTE: When inserting plain SQL into jOOQ objects, you must guarantee syntax integrity. You may also create the possibility of malicious SQL injection. Be sure to properly use bind variables and/or escape literals when concatenated into SQL clauses!
- Specified by:
or
in interfaceCondition
- Parameters:
sql
- The SQL clause, containing {numbered placeholders} where query parts can be injectedparts
- TheQueryPart
objects that are rendered at the {numbered placeholder} locations- Returns:
- The combined condition
- See Also:
DSL.condition(String, Object...)
,DSL.sql(String, QueryPart...)
,SQL
-
andNot
public final Condition andNot(Condition other)
Description copied from interface:Condition
Combine this condition with a negated other one using theOperator.AND
operator.
-
andNot
public final Condition andNot(Field<Boolean> other)
Description copied from interface:Condition
Combine this condition with a negated other one using theOperator.AND
operator.
-
andNot
public final Condition andNot(Boolean other)
Description copied from interface:Condition
Combine this condition with a negated other one using theOperator.AND
operator.
-
orNot
public final Condition orNot(Condition other)
Description copied from interface:Condition
Combine this condition with a negated other one using theOperator.OR
operator.
-
orNot
public final Condition orNot(Field<Boolean> other)
Description copied from interface:Condition
Combine this condition with a negated other one using theOperator.OR
operator.
-
orNot
public final Condition orNot(Boolean other)
Description copied from interface:Condition
Combine this condition with a negated other one using theOperator.OR
operator.
-
andExists
public final Condition andExists(Select<?> select)
Description copied from interface:Condition
Combine this condition with an EXISTS clause using theOperator.AND
operator.
-
andNotExists
public final Condition andNotExists(Select<?> select)
Description copied from interface:Condition
Combine this condition with a NOT EXIST clause using theOperator.AND
operator.- Specified by:
andNotExists
in interfaceCondition
- Parameters:
select
- The EXISTS's subquery- Returns:
- The combined condition
-
orExists
public final Condition orExists(Select<?> select)
Description copied from interface:Condition
Combine this condition with an EXISTS clause using theOperator.OR
operator.
-
orNotExists
public final Condition orNotExists(Select<?> select)
Description copied from interface:Condition
Combine this condition with a NOT EXIST clause using theOperator.OR
operator.- Specified by:
orNotExists
in interfaceCondition
- Parameters:
select
- The EXISTS's subquery- Returns:
- The combined condition
-
not
public Condition not()
Description copied from interface:Condition
Invert this conditionThis is the same as calling
DSL.not(Condition)
-
toSQL
@Deprecated public final void toSQL(RenderContext context)
Deprecated.- 3.4.0 - [#2694] - UseQueryPartInternal.accept(Context)
instead.Description copied from interface:QueryPartInternal
Render thisQueryPart
to a SQL string contained incontext.sql()
. Thecontext
will contain additional information about how to render thisQueryPart
, e.g. whether thisQueryPart
should be rendered as a declaration or reference, whether thisQueryPart
's contained bind variables should be inlined or replaced by'?'
, etc.- Specified by:
toSQL
in interfaceQueryPartInternal
-
bind
@Deprecated public final void bind(BindContext context) throws DataAccessException
Deprecated.- 3.4.0 - [#2694] - UseQueryPartInternal.accept(Context)
instead.Description copied from interface:QueryPartInternal
Bind all parameters of thisQueryPart
to a PreparedStatementThis method is for JOOQ INTERNAL USE only. Do not reference directly
- Specified by:
bind
in interfaceQueryPartInternal
- Parameters:
context
- The context holding the next bind index and other information for variable binding- Throws:
DataAccessException
- If something went wrong while binding a variable
-
rendersContent
public boolean rendersContent(Context<?> ctx)
Subclasses may override this- Specified by:
rendersContent
in interfaceQueryPartInternal
-
declaresWindows
public boolean declaresWindows()
Subclasses may override this- Specified by:
declaresWindows
in interfaceQueryPartInternal
-
declaresCTE
public boolean declaresCTE()
Subclasses may override this- Specified by:
declaresCTE
in interfaceQueryPartInternal
-
generatesCast
public boolean generatesCast()
Subclasses may override this- Specified by:
generatesCast
in interfaceQueryPartInternal
-
equals
public boolean equals(Object that)
Description copied from interface:QueryPart
Check whether thisQueryPart
can be considered equal to anotherQueryPart
.In general,
QueryPart
equality is defined in terms ofQueryPart.toString()
equality. In other words, two query parts are considered equal if their rendered SQL (with inlined bind variables) is equal. This means that the two query parts do not necessarily have to be of the same type.Some
QueryPart
implementations may choose to override this behaviour for improved performance, asQueryPart.toString()
is an expensive operation, if called many times.
-
hashCode
public int hashCode()
Description copied from interface:QueryPart
Generate a hash code from thisQueryPart
.In general,
QueryPart
hash codes are the same as the hash codes generated fromQueryPart.toString()
. This guarantees consistent behaviour withQueryPart.equals(Object)
Some
QueryPart
implementations may choose to override this behaviour for improved performance, asQueryPart.toString()
is an expensive operation, if called many times.
-
toString
public String toString()
Description copied from interface:QueryPart
Render a SQL string representation of thisQueryPart
.For improved debugging, this renders a SQL string of this
QueryPart
with inlined bind variables. If thisQueryPart
isAttachable
, then the attachedConfiguration
may be used for rendering the SQL string, includingSQLDialect
andSettings
. Do note that mostQueryPart
instances are not attached to aConfiguration
, and thus there is no guarantee that the SQL string will make sense in the context of a specific database.
-
create
@Deprecated protected final DSLContext create()
Deprecated.- 3.11.0 - [#6722] - UseAttachable.configuration()
andConfiguration.dsl()
instead.Internal convenience method
-
create
@Deprecated protected final DSLContext create(Configuration configuration)
Deprecated.- 3.11.0 - [#6722] - UseAttachable.configuration()
andConfiguration.dsl()
instead.Internal convenience method
-
create
@Deprecated protected final DSLContext create(Context<?> ctx)
Deprecated.- 3.11.0 - [#6722] - UseAttachable.configuration()
andConfiguration.dsl()
instead.Internal convenience method
-
translate
protected final DataAccessException translate(String sql, SQLException e)
Internal convenience method
-
-