/*
 * 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 static org.jooq.SQLDialect.CUBRID;
import static org.jooq.SQLDialect.DERBY;
import static org.jooq.SQLDialect.H2;
// ...

import org.jooq.impl.DSL;

This type is used for the Merge's DSL API.

Example:

DSLContext create = DSL.using(configuration);
create.mergeInto(table)
      .using(select)
      .on(condition)
      .whenMatchedThenUpdate()
      .set(field1, value1)
      .set(field2, value2)
      .whenNotMatchedThenInsert(field1, field2)
      .values(value1, value2)
      .execute();

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
/** * This type is used for the {@link Merge}'s DSL API. * <p> * Example: <code><pre> * DSLContext create = DSL.using(configuration); * * create.mergeInto(table) * .using(select) * .on(condition) * .whenMatchedThenUpdate() * .set(field1, value1) * .set(field2, value2) * .whenNotMatchedThenInsert(field1, field2) * .values(value1, value2) * .execute(); * </pre></code> * <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 MergeNotMatchedWhereStep<R extends Record> extends MergeFinalStep<R> {
Add an additional WHERE clause to the preceding WHEN NOT MATCHED THEN INSERT clause.

See http://docs.oracle.com/cd/B19306_01/server.102/b14200/statements_9016. htm for a full definition of the Oracle MERGE statement

/** * Add an additional <code>WHERE</code> clause to the preceding * <code>WHEN NOT MATCHED THEN INSERT</code> clause. * <p> * See <a href= * "http://docs.oracle.com/cd/B19306_01/server.102/b14200/statements_9016.htm" * >http://docs.oracle.com/cd/B19306_01/server.102/b14200/statements_9016. * htm</a> for a full definition of the Oracle <code>MERGE</code> statement */
@NotNull @Support({ CUBRID, DERBY, H2 }) MergeFinalStep<R> where(Condition condition);
Add an additional WHERE clause to the preceding WHEN NOT MATCHED THEN INSERT clause.

See http://docs.oracle.com/cd/B19306_01/server.102/b14200/statements_9016. htm for a full definition of the Oracle MERGE statement

/** * Add an additional <code>WHERE</code> clause to the preceding * <code>WHEN NOT MATCHED THEN INSERT</code> clause. * <p> * See <a href= * "http://docs.oracle.com/cd/B19306_01/server.102/b14200/statements_9016.htm" * >http://docs.oracle.com/cd/B19306_01/server.102/b14200/statements_9016. * htm</a> for a full definition of the Oracle <code>MERGE</code> statement */
@NotNull @Support({ CUBRID, DERBY, H2 }) MergeFinalStep<R> where(Field<Boolean> condition);
Add an additional WHERE clause to the preceding WHEN NOT MATCHED THEN INSERT clause.

See http://docs.oracle.com/cd/B19306_01/server.102/b14200/statements_9016. htm for a full definition of the Oracle MERGE statement

Deprecated:- 3.8.0 - [#4763] - Use where(Condition) (typically with DSL.trueCondition(), DSL.falseCondition(), or DSL.noCondition() as the parameter) or where(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.
/** * Add an additional <code>WHERE</code> clause to the preceding * <code>WHEN NOT MATCHED THEN INSERT</code> clause. * <p> * See <a href= * "http://docs.oracle.com/cd/B19306_01/server.102/b14200/statements_9016.htm" * >http://docs.oracle.com/cd/B19306_01/server.102/b14200/statements_9016. * htm</a> for a full definition of the Oracle <code>MERGE</code> statement * * @deprecated - 3.8.0 - [#4763] - Use {@link #where(Condition)} (typically * with {@link DSL#trueCondition()}, * {@link DSL#falseCondition()}, or {@link DSL#noCondition()} as * the parameter) or {@link #where(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({ CUBRID, DERBY, H2 }) MergeFinalStep<R> where(Boolean condition); }