Module org.jooq

Package org.jooq

Interface MergeOnStep<R extends Record>

public interface MergeOnStep<R extends Record>

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

Method Summary

Modifier and Type	Method	Description
MergeOnConditionStep<R>	on(Boolean condition)	Deprecated. - 3.8.0 - [#4763] - Use on(Condition) (typically with DSL.trueCondition(), DSL.falseCondition(), or DSL.noCondition() as the parameter) or on(Field) instead.
MergeOnConditionStep<R>	on(String sql)	Provide join conditions and proceed to the next step
MergeOnConditionStep<R>	on(String sql, Object... bindings)	Provide join conditions and proceed to the next step
MergeOnConditionStep<R>	on(String sql, QueryPart... parts)	Provide join conditions and proceed to the next step
MergeOnConditionStep<R>	on(Condition condition)	Provide join conditions and proceed to the next step, connecting them with each other with Operator.AND.
MergeOnConditionStep<R>	on(Condition... conditions)	Provide join conditions and proceed to the next step, connecting them with each other with Operator.AND.
MergeOnConditionStep<R>	on(Field<Boolean> condition)	Provide join conditions and proceed to the next step
MergeOnConditionStep<R>	on(SQL sql)	Provide join conditions and proceed to the next step

Method Detail

on

@Support({CUBRID,DB2,DERBY,FIREBIRD_3_0,H2,HSQLDB,ORACLE,SQLSERVER,SYBASE,TERADATA,VERTICA})
MergeOnConditionStep<R> on(Condition condition)

Provide join conditions and proceed to the next step, connecting them with each other with Operator.AND.

on

@Support({CUBRID,DB2,DERBY,FIREBIRD_3_0,H2,HSQLDB,ORACLE,SQLSERVER,SYBASE,TERADATA,VERTICA})
MergeOnConditionStep<R> on(Condition... conditions)

Provide join conditions and proceed to the next step, connecting them with each other with Operator.AND.

on

@Support({CUBRID,DB2,DERBY,FIREBIRD_3_0,H2,HSQLDB,ORACLE,SQLSERVER,SYBASE,TERADATA,VERTICA})
MergeOnConditionStep<R> on(Field<Boolean> condition)

Provide join conditions and proceed to the next step

on

@Deprecated
@Support({CUBRID,DB2,DERBY,FIREBIRD_3_0,H2,HSQLDB,ORACLE,SQLSERVER,SYBASE,TERADATA,VERTICA})
MergeOnConditionStep<R> on(Boolean condition)

Deprecated.

- 3.8.0 - [#4763] - Use on(Condition) (typically with DSL.trueCondition(), DSL.falseCondition(), or DSL.noCondition() as the parameter) or on(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.

Provide join conditions and proceed to the next step

on

@Support({CUBRID,DB2,DERBY,FIREBIRD_3_0,H2,HSQLDB,ORACLE,SQLSERVER,SYBASE,TERADATA,VERTICA})
@PlainSQL
MergeOnConditionStep<R> on(SQL sql)

Provide join conditions and proceed to the next step

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:

DSL.condition(SQL), SQL

on

@Support({CUBRID,DB2,DERBY,FIREBIRD_3_0,H2,HSQLDB,ORACLE,SQLSERVER,SYBASE,TERADATA,VERTICA})
@PlainSQL
MergeOnConditionStep<R> on(String sql)

Provide join conditions and proceed to the next step

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:

DSL.condition(String), SQL

on

@Support({CUBRID,DB2,DERBY,FIREBIRD_3_0,H2,HSQLDB,ORACLE,SQLSERVER,SYBASE,TERADATA,VERTICA})
@PlainSQL
MergeOnConditionStep<R> on(String sql,
                           Object... bindings)

Provide join conditions and proceed to the next step

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:

DSL.condition(String, Object...), DSL.sql(String, Object...), SQL

on

@Support({CUBRID,DB2,DERBY,FIREBIRD_3_0,H2,HSQLDB,ORACLE,SQLSERVER,SYBASE,TERADATA,VERTICA})
@PlainSQL
MergeOnConditionStep<R> on(String sql,
                           QueryPart... parts)

Provide join conditions and proceed to the next step

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:

DSL.condition(String, QueryPart...), DSL.sql(String, QueryPart...), SQL