Top Description Methods
org.jooq

public Interface RowN

extends Row, SelectField<Record>
Known Direct Implementers
org.jooq.impl.RowImplN
Static Imports
org.jooq.SQLDialect.*

A row value expression.

Row value expressions are mainly useful for use in predicates, when comparing several values in one go, which can be more elegant than expanding the row value expression predicate in other equivalent syntaxes. This is especially true for non-equality predicates. For instance, the following two predicates are equivalent in SQL:


(A, B) > (X, Y)
(A > X) OR (A = X AND B > Y)

Example:


// Assuming import static org.jooq.impl.DSL.*;

using(configuration)
   .select()
   .from(CUSTOMER)
   .where(row(CUSTOMER.FIRST_NAME, CUSTOMER.LAST_NAME).in(
       select(ACTOR.FIRST_NAME, ACTOR.LAST_NAME).from(ACTOR)
   ))
   .fetch();

Note

Not all databases support row value expressions, but many row value expression operations can be emulated on all databases. See relevant row value expression method Javadocs for details.

Instances can be created using DSL#row(Object...) and overloads.

Author
Lukas Eder

Method Summary

Modifier and TypeMethod and Description
public @NotNull BetweenAndStepN
between(Object... minValues)

Check if this row value expression is within a range of two other row value expressions.

public @NotNull BetweenAndStepN
between(Field<?>... minValues)

Deprecated as a consequence of Field being deprecated.
Check if this row value expression is within a range of two other row value expressions.
public @NotNull BetweenAndStepN
between(RowN minValue)

Check if this row value expression is within a range of two other row value expressions.

public @NotNull BetweenAndStepN
between(Record minValue)

Check if this row value expression is within a range of two records.

public @NotNull Condition
between(RowN minValue, RowN maxValue)

Deprecated as a consequence of Condition being deprecated.
Check if this row value expression is within a range of two other row value expressions.
public @NotNull Condition
between(Record minValue, Record maxValue)

Deprecated as a consequence of Condition being deprecated.
Check if this row value expression is within a range of two records.
public @NotNull BetweenAndStepN
betweenSymmetric(Object... minValues)

Check if this row value expression is within a symmetric range of two other row value expressions.

public @NotNull BetweenAndStepN
betweenSymmetric(Field<?>... minValues)

Deprecated as a consequence of Field being deprecated.
Check if this row value expression is within a symmetric range of two other row value expressions.
public @NotNull BetweenAndStepN
betweenSymmetric(RowN minValue)

Check if this row value expression is within a symmetric range of two other row value expressions.

public @NotNull BetweenAndStepN
betweenSymmetric(Record minValue)

Check if this row value expression is within a symmetric range of two records.

public @NotNull Condition
betweenSymmetric(RowN minValue, RowN maxValue)

Deprecated as a consequence of Condition being deprecated.
Check if this row value expression is within a symmetric range of two other row value expressions.
public @NotNull Condition
betweenSymmetric(Record minValue, Record maxValue)

Deprecated as a consequence of Condition being deprecated.
Check if this row value expression is within a symmetric range of two records.
public @NotNull Condition
compare(Comparator comparator, RowN row)

Deprecated as a consequence of Condition being deprecated.
Compare this row value expression with another row value expression using a dynamic comparator.
public @NotNull Condition
compare(Comparator comparator, Record record)

Deprecated as a consequence of Condition being deprecated.
Compare this row value expression with a record using a dynamic comparator.
public @NotNull Condition
compare(Comparator comparator, Object... values)

Deprecated as a consequence of Condition being deprecated.
Compare this row value expression with another row value expression using a dynamic comparator.
public @NotNull Condition
compare(Comparator comparator, Field<?>... values)

Deprecated as a consequence of Field and Condition being deprecated.
Compare this row value expression with another row value expression using a dynamic comparator.
public @NotNull Condition
compare(Comparator comparator, Select<? extends Record> select)

Deprecated as a consequence of Condition being deprecated.
Compare this row value expression with a subselect using a dynamic comparator.
public @NotNull Condition
compare(Comparator comparator, QuantifiedSelect<? extends Record> select)

Deprecated as a consequence of Condition being deprecated.
Compare this row value expression with a subselect using a dynamic comparator.
public @NotNull Condition
eq(RowN row)

Deprecated as a consequence of Condition being deprecated.
Compare this row value expression with another row value expression for equality.
public @NotNull Condition
eq(Record record)

Deprecated as a consequence of Condition being deprecated.
Compare this row value expression with a record for equality.
public @NotNull Condition
eq(Object... values)

Deprecated as a consequence of Condition being deprecated.
Compare this row value expression with another row value expression for equality.
public @NotNull Condition
eq(Field<?>... values)

Deprecated as a consequence of Field and Condition being deprecated.
Compare this row value expression with another row value expression for equality.
public @NotNull Condition
eq(Select<? extends Record> select)

Deprecated as a consequence of Condition being deprecated.
Compare this row value expression with a subselect for equality.
public @NotNull Condition
eq(QuantifiedSelect<? extends Record> select)

Deprecated as a consequence of Condition being deprecated.
Compare this row value expression with a subselect for equality.
public @NotNull Condition
equal(RowN row)

Deprecated as a consequence of Condition being deprecated.
Compare this row value expression with another row value expression for equality.
public @NotNull Condition
equal(Record record)

Deprecated as a consequence of Condition being deprecated.
Compare this row value expression with a record for equality.
public @NotNull Condition
equal(Object... values)

Deprecated as a consequence of Condition being deprecated.
Compare this row value expression with another row value expression for equality.
public @NotNull Condition
equal(Field<?>... values)

Deprecated as a consequence of Field and Condition being deprecated.
Compare this row value expression with another row value expression for equality.
public @NotNull Condition
equal(Select<? extends Record> select)

Deprecated as a consequence of Condition being deprecated.
Compare this row value expression with a subselect for equality.
public @NotNull Condition
equal(QuantifiedSelect<? extends Record> select)

Deprecated as a consequence of Condition being deprecated.
Compare this row value expression with a subselect for equality.
public @NotNull Condition
ge(RowN row)

Deprecated as a consequence of Condition being deprecated.
Compare this row value expression with another row value expression for order.
public @NotNull Condition
ge(Record record)

Deprecated as a consequence of Condition being deprecated.
Compare this row value expression with a record for order.
public @NotNull Condition
ge(Object... values)

Deprecated as a consequence of Condition being deprecated.
Compare this row value expression with another row value expression for order.
public @NotNull Condition
ge(Field<?>... values)

Deprecated as a consequence of Field and Condition being deprecated.
Compare this row value expression with another row value expression for order.
public @NotNull Condition
ge(Select<? extends Record> select)

Deprecated as a consequence of Condition being deprecated.
Compare this row value expression with a subselect for order.
public @NotNull Condition
ge(QuantifiedSelect<? extends Record> select)

Deprecated as a consequence of Condition being deprecated.
Compare this row value expression with a subselect for order.
public @NotNull Condition
greaterOrEqual(RowN row)

Deprecated as a consequence of Condition being deprecated.
Compare this row value expression with another row value expression for order.
public @NotNull Condition
greaterOrEqual(Record record)

Deprecated as a consequence of Condition being deprecated.
Compare this row value expression with a record for order.
public @NotNull Condition
greaterOrEqual(Object... values)

Deprecated as a consequence of Condition being deprecated.
Compare this row value expression with another row value expression for order.
public @NotNull Condition
greaterOrEqual(Field<?>... values)

Deprecated as a consequence of Field and Condition being deprecated.
Compare this row value expression with another row value expression for order.
public @NotNull Condition
greaterOrEqual(Select<? extends Record> select)

Deprecated as a consequence of Condition being deprecated.
Compare this row value expression with a subselect for order.
public @NotNull Condition
greaterOrEqual(QuantifiedSelect<? extends Record> select)

Deprecated as a consequence of Condition being deprecated.
Compare this row value expression with a subselect for order.
public @NotNull Condition
greaterThan(RowN row)

Deprecated as a consequence of Condition being deprecated.
Compare this row value expression with another row value expression for order.
public @NotNull Condition
greaterThan(Record record)

Deprecated as a consequence of Condition being deprecated.
Compare this row value expression with a record for order.
public @NotNull Condition
greaterThan(Object... values)

Deprecated as a consequence of Condition being deprecated.
Compare this row value expression with another row value expression for order.
public @NotNull Condition
greaterThan(Field<?>... values)

Deprecated as a consequence of Field and Condition being deprecated.
Compare this row value expression with another row value expression for order.
public @NotNull Condition
greaterThan(Select<? extends Record> select)

Deprecated as a consequence of Condition being deprecated.
Compare this row value expression with a subselect for order.
public @NotNull Condition
greaterThan(QuantifiedSelect<? extends Record> select)

Deprecated as a consequence of Condition being deprecated.
Compare this row value expression with a subselect for order.
public @NotNull Condition
gt(RowN row)

Deprecated as a consequence of Condition being deprecated.
Compare this row value expression with another row value expression for order.
public @NotNull Condition
gt(Record record)

Deprecated as a consequence of Condition being deprecated.
Compare this row value expression with a record for order.
public @NotNull Condition
gt(Object... values)

Deprecated as a consequence of Condition being deprecated.
Compare this row value expression with another row value expression for order.
public @NotNull Condition
gt(Field<?>... values)

Deprecated as a consequence of Field and Condition being deprecated.
Compare this row value expression with another row value expression for order.
public @NotNull Condition
gt(Select<? extends Record> select)

Deprecated as a consequence of Condition being deprecated.
Compare this row value expression with a subselect for order.
public @NotNull Condition
gt(QuantifiedSelect<? extends Record> select)

Deprecated as a consequence of Condition being deprecated.
Compare this row value expression with a subselect for order.
public @NotNull Condition
in(Collection<? extends RowN> rows)

Deprecated as a consequence of Condition being deprecated.
Compare this row value expression with a set of row value expressions for equality.
public @NotNull Condition
in(Result<? extends Record> result)

Deprecated as a consequence of Condition being deprecated.
Compare this row value expression with a set of records for equality.
public @NotNull Condition
in(RowN... rows)

Deprecated as a consequence of Condition being deprecated.
Compare this row value expression with a set of row value expressions for equality.
public @NotNull Condition
in(Record... record)

Deprecated as a consequence of Condition being deprecated.
Compare this row value expression with a set of records for equality.
public @NotNull Condition
in(Select<? extends Record> select)

Deprecated as a consequence of Condition being deprecated.
Compare this row value expression with a subselect for equality.
public @NotNull Condition
isDistinctFrom(RowN row)

Deprecated as a consequence of Condition being deprecated.
Compare this row value expression with another row value expression for distinctness.
public @NotNull Condition
isDistinctFrom(Record record)

Deprecated as a consequence of Condition being deprecated.
Compare this row value expression with another row value expression for distinctness.
public @NotNull Condition
isDistinctFrom(Object... values)

Deprecated as a consequence of Condition being deprecated.
Compare this row value expression with another row value expression for distinctness.
public @NotNull Condition
isDistinctFrom(Field<?>... values)

Deprecated as a consequence of Field and Condition being deprecated.
Compare this row value expression with another row value expression for distinctness.
public @NotNull Condition
isDistinctFrom(Select<? extends Record> select)

Deprecated as a consequence of Condition being deprecated.
Compare this row value expression with another row value expression for distinctness.
public @NotNull Condition
isNotDistinctFrom(RowN row)

Deprecated as a consequence of Condition being deprecated.
Compare this row value expression with another row value expression for distinctness.
public @NotNull Condition
isNotDistinctFrom(Record record)

Deprecated as a consequence of Condition being deprecated.
Compare this row value expression with another row value expression for distinctness.
public @NotNull Condition
isNotDistinctFrom(Object... values)

Deprecated as a consequence of Condition being deprecated.
Compare this row value expression with another row value expression for distinctness.
public @NotNull Condition
isNotDistinctFrom(Field<?>... values)

Deprecated as a consequence of Field and Condition being deprecated.
Compare this row value expression with another row value expression for distinctness.
public @NotNull Condition
isNotDistinctFrom(Select<? extends Record> select)

Deprecated as a consequence of Condition being deprecated.
Compare this row value expression with another row value expression for distinctness.
public @NotNull Condition
le(RowN row)

Deprecated as a consequence of Condition being deprecated.
Compare this row value expression with another row value expression for order.
public @NotNull Condition
le(Record record)

Deprecated as a consequence of Condition being deprecated.
Compare this row value expression with a record for order.
public @NotNull Condition
le(Object... values)

Deprecated as a consequence of Condition being deprecated.
Compare this row value expression with another row value expression for order.
public @NotNull Condition
le(Field<?>... values)

Deprecated as a consequence of Field and Condition being deprecated.
Compare this row value expression with another row value expression for order.
public @NotNull Condition
le(Select<? extends Record> select)

Deprecated as a consequence of Condition being deprecated.
Compare this row value expression with a subselect for order.
public @NotNull Condition
le(QuantifiedSelect<? extends Record> select)

Deprecated as a consequence of Condition being deprecated.
Compare this row value expression with a subselect for order.
public @NotNull Condition
lessOrEqual(RowN row)

Deprecated as a consequence of Condition being deprecated.
Compare this row value expression with another row value expression for order.
public @NotNull Condition
lessOrEqual(Record record)

Deprecated as a consequence of Condition being deprecated.
Compare this row value expression with a record for order.
public @NotNull Condition
lessOrEqual(Object... values)

Deprecated as a consequence of Condition being deprecated.
Compare this row value expression with another row value expression for order.
public @NotNull Condition
lessOrEqual(Field<?>... values)

Deprecated as a consequence of Field and Condition being deprecated.
Compare this row value expression with another row value expression for order.
public @NotNull Condition
lessOrEqual(Select<? extends Record> select)

Deprecated as a consequence of Condition being deprecated.
Compare this row value expression with a subselect for order.
public @NotNull Condition
lessOrEqual(QuantifiedSelect<? extends Record> select)

Deprecated as a consequence of Condition being deprecated.
Compare this row value expression with a subselect for order.
public @NotNull Condition
lessThan(RowN row)

Deprecated as a consequence of Condition being deprecated.
Compare this row value expression with another row value expression for order.
public @NotNull Condition
lessThan(Record record)

Deprecated as a consequence of Condition being deprecated.
Compare this row value expression with a record for order.
public @NotNull Condition
lessThan(Object... values)

Deprecated as a consequence of Condition being deprecated.
Compare this row value expression with another row value expression for order.
public @NotNull Condition
lessThan(Field<?>... values)

Deprecated as a consequence of Field and Condition being deprecated.
Compare this row value expression with another row value expression for order.
public @NotNull Condition
lessThan(Select<? extends Record> select)

Deprecated as a consequence of Condition being deprecated.
Compare this row value expression with a subselect for order.
public @NotNull Condition
lessThan(QuantifiedSelect<? extends Record> select)

Deprecated as a consequence of Condition being deprecated.
Compare this row value expression with a subselect for order.
public @NotNull Condition
lt(RowN row)

Deprecated as a consequence of Condition being deprecated.
Compare this row value expression with another row value expression for order.
public @NotNull Condition
lt(Record record)

Deprecated as a consequence of Condition being deprecated.
Compare this row value expression with a record for order.
public @NotNull Condition
lt(Object... values)

Deprecated as a consequence of Condition being deprecated.
Compare this row value expression with another row value expression for order.
public @NotNull Condition
lt(Field<?>... values)

Deprecated as a consequence of Field and Condition being deprecated.
Compare this row value expression with another row value expression for order.
public @NotNull Condition
lt(Select<? extends Record> select)

Deprecated as a consequence of Condition being deprecated.
Compare this row value expression with a subselect for order.
public @NotNull Condition
lt(QuantifiedSelect<? extends Record> select)

Deprecated as a consequence of Condition being deprecated.
Compare this row value expression with a subselect for order.
public <U> @NotNull SelectField<U>
mapping(Function<? super Object[], ? extends U> function)

A convenience method to define a local Record to custom type RecordMapper that can be used when projecting Row types in SELECT or RETURNING clauses.

public <U> @NotNull SelectField<U>
mapping(Class<U> uType, Function<? super Object[], ? extends U> function)

A convenience method to define a local Record to custom type RecordMapper that can be used when projecting Row types in SELECT or RETURNING clauses.

public @NotNull Condition
ne(RowN row)

Deprecated as a consequence of Condition being deprecated.
Compare this row value expression with another row value expression for non-equality.
public @NotNull Condition
ne(Record record)

Deprecated as a consequence of Condition being deprecated.
Compare this row value expression with a record for non-equality.
public @NotNull Condition
ne(Object... values)

Deprecated as a consequence of Condition being deprecated.
Compare this row value expression with another row value expression for non-equality.
public @NotNull Condition
ne(Field<?>... values)

Deprecated as a consequence of Field and Condition being deprecated.
Compare this row value expression with another row value expression for non-equality.
public @NotNull Condition
ne(Select<? extends Record> select)

Deprecated as a consequence of Condition being deprecated.
Compare this row value expression with a subselect for non-equality.
public @NotNull Condition
ne(QuantifiedSelect<? extends Record> select)

Deprecated as a consequence of Condition being deprecated.
Compare this row value expression with a subselect for non-equality.
public @NotNull BetweenAndStepN
notBetween(Object... minValues)

Check if this row value expression is not within a range of two other row value expressions.

public @NotNull BetweenAndStepN
notBetween(Field<?>... minValues)

Deprecated as a consequence of Field being deprecated.
Check if this row value expression is not within a range of two other row value expressions.
public @NotNull BetweenAndStepN
notBetween(RowN minValue)

Check if this row value expression is not within a range of two other row value expressions.

public @NotNull BetweenAndStepN
notBetween(Record minValue)

Check if this row value expression is within a range of two records.

public @NotNull Condition
notBetween(RowN minValue, RowN maxValue)

Deprecated as a consequence of Condition being deprecated.
Check if this row value expression is not within a range of two other row value expressions.
public @NotNull Condition
notBetween(Record minValue, Record maxValue)

Deprecated as a consequence of Condition being deprecated.
Check if this row value expression is within a range of two records.
public @NotNull BetweenAndStepN
notBetweenSymmetric(Object... minValues)

Check if this row value expression is not within a symmetric range of two other row value expressions.

public @NotNull BetweenAndStepN
notBetweenSymmetric(Field<?>... minValues)

Deprecated as a consequence of Field being deprecated.
Check if this row value expression is not within a symmetric range of two other row value expressions.
public @NotNull BetweenAndStepN
notBetweenSymmetric(RowN minValue)

Check if this row value expression is not within a symmetric range of two other row value expressions.

public @NotNull BetweenAndStepN
notBetweenSymmetric(Record minValue)

Check if this row value expression is not within a symmetric range of two records.

public @NotNull Condition
notBetweenSymmetric(RowN minValue, RowN maxValue)

Deprecated as a consequence of Condition being deprecated.
Check if this row value expression is not within a symmetric range of two other row value expressions.
public @NotNull Condition
notBetweenSymmetric(Record minValue, Record maxValue)

Deprecated as a consequence of Condition being deprecated.
Check if this row value expression is not within a symmetric range of two records.
public @NotNull Condition
notEqual(RowN row)

Deprecated as a consequence of Condition being deprecated.
Compare this row value expression with another row value expression for non-equality.
public @NotNull Condition
notEqual(Record record)

Deprecated as a consequence of Condition being deprecated.
Compare this row value expression with a record for non-equality
public @NotNull Condition
notEqual(Object... values)

Deprecated as a consequence of Condition being deprecated.
Compare this row value expression with another row value expression for.
public @NotNull Condition
notEqual(Field<?>... values)

Deprecated as a consequence of Field and Condition being deprecated.
Compare this row value expression with another row value expression for non-equality.
public @NotNull Condition
notEqual(Select<? extends Record> select)

Deprecated as a consequence of Condition being deprecated.
Compare this row value expression with a subselect for non-equality.
public @NotNull Condition
notEqual(QuantifiedSelect<? extends Record> select)

Deprecated as a consequence of Condition being deprecated.
Compare this row value expression with a subselect for non-equality.
public @NotNull Condition
notIn(Collection<? extends RowN> rows)

Deprecated as a consequence of Condition being deprecated.
Compare this row value expression with a set of row value expressions for equality.
public @NotNull Condition
notIn(Result<? extends Record> result)

Deprecated as a consequence of Condition being deprecated.
Compare this row value expression with a set of records for equality.
public @NotNull Condition
notIn(RowN... rows)

Deprecated as a consequence of Condition being deprecated.
Compare this row value expression with a set of row value expressions for equality.
public @NotNull Condition
notIn(Record... record)

Deprecated as a consequence of Condition being deprecated.
Compare this row value expression with a set of records for non-equality.
public @NotNull Condition
notIn(Select<? extends Record> select)

Deprecated as a consequence of Condition being deprecated.
Compare this row value expression with a subselect for non-equality.
Inherited from org.jooq.Row:
$fieldsisNotNullisNullsize
Inherited from org.jooq.SelectField:
asasasconvertconvertconvertconvertFromconvertFromconvertToconvertTo