-
- All Known Subinterfaces:
SelectJoinPartitionByStep<R>
,SelectOptionalOnStep<R>
public interface SelectOnStep<R extends Record>
This type is used for theSelect
's DSL API when selecting genericRecord
types.Example:
Its equivalent in jOOQ-- get all authors' first and last names, and the number -- of books they've written in German, if they have written -- more than five books in German in the last three years -- (from 2011), and sort those authors by last names -- limiting results to the second and third row SELECT T_AUTHOR.FIRST_NAME, T_AUTHOR.LAST_NAME, COUNT(*) FROM T_AUTHOR JOIN T_BOOK ON T_AUTHOR.ID = T_BOOK.AUTHOR_ID WHERE T_BOOK.LANGUAGE = 'DE' AND T_BOOK.PUBLISHED > '2008-01-01' GROUP BY T_AUTHOR.FIRST_NAME, T_AUTHOR.LAST_NAME HAVING COUNT(*) > 5 ORDER BY T_AUTHOR.LAST_NAME ASC NULLS FIRST LIMIT 2 OFFSET 1 FOR UPDATE OF FIRST_NAME, LAST_NAME NO WAIT
Refer to the manual for more detailscreate.select(TAuthor.FIRST_NAME, TAuthor.LAST_NAME, create.count()) .from(T_AUTHOR) .join(T_BOOK).on(TBook.AUTHOR_ID.equal(TAuthor.ID)) .where(TBook.LANGUAGE.equal("DE")) .and(TBook.PUBLISHED.greaterThan(parseDate('2008-01-01'))) .groupBy(TAuthor.FIRST_NAME, TAuthor.LAST_NAME) .having(create.count().greaterThan(5)) .orderBy(TAuthor.LAST_NAME.asc().nullsFirst()) .limit(2) .offset(1) .forUpdate() .of(TAuthor.FIRST_NAME, TAuthor.LAST_NAME) .noWait();
Referencing
XYZ*Step
types directly from client codeIt 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
All Methods Instance Methods Abstract Methods Deprecated Methods Modifier and Type Method Description @NotNull SelectOnConditionStep<R>
on(Boolean condition)
Deprecated.- 3.8.0 - [#4763] - Useon(Condition)
(typically withDSL.trueCondition()
,DSL.falseCondition()
, orDSL.noCondition()
as the parameter) oron(Field)
instead.@NotNull SelectOnConditionStep<R>
on(String sql)
Add anON
clause to the previousJOIN
.@NotNull SelectOnConditionStep<R>
on(String sql, Object... bindings)
Add anON
clause to the previousJOIN
.@NotNull SelectOnConditionStep<R>
on(String sql, QueryPart... parts)
Add anON
clause to the previousJOIN
.@NotNull SelectOnConditionStep<R>
on(Condition condition)
@NotNull SelectOnConditionStep<R>
on(Condition... conditions)
@NotNull SelectOnConditionStep<R>
on(Field<Boolean> condition)
Add anON
clause to the previousJOIN
.@NotNull SelectOnConditionStep<R>
on(SQL sql)
Add anON
clause to the previousJOIN
.@NotNull SelectJoinStep<R>
onKey()
Join the previous table on a non-ambiguous foreign key relationship between the two joined tables.@NotNull SelectJoinStep<R>
onKey(ForeignKey<?,?> key)
Join the table on a non-ambiguous foreign key relationship between the two joined tables.@NotNull SelectJoinStep<R>
onKey(TableField<?,?>... keyFields)
Join the previous table on a non-ambiguous foreign key relationship between the two joined tables.@NotNull SelectJoinStep<R>
using(Collection<? extends Field<?>> fields)
Join the previous table with theUSING(column [, column...])
syntax.@NotNull SelectJoinStep<R>
using(Field<?>... fields)
Join the previous table with theUSING(column [, column...])
syntax.
-
-
-
Method Detail
-
on
@NotNull @Support @NotNull SelectOnConditionStep<R> on(Condition condition)
-
on
@NotNull @Support @NotNull SelectOnConditionStep<R> on(Condition... conditions)
-
on
@NotNull @Support @NotNull SelectOnConditionStep<R> on(Field<Boolean> condition)
Add anON
clause to the previousJOIN
.
-
on
@Deprecated @NotNull @Support @NotNull SelectOnConditionStep<R> on(Boolean condition)
Deprecated.- 3.8.0 - [#4763] - Useon(Condition)
(typically withDSL.trueCondition()
,DSL.falseCondition()
, orDSL.noCondition()
as the parameter) oron(Field)
instead. Due to ambiguity between calling this method usingField.equals(Object)
argument, vs. calling the other method via aField.equal(Object)
argument, this method will be removed in the future.Add anON
clause to the previousJOIN
.
-
on
@NotNull @Support @PlainSQL @NotNull SelectOnConditionStep<R> on(SQL sql)
Add anON
clause to the previousJOIN
.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
@NotNull @Support @PlainSQL @NotNull SelectOnConditionStep<R> on(String sql)
Add anON
clause to the previousJOIN
.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
@NotNull @Support @PlainSQL @NotNull SelectOnConditionStep<R> on(String sql, Object... bindings)
Add anON
clause to the previousJOIN
.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!
-
on
@NotNull @Support @PlainSQL @NotNull SelectOnConditionStep<R> on(String sql, QueryPart... parts)
Add anON
clause to the previousJOIN
.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!
-
onKey
@NotNull @Support @NotNull SelectJoinStep<R> onKey() throws DataAccessException
Join the previous table on a non-ambiguous foreign key relationship between the two joined tables.See
TableOnStep.onKey(ForeignKey)
for examples.- Throws:
DataAccessException
- If there is no non-ambiguous key definition known to jOOQ- See Also:
TableOnStep.onKey(ForeignKey)
-
onKey
@NotNull @Support @NotNull SelectJoinStep<R> onKey(TableField<?,?>... keyFields) throws DataAccessException
Join the previous table on a non-ambiguous foreign key relationship between the two joined tables.See
TableOnStep.onKey(ForeignKey)
for examples.- Throws:
DataAccessException
- If there is no non-ambiguous key definition known to jOOQ- See Also:
TableOnStep.onKey(ForeignKey)
-
onKey
@NotNull @Support @NotNull SelectJoinStep<R> onKey(ForeignKey<?,?> key)
Join the table on a non-ambiguous foreign key relationship between the two joined tables.See
TableOnStep.onKey(ForeignKey)
for examples.- See Also:
TableOnStep.onKey(ForeignKey)
-
using
@NotNull @Support @NotNull SelectJoinStep<R> using(Field<?>... fields)
Join the previous table with theUSING(column [, column...])
syntax.If this is not supported by your RDBMS, then jOOQ will try to emulate this behaviour using the information provided in this query.
-
using
@NotNull @Support @NotNull SelectJoinStep<R> using(Collection<? extends Field<?>> fields)
Join the previous table with theUSING(column [, column...])
syntax.If this is not supported by your RDBMS, then jOOQ will try to emulate this behaviour using the information provided in this query.
-
-