/*
 * Licensed 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.
 *
 * Other licenses:
 * -----------------------------------------------------------------------------
 * Commercial licenses for this work are available. These replace the above
 * ASL 2.0 and offer limited warranties, support, maintenance, and commercial
 * database integrations.
 *
 * For more information, please visit: http://www.jooq.org/licenses
 *
 *
 *
 *
 *
 *
 *
 *
 *
 *
 *
 *
 *
 *
 *
 *
 */
package org.jooq;

import org.jetbrains.annotations.*;


import org.jooq.impl.DSL;


An intermediate (optional) type for the construction of a JOIN clause, where the join criteria is added using an ON clause (with a Condition. This type can be used as a convenience type for connecting more conditions.

Referencing XYZ*Step types directly from client code

It is usually not recommended to reference any XYZ*Step types directly from client code, or assign them to local variables. When writing dynamic SQL, creating a statement's components dynamically, and passing them to the DSL API statically is usually a better choice. See the manual's section about dynamic SQL for details: https://www.jooq.org/doc/latest/manual/sql-building/dynamic-sql.

Drawbacks of referencing the XYZ*Step types directly:

  • They're operating on mutable implementations (as of jOOQ 3.x)
  • They're less composable and not easy to get right when dynamic SQL gets complex
  • They're less readable
  • They might have binary incompatible changes between minor releases
Author:Lukas Eder
/** * An intermediate (optional) type for the construction of a <code>JOIN</code> * clause, where the join criteria is added using an <code>ON</code> clause * (with a {@link Condition}. This type can be used as a convenience type for * connecting more conditions. * <p> * <h3>Referencing <code>XYZ*Step</code> types directly from client code</h3> * <p> * It is usually not recommended to reference any <code>XYZ*Step</code> types * directly from client code, or assign them to local variables. When writing * dynamic SQL, creating a statement's components dynamically, and passing them * to the DSL API statically is usually a better choice. See the manual's * section about dynamic SQL for details: <a href= * "https://www.jooq.org/doc/latest/manual/sql-building/dynamic-sql">https://www.jooq.org/doc/latest/manual/sql-building/dynamic-sql</a>. * <p> * Drawbacks of referencing the <code>XYZ*Step</code> types directly: * <ul> * <li>They're operating on mutable implementations (as of jOOQ 3.x)</li> * <li>They're less composable and not easy to get right when dynamic SQL gets * complex</li> * <li>They're less readable</li> * <li>They might have binary incompatible changes between minor releases</li> * </ul> * * @author Lukas Eder */
public interface TableOnConditionStep<R extends Record> extends Table<R> {
Combine the currently assembled conditions with another one using the Operator.AND operator.
/** * Combine the currently assembled conditions with another one using the * {@link Operator#AND} operator. */
@NotNull @Support TableOnConditionStep<R> and(Condition condition);
Combine the currently assembled conditions with another one using the Operator.AND operator.
/** * Combine the currently assembled conditions with another one using the * {@link Operator#AND} operator. */
@NotNull @Support TableOnConditionStep<R> and(Field<Boolean> condition);
Combine the currently assembled conditions with another one using the Operator.AND operator.
Deprecated:- 3.8.0 - [#4763] - Use and(Condition) (typically with DSL.trueCondition(), DSL.falseCondition(), or DSL.noCondition() as the parameter) or and(Field) instead. Due to ambiguity between calling this method using Field.equals(Object) argument, vs. calling the other method via a Field.equal(Object) argument, this method will be removed in the future.
/** * Combine the currently assembled conditions with another one using the * {@link Operator#AND} operator. * * @deprecated - 3.8.0 - [#4763] - Use {@link #and(Condition)} (typically * with {@link DSL#trueCondition()}, * {@link DSL#falseCondition()}, or {@link DSL#noCondition()} as * the parameter) or {@link #and(Field)} instead. Due to * ambiguity between calling this method using * {@link Field#equals(Object)} argument, vs. calling the other * method via a {@link Field#equal(Object)} argument, this * method will be removed in the future. */
@Deprecated @NotNull @Support TableOnConditionStep<R> and(Boolean condition);
Combine the currently assembled conditions with another one using the Operator.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!

See Also:
/** * Combine the currently assembled conditions with another one using the * {@link Operator#AND} operator. * <p> * <b>NOTE</b>: 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! * * @see DSL#condition(SQL) * @see SQL */
@NotNull @Support @PlainSQL TableOnConditionStep<R> and(SQL sql);
Combine the currently assembled conditions with another one using the Operator.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!

See Also:
/** * Combine the currently assembled conditions with another one using the * {@link Operator#AND} operator. * <p> * <b>NOTE</b>: 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! * * @see DSL#condition(String) * @see SQL */
@NotNull @Support @PlainSQL TableOnConditionStep<R> and(String sql);
Combine the currently assembled conditions with another one using the Operator.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!

See Also:
/** * Combine the currently assembled conditions with another one using the * {@link Operator#AND} operator. * <p> * <b>NOTE</b>: 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! * * @see DSL#condition(String, Object...) * @see DSL#sql(String, Object...) * @see SQL */
@NotNull @Support @PlainSQL TableOnConditionStep<R> and(String sql, Object... bindings);
Combine the currently assembled conditions with another one using the Operator.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!

See Also:
/** * Combine the currently assembled conditions with another one using the * {@link Operator#AND} operator. * <p> * <b>NOTE</b>: 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! * * @see DSL#condition(String, QueryPart...) * @see DSL#sql(String, QueryPart...) * @see SQL */
@NotNull @Support @PlainSQL TableOnConditionStep<R> and(String sql, QueryPart... parts);
Combine the currently assembled conditions with a negated other one using the Operator.AND operator.
/** * Combine the currently assembled conditions with a negated other one using * the {@link Operator#AND} operator. */
@NotNull @Support TableOnConditionStep<R> andNot(Condition condition);
Combine the currently assembled conditions with a negated other one using the Operator.AND operator.
/** * Combine the currently assembled conditions with a negated other one using * the {@link Operator#AND} operator. */
@NotNull @Support TableOnConditionStep<R> andNot(Field<Boolean> condition);
Combine the currently assembled conditions with a negated other one using the Operator.AND operator.
Deprecated:- 3.8.0 - [#4763] - Use andNot(Condition) (typically with DSL.trueCondition(), DSL.falseCondition(), or DSL.noCondition() as the parameter) or andNot(Field) instead. Due to ambiguity between calling this method using Field.equals(Object) argument, vs. calling the other method via a Field.equal(Object) argument, this method will be removed in the future.
/** * Combine the currently assembled conditions with a negated other one using * the {@link Operator#AND} operator. * * @deprecated - 3.8.0 - [#4763] - Use {@link #andNot(Condition)} (typically * with {@link DSL#trueCondition()}, * {@link DSL#falseCondition()}, or {@link DSL#noCondition()} as * the parameter) or {@link #andNot(Field)} instead. Due to * ambiguity between calling this method using * {@link Field#equals(Object)} argument, vs. calling the other * method via a {@link Field#equal(Object)} argument, this * method will be removed in the future. */
@Deprecated @NotNull @Support TableOnConditionStep<R> andNot(Boolean condition);
Combine the currently assembled conditions with an EXISTS clause using the Operator.AND operator.
/** * Combine the currently assembled conditions with an <code>EXISTS</code> * clause using the {@link Operator#AND} operator. */
@NotNull @Support TableOnConditionStep<R> andExists(Select<?> select);
Combine the currently assembled conditions with a NOT EXISTS clause using the Operator.AND operator.
/** * Combine the currently assembled conditions with a <code>NOT EXISTS</code> * clause using the {@link Operator#AND} operator. */
@NotNull @Support TableOnConditionStep<R> andNotExists(Select<?> select);
Combine the currently assembled conditions with another one using the Operator.OR operator.
/** * Combine the currently assembled conditions with another one using the * {@link Operator#OR} operator. */
@NotNull @Support TableOnConditionStep<R> or(Condition condition);
Combine the currently assembled conditions with another one using the Operator.OR operator.
/** * Combine the currently assembled conditions with another one using the * {@link Operator#OR} operator. */
@NotNull @Support TableOnConditionStep<R> or(Field<Boolean> condition);
Combine the currently assembled conditions with another one using the Operator.OR operator.
Deprecated:- 3.8.0 - [#4763] - Use or(Condition) (typically with DSL.trueCondition(), DSL.falseCondition(), or DSL.noCondition() as the parameter) or or(Field) instead. Due to ambiguity between calling this method using Field.equals(Object) argument, vs. calling the other method via a Field.equal(Object) argument, this method will be removed in the future.
/** * Combine the currently assembled conditions with another one using the * {@link Operator#OR} operator. * * @deprecated - 3.8.0 - [#4763] - Use {@link #or(Condition)} (typically * with {@link DSL#trueCondition()}, * {@link DSL#falseCondition()}, or {@link DSL#noCondition()} as * the parameter) or {@link #or(Field)} instead. Due to * ambiguity between calling this method using * {@link Field#equals(Object)} argument, vs. calling the other * method via a {@link Field#equal(Object)} argument, this * method will be removed in the future. */
@Deprecated @NotNull @Support TableOnConditionStep<R> or(Boolean condition);
Combine the currently assembled conditions with another one using the Operator.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!

See Also:
/** * Combine the currently assembled conditions with another one using the * {@link Operator#OR} operator. * <p> * <b>NOTE</b>: 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! * * @see DSL#condition(SQL) * @see SQL */
@NotNull @Support @PlainSQL TableOnConditionStep<R> or(SQL sql);
Combine the currently assembled conditions with another one using the Operator.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!

See Also:
/** * Combine the currently assembled conditions with another one using the * {@link Operator#OR} operator. * <p> * <b>NOTE</b>: 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! * * @see DSL#condition(String) * @see SQL */
@NotNull @Support @PlainSQL TableOnConditionStep<R> or(String sql);
Combine the currently assembled conditions with another one using the Operator.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!

See Also:
/** * Combine the currently assembled conditions with another one using the * {@link Operator#OR} operator. * <p> * <b>NOTE</b>: 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! * * @see DSL#condition(String, Object...) * @see DSL#sql(String, Object...) * @see SQL */
@NotNull @Support @PlainSQL TableOnConditionStep<R> or(String sql, Object... bindings);
Combine the currently assembled conditions with another one using the Operator.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!

See Also:
/** * Combine the currently assembled conditions with another one using the * {@link Operator#OR} operator. * <p> * <b>NOTE</b>: 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! * * @see DSL#condition(String, QueryPart...) * @see DSL#sql(String, QueryPart...) * @see SQL */
@NotNull @Support @PlainSQL TableOnConditionStep<R> or(String sql, QueryPart... parts);
Combine the currently assembled conditions with a negated other one using the Operator.OR operator.
/** * Combine the currently assembled conditions with a negated other one using * the {@link Operator#OR} operator. */
@NotNull @Support TableOnConditionStep<R> orNot(Condition condition);
Combine the currently assembled conditions with a negated other one using the Operator.OR operator.
/** * Combine the currently assembled conditions with a negated other one using * the {@link Operator#OR} operator. */
@NotNull @Support TableOnConditionStep<R> orNot(Field<Boolean> condition);
Combine the currently assembled conditions with a negated other one using the Operator.OR operator.
Deprecated:- 3.8.0 - [#4763] - Use orNot(Condition) (typically with DSL.trueCondition(), DSL.falseCondition(), or DSL.noCondition() as the parameter) or orNot(Field) instead. Due to ambiguity between calling this method using Field.equals(Object) argument, vs. calling the other method via a Field.equal(Object) argument, this method will be removed in the future.
/** * Combine the currently assembled conditions with a negated other one using * the {@link Operator#OR} operator. * * @deprecated - 3.8.0 - [#4763] - Use {@link #orNot(Condition)} (typically * with {@link DSL#trueCondition()}, * {@link DSL#falseCondition()}, or {@link DSL#noCondition()} as * the parameter) or {@link #orNot(Field)} instead. Due to * ambiguity between calling this method using * {@link Field#equals(Object)} argument, vs. calling the other * method via a {@link Field#equal(Object)} argument, this * method will be removed in the future. */
@Deprecated @NotNull @Support TableOnConditionStep<R> orNot(Boolean condition);
Combine the currently assembled conditions with an EXISTS clause using the Operator.OR operator.
/** * Combine the currently assembled conditions with an <code>EXISTS</code> * clause using the {@link Operator#OR} operator. */
@NotNull @Support TableOnConditionStep<R> orExists(Select<?> select);
Combine the currently assembled conditions with a NOT EXISTS clause using the Operator.OR operator.
/** * Combine the currently assembled conditions with a <code>NOT EXISTS</code> * clause using the {@link Operator#OR} operator. */
@NotNull @Support TableOnConditionStep<R> orNotExists(Select<?> select); }