From db80b8e516ea4f34547f5a33b48e094549f075f3 Mon Sep 17 00:00:00 2001 From: Lukas Eder Date: Thu, 6 Feb 2025 13:26:43 +0100 Subject: [PATCH] [jOOQ/jOOQ#17966] Add more Javadoc related to reference vs declaration to relevant API, such as Field::as and Table::as --- .../main/java/org/jooq/DerivedColumnList.java | 30 ++ .../java/org/jooq/DerivedColumnList1.java | 30 ++ .../java/org/jooq/DerivedColumnList10.java | 30 ++ .../java/org/jooq/DerivedColumnList11.java | 30 ++ .../java/org/jooq/DerivedColumnList12.java | 30 ++ .../java/org/jooq/DerivedColumnList13.java | 30 ++ .../java/org/jooq/DerivedColumnList14.java | 30 ++ .../java/org/jooq/DerivedColumnList15.java | 30 ++ .../java/org/jooq/DerivedColumnList16.java | 30 ++ .../java/org/jooq/DerivedColumnList17.java | 30 ++ .../java/org/jooq/DerivedColumnList18.java | 30 ++ .../java/org/jooq/DerivedColumnList19.java | 30 ++ .../java/org/jooq/DerivedColumnList2.java | 30 ++ .../java/org/jooq/DerivedColumnList20.java | 30 ++ .../java/org/jooq/DerivedColumnList21.java | 30 ++ .../java/org/jooq/DerivedColumnList22.java | 30 ++ .../java/org/jooq/DerivedColumnList3.java | 30 ++ .../java/org/jooq/DerivedColumnList4.java | 30 ++ .../java/org/jooq/DerivedColumnList5.java | 30 ++ .../java/org/jooq/DerivedColumnList6.java | 30 ++ .../java/org/jooq/DerivedColumnList7.java | 30 ++ .../java/org/jooq/DerivedColumnList8.java | 30 ++ .../java/org/jooq/DerivedColumnList9.java | 30 ++ jOOQ/src/main/java/org/jooq/FieldLike.java | 1 + jOOQ/src/main/java/org/jooq/Name.java | 52 ++++ jOOQ/src/main/java/org/jooq/SelectField.java | 59 +++- jOOQ/src/main/java/org/jooq/Table.java | 276 ++++++++++++++---- jOOQ/src/main/java/org/jooq/WithAsStep1.java | 30 ++ jOOQ/src/main/java/org/jooq/WithAsStep10.java | 30 ++ jOOQ/src/main/java/org/jooq/WithAsStep11.java | 30 ++ jOOQ/src/main/java/org/jooq/WithAsStep12.java | 30 ++ jOOQ/src/main/java/org/jooq/WithAsStep13.java | 30 ++ jOOQ/src/main/java/org/jooq/WithAsStep14.java | 30 ++ jOOQ/src/main/java/org/jooq/WithAsStep15.java | 30 ++ jOOQ/src/main/java/org/jooq/WithAsStep16.java | 30 ++ jOOQ/src/main/java/org/jooq/WithAsStep17.java | 30 ++ jOOQ/src/main/java/org/jooq/WithAsStep18.java | 30 ++ jOOQ/src/main/java/org/jooq/WithAsStep19.java | 30 ++ jOOQ/src/main/java/org/jooq/WithAsStep2.java | 30 ++ jOOQ/src/main/java/org/jooq/WithAsStep20.java | 30 ++ jOOQ/src/main/java/org/jooq/WithAsStep21.java | 30 ++ jOOQ/src/main/java/org/jooq/WithAsStep22.java | 30 ++ jOOQ/src/main/java/org/jooq/WithAsStep3.java | 30 ++ jOOQ/src/main/java/org/jooq/WithAsStep4.java | 30 ++ jOOQ/src/main/java/org/jooq/WithAsStep5.java | 30 ++ jOOQ/src/main/java/org/jooq/WithAsStep6.java | 30 ++ jOOQ/src/main/java/org/jooq/WithAsStep7.java | 30 ++ jOOQ/src/main/java/org/jooq/WithAsStep8.java | 30 ++ jOOQ/src/main/java/org/jooq/WithAsStep9.java | 30 ++ jOOQ/src/main/java/org/jooq/impl/DSL.java | 67 +++++ 50 files changed, 1747 insertions(+), 58 deletions(-) diff --git a/jOOQ/src/main/java/org/jooq/DerivedColumnList.java b/jOOQ/src/main/java/org/jooq/DerivedColumnList.java index a27a2c04ad..4601773184 100644 --- a/jOOQ/src/main/java/org/jooq/DerivedColumnList.java +++ b/jOOQ/src/main/java/org/jooq/DerivedColumnList.java @@ -94,6 +94,16 @@ public interface DerivedColumnList extends QueryPart { /** * Specify a subselect to refer to by the DerivedColumnList to * form a common table expression. + *

+ * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

*/ @NotNull @Support({ FIREBIRD, H2, HSQLDB, MARIADB, MYSQL, POSTGRES, SQLITE, YUGABYTEDB }) @@ -106,6 +116,16 @@ public interface DerivedColumnList extends QueryPart { * This adds the PostgreSQL 12 MATERIALIZED hint to the common * table expression definition, or silently ignores it, if the hint is not * supported. + *

+ * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

*/ @NotNull @Support({ FIREBIRD, H2, HSQLDB, MARIADB, MYSQL, POSTGRES, SQLITE, YUGABYTEDB }) @@ -118,6 +138,16 @@ public interface DerivedColumnList extends QueryPart { * This adds the PostgreSQL 12 NOT MATERIALIZED hint to the * common table expression definition, or silently ignores it, if the hint * is not supported. + *

+ * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

*/ @NotNull @Support({ FIREBIRD, H2, HSQLDB, MARIADB, MYSQL, POSTGRES, SQLITE, YUGABYTEDB }) diff --git a/jOOQ/src/main/java/org/jooq/DerivedColumnList1.java b/jOOQ/src/main/java/org/jooq/DerivedColumnList1.java index 8da6616e09..afc2a0ce58 100644 --- a/jOOQ/src/main/java/org/jooq/DerivedColumnList1.java +++ b/jOOQ/src/main/java/org/jooq/DerivedColumnList1.java @@ -71,6 +71,16 @@ public interface DerivedColumnList1 extends QueryPart { /** * Specify a subselect to refer to by the DerivedColumnList to * form a common table expression. + *

+ * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

*/ @NotNull @Support @@ -83,6 +93,16 @@ public interface DerivedColumnList1 extends QueryPart { * This adds the PostgreSQL 12 MATERIALIZED hint to the common * table expression definition, or silently ignores it, if the hint is not * supported. + *

+ * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

*/ @NotNull @Support @@ -95,6 +115,16 @@ public interface DerivedColumnList1 extends QueryPart { * This adds the PostgreSQL 12 NOT MATERIALIZED hint to the * common table expression definition, or silently ignores it, if the hint * is not supported. + *

+ * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

*/ @NotNull @Support diff --git a/jOOQ/src/main/java/org/jooq/DerivedColumnList10.java b/jOOQ/src/main/java/org/jooq/DerivedColumnList10.java index e1cf41397c..dbc638db22 100644 --- a/jOOQ/src/main/java/org/jooq/DerivedColumnList10.java +++ b/jOOQ/src/main/java/org/jooq/DerivedColumnList10.java @@ -71,6 +71,16 @@ public interface DerivedColumnList10 extends QueryPart { /** * Specify a subselect to refer to by the DerivedColumnList to * form a common table expression. + *

+ * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

*/ @NotNull @Support @@ -83,6 +93,16 @@ public interface DerivedColumnList10 extends QueryPart { * This adds the PostgreSQL 12 MATERIALIZED hint to the common * table expression definition, or silently ignores it, if the hint is not * supported. + *

+ * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

*/ @NotNull @Support @@ -95,6 +115,16 @@ public interface DerivedColumnList10 extends QueryPart { * This adds the PostgreSQL 12 NOT MATERIALIZED hint to the * common table expression definition, or silently ignores it, if the hint * is not supported. + *

+ * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

*/ @NotNull @Support diff --git a/jOOQ/src/main/java/org/jooq/DerivedColumnList11.java b/jOOQ/src/main/java/org/jooq/DerivedColumnList11.java index 0670ebf6e3..4eea106ec0 100644 --- a/jOOQ/src/main/java/org/jooq/DerivedColumnList11.java +++ b/jOOQ/src/main/java/org/jooq/DerivedColumnList11.java @@ -71,6 +71,16 @@ public interface DerivedColumnList11 extends QueryPart { /** * Specify a subselect to refer to by the DerivedColumnList to * form a common table expression. + *

+ * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

*/ @NotNull @Support @@ -83,6 +93,16 @@ public interface DerivedColumnList11 extends QueryPart { * This adds the PostgreSQL 12 MATERIALIZED hint to the common * table expression definition, or silently ignores it, if the hint is not * supported. + *

+ * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

*/ @NotNull @Support @@ -95,6 +115,16 @@ public interface DerivedColumnList11 extends QueryPart { * This adds the PostgreSQL 12 NOT MATERIALIZED hint to the * common table expression definition, or silently ignores it, if the hint * is not supported. + *

+ * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

*/ @NotNull @Support diff --git a/jOOQ/src/main/java/org/jooq/DerivedColumnList12.java b/jOOQ/src/main/java/org/jooq/DerivedColumnList12.java index 989762953d..785f33dc57 100644 --- a/jOOQ/src/main/java/org/jooq/DerivedColumnList12.java +++ b/jOOQ/src/main/java/org/jooq/DerivedColumnList12.java @@ -71,6 +71,16 @@ public interface DerivedColumnList12 extends QueryPart { /** * Specify a subselect to refer to by the DerivedColumnList to * form a common table expression. + *

+ * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

*/ @NotNull @Support @@ -83,6 +93,16 @@ public interface DerivedColumnList12 extends QueryPart { * This adds the PostgreSQL 12 MATERIALIZED hint to the common * table expression definition, or silently ignores it, if the hint is not * supported. + *

+ * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

*/ @NotNull @Support @@ -95,6 +115,16 @@ public interface DerivedColumnList12 extends QueryPart { * This adds the PostgreSQL 12 NOT MATERIALIZED hint to the * common table expression definition, or silently ignores it, if the hint * is not supported. + *

+ * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

*/ @NotNull @Support diff --git a/jOOQ/src/main/java/org/jooq/DerivedColumnList13.java b/jOOQ/src/main/java/org/jooq/DerivedColumnList13.java index fddd1fb372..6963c55e3b 100644 --- a/jOOQ/src/main/java/org/jooq/DerivedColumnList13.java +++ b/jOOQ/src/main/java/org/jooq/DerivedColumnList13.java @@ -71,6 +71,16 @@ public interface DerivedColumnList13 extends QueryPart { /** * Specify a subselect to refer to by the DerivedColumnList to * form a common table expression. + *

+ * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

*/ @NotNull @Support @@ -83,6 +93,16 @@ public interface DerivedColumnList13 extends QueryPart { * This adds the PostgreSQL 12 MATERIALIZED hint to the common * table expression definition, or silently ignores it, if the hint is not * supported. + *

+ * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

*/ @NotNull @Support @@ -95,6 +115,16 @@ public interface DerivedColumnList13 extends QueryPart { * This adds the PostgreSQL 12 NOT MATERIALIZED hint to the * common table expression definition, or silently ignores it, if the hint * is not supported. + *

+ * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

*/ @NotNull @Support diff --git a/jOOQ/src/main/java/org/jooq/DerivedColumnList14.java b/jOOQ/src/main/java/org/jooq/DerivedColumnList14.java index b9a3fa7aaa..186e4a8d4c 100644 --- a/jOOQ/src/main/java/org/jooq/DerivedColumnList14.java +++ b/jOOQ/src/main/java/org/jooq/DerivedColumnList14.java @@ -71,6 +71,16 @@ public interface DerivedColumnList14 extends QueryPart { /** * Specify a subselect to refer to by the DerivedColumnList to * form a common table expression. + *

+ * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

*/ @NotNull @Support @@ -83,6 +93,16 @@ public interface DerivedColumnList14 extends QueryPart { * This adds the PostgreSQL 12 MATERIALIZED hint to the common * table expression definition, or silently ignores it, if the hint is not * supported. + *

+ * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

*/ @NotNull @Support @@ -95,6 +115,16 @@ public interface DerivedColumnList14 extends QueryPart { * This adds the PostgreSQL 12 NOT MATERIALIZED hint to the * common table expression definition, or silently ignores it, if the hint * is not supported. + *

+ * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

*/ @NotNull @Support diff --git a/jOOQ/src/main/java/org/jooq/DerivedColumnList15.java b/jOOQ/src/main/java/org/jooq/DerivedColumnList15.java index f64e2bb273..0b1c787e2b 100644 --- a/jOOQ/src/main/java/org/jooq/DerivedColumnList15.java +++ b/jOOQ/src/main/java/org/jooq/DerivedColumnList15.java @@ -71,6 +71,16 @@ public interface DerivedColumnList15 extends QueryPart { /** * Specify a subselect to refer to by the DerivedColumnList to * form a common table expression. + *

+ * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

*/ @NotNull @Support @@ -83,6 +93,16 @@ public interface DerivedColumnList15 extends QueryPart { * This adds the PostgreSQL 12 MATERIALIZED hint to the common * table expression definition, or silently ignores it, if the hint is not * supported. + *

+ * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

*/ @NotNull @Support @@ -95,6 +115,16 @@ public interface DerivedColumnList15 extends QueryPart { * This adds the PostgreSQL 12 NOT MATERIALIZED hint to the * common table expression definition, or silently ignores it, if the hint * is not supported. + *

+ * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

*/ @NotNull @Support diff --git a/jOOQ/src/main/java/org/jooq/DerivedColumnList16.java b/jOOQ/src/main/java/org/jooq/DerivedColumnList16.java index 9bfba8dcf0..60d24426d7 100644 --- a/jOOQ/src/main/java/org/jooq/DerivedColumnList16.java +++ b/jOOQ/src/main/java/org/jooq/DerivedColumnList16.java @@ -71,6 +71,16 @@ public interface DerivedColumnList16 extends QueryPart { /** * Specify a subselect to refer to by the DerivedColumnList to * form a common table expression. + *

+ * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

*/ @NotNull @Support @@ -83,6 +93,16 @@ public interface DerivedColumnList16 extends QueryPart { * This adds the PostgreSQL 12 MATERIALIZED hint to the common * table expression definition, or silently ignores it, if the hint is not * supported. + *

+ * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

*/ @NotNull @Support @@ -95,6 +115,16 @@ public interface DerivedColumnList16 extends QueryPart { * This adds the PostgreSQL 12 NOT MATERIALIZED hint to the * common table expression definition, or silently ignores it, if the hint * is not supported. + *

+ * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

*/ @NotNull @Support diff --git a/jOOQ/src/main/java/org/jooq/DerivedColumnList17.java b/jOOQ/src/main/java/org/jooq/DerivedColumnList17.java index 275152dd78..3d54d94af3 100644 --- a/jOOQ/src/main/java/org/jooq/DerivedColumnList17.java +++ b/jOOQ/src/main/java/org/jooq/DerivedColumnList17.java @@ -71,6 +71,16 @@ public interface DerivedColumnList17 extends QueryPart { /** * Specify a subselect to refer to by the DerivedColumnList to * form a common table expression. + *

+ * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

*/ @NotNull @Support @@ -83,6 +93,16 @@ public interface DerivedColumnList17 extends QueryPart { * This adds the PostgreSQL 12 MATERIALIZED hint to the common * table expression definition, or silently ignores it, if the hint is not * supported. + *

+ * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

*/ @NotNull @Support @@ -95,6 +115,16 @@ public interface DerivedColumnList17 extends QueryPart { * This adds the PostgreSQL 12 NOT MATERIALIZED hint to the * common table expression definition, or silently ignores it, if the hint * is not supported. + *

+ * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

*/ @NotNull @Support diff --git a/jOOQ/src/main/java/org/jooq/DerivedColumnList18.java b/jOOQ/src/main/java/org/jooq/DerivedColumnList18.java index 27ee9b4792..e0117201bf 100644 --- a/jOOQ/src/main/java/org/jooq/DerivedColumnList18.java +++ b/jOOQ/src/main/java/org/jooq/DerivedColumnList18.java @@ -71,6 +71,16 @@ public interface DerivedColumnList18 extends QueryPart { /** * Specify a subselect to refer to by the DerivedColumnList to * form a common table expression. + *

+ * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

*/ @NotNull @Support @@ -83,6 +93,16 @@ public interface DerivedColumnList18 extends QueryPart { * This adds the PostgreSQL 12 MATERIALIZED hint to the common * table expression definition, or silently ignores it, if the hint is not * supported. + *

+ * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

*/ @NotNull @Support @@ -95,6 +115,16 @@ public interface DerivedColumnList18 extends QueryPart { * This adds the PostgreSQL 12 NOT MATERIALIZED hint to the * common table expression definition, or silently ignores it, if the hint * is not supported. + *

+ * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

*/ @NotNull @Support diff --git a/jOOQ/src/main/java/org/jooq/DerivedColumnList19.java b/jOOQ/src/main/java/org/jooq/DerivedColumnList19.java index 7ebebf6118..28fdaa26e5 100644 --- a/jOOQ/src/main/java/org/jooq/DerivedColumnList19.java +++ b/jOOQ/src/main/java/org/jooq/DerivedColumnList19.java @@ -71,6 +71,16 @@ public interface DerivedColumnList19 extends QueryPart { /** * Specify a subselect to refer to by the DerivedColumnList to * form a common table expression. + *

+ * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

*/ @NotNull @Support @@ -83,6 +93,16 @@ public interface DerivedColumnList19 extends QueryPart { * This adds the PostgreSQL 12 MATERIALIZED hint to the common * table expression definition, or silently ignores it, if the hint is not * supported. + *

+ * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

*/ @NotNull @Support @@ -95,6 +115,16 @@ public interface DerivedColumnList19 extends QueryPart { * This adds the PostgreSQL 12 NOT MATERIALIZED hint to the * common table expression definition, or silently ignores it, if the hint * is not supported. + *

+ * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

*/ @NotNull @Support diff --git a/jOOQ/src/main/java/org/jooq/DerivedColumnList2.java b/jOOQ/src/main/java/org/jooq/DerivedColumnList2.java index 4c04104971..a2bbbda843 100644 --- a/jOOQ/src/main/java/org/jooq/DerivedColumnList2.java +++ b/jOOQ/src/main/java/org/jooq/DerivedColumnList2.java @@ -71,6 +71,16 @@ public interface DerivedColumnList2 extends QueryPart { /** * Specify a subselect to refer to by the DerivedColumnList to * form a common table expression. + *

+ * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

*/ @NotNull @Support @@ -83,6 +93,16 @@ public interface DerivedColumnList2 extends QueryPart { * This adds the PostgreSQL 12 MATERIALIZED hint to the common * table expression definition, or silently ignores it, if the hint is not * supported. + *

+ * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

*/ @NotNull @Support @@ -95,6 +115,16 @@ public interface DerivedColumnList2 extends QueryPart { * This adds the PostgreSQL 12 NOT MATERIALIZED hint to the * common table expression definition, or silently ignores it, if the hint * is not supported. + *

+ * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

*/ @NotNull @Support diff --git a/jOOQ/src/main/java/org/jooq/DerivedColumnList20.java b/jOOQ/src/main/java/org/jooq/DerivedColumnList20.java index 497d07ec8d..20c62f75c3 100644 --- a/jOOQ/src/main/java/org/jooq/DerivedColumnList20.java +++ b/jOOQ/src/main/java/org/jooq/DerivedColumnList20.java @@ -71,6 +71,16 @@ public interface DerivedColumnList20 extends QueryPart { /** * Specify a subselect to refer to by the DerivedColumnList to * form a common table expression. + *

+ * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

*/ @NotNull @Support @@ -83,6 +93,16 @@ public interface DerivedColumnList20 extends QueryPart { * This adds the PostgreSQL 12 MATERIALIZED hint to the common * table expression definition, or silently ignores it, if the hint is not * supported. + *

+ * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

*/ @NotNull @Support @@ -95,6 +115,16 @@ public interface DerivedColumnList20 extends QueryPart { * This adds the PostgreSQL 12 NOT MATERIALIZED hint to the * common table expression definition, or silently ignores it, if the hint * is not supported. + *

+ * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

*/ @NotNull @Support diff --git a/jOOQ/src/main/java/org/jooq/DerivedColumnList21.java b/jOOQ/src/main/java/org/jooq/DerivedColumnList21.java index b08dc564e7..c59284b0df 100644 --- a/jOOQ/src/main/java/org/jooq/DerivedColumnList21.java +++ b/jOOQ/src/main/java/org/jooq/DerivedColumnList21.java @@ -71,6 +71,16 @@ public interface DerivedColumnList21 extends QueryPart { /** * Specify a subselect to refer to by the DerivedColumnList to * form a common table expression. + *

+ * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

*/ @NotNull @Support @@ -83,6 +93,16 @@ public interface DerivedColumnList21 extends QueryPart { * This adds the PostgreSQL 12 MATERIALIZED hint to the common * table expression definition, or silently ignores it, if the hint is not * supported. + *

+ * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

*/ @NotNull @Support @@ -95,6 +115,16 @@ public interface DerivedColumnList21 extends QueryPart { * This adds the PostgreSQL 12 NOT MATERIALIZED hint to the * common table expression definition, or silently ignores it, if the hint * is not supported. + *

+ * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

*/ @NotNull @Support diff --git a/jOOQ/src/main/java/org/jooq/DerivedColumnList22.java b/jOOQ/src/main/java/org/jooq/DerivedColumnList22.java index d71e287606..046c2dea29 100644 --- a/jOOQ/src/main/java/org/jooq/DerivedColumnList22.java +++ b/jOOQ/src/main/java/org/jooq/DerivedColumnList22.java @@ -71,6 +71,16 @@ public interface DerivedColumnList22 extends QueryPart { /** * Specify a subselect to refer to by the DerivedColumnList to * form a common table expression. + *

+ * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

*/ @NotNull @Support @@ -83,6 +93,16 @@ public interface DerivedColumnList22 extends QueryPart { * This adds the PostgreSQL 12 MATERIALIZED hint to the common * table expression definition, or silently ignores it, if the hint is not * supported. + *

+ * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

*/ @NotNull @Support @@ -95,6 +115,16 @@ public interface DerivedColumnList22 extends QueryPart { * This adds the PostgreSQL 12 NOT MATERIALIZED hint to the * common table expression definition, or silently ignores it, if the hint * is not supported. + *

+ * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

*/ @NotNull @Support diff --git a/jOOQ/src/main/java/org/jooq/DerivedColumnList3.java b/jOOQ/src/main/java/org/jooq/DerivedColumnList3.java index f81ca30d07..c143c8ace9 100644 --- a/jOOQ/src/main/java/org/jooq/DerivedColumnList3.java +++ b/jOOQ/src/main/java/org/jooq/DerivedColumnList3.java @@ -71,6 +71,16 @@ public interface DerivedColumnList3 extends QueryPart { /** * Specify a subselect to refer to by the DerivedColumnList to * form a common table expression. + *

+ * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

*/ @NotNull @Support @@ -83,6 +93,16 @@ public interface DerivedColumnList3 extends QueryPart { * This adds the PostgreSQL 12 MATERIALIZED hint to the common * table expression definition, or silently ignores it, if the hint is not * supported. + *

+ * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

*/ @NotNull @Support @@ -95,6 +115,16 @@ public interface DerivedColumnList3 extends QueryPart { * This adds the PostgreSQL 12 NOT MATERIALIZED hint to the * common table expression definition, or silently ignores it, if the hint * is not supported. + *

+ * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

*/ @NotNull @Support diff --git a/jOOQ/src/main/java/org/jooq/DerivedColumnList4.java b/jOOQ/src/main/java/org/jooq/DerivedColumnList4.java index 277e4f7d02..53b8510498 100644 --- a/jOOQ/src/main/java/org/jooq/DerivedColumnList4.java +++ b/jOOQ/src/main/java/org/jooq/DerivedColumnList4.java @@ -71,6 +71,16 @@ public interface DerivedColumnList4 extends QueryPart { /** * Specify a subselect to refer to by the DerivedColumnList to * form a common table expression. + *

+ * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

*/ @NotNull @Support @@ -83,6 +93,16 @@ public interface DerivedColumnList4 extends QueryPart { * This adds the PostgreSQL 12 MATERIALIZED hint to the common * table expression definition, or silently ignores it, if the hint is not * supported. + *

+ * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

*/ @NotNull @Support @@ -95,6 +115,16 @@ public interface DerivedColumnList4 extends QueryPart { * This adds the PostgreSQL 12 NOT MATERIALIZED hint to the * common table expression definition, or silently ignores it, if the hint * is not supported. + *

+ * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

*/ @NotNull @Support diff --git a/jOOQ/src/main/java/org/jooq/DerivedColumnList5.java b/jOOQ/src/main/java/org/jooq/DerivedColumnList5.java index 58d712820d..be8712c6a8 100644 --- a/jOOQ/src/main/java/org/jooq/DerivedColumnList5.java +++ b/jOOQ/src/main/java/org/jooq/DerivedColumnList5.java @@ -71,6 +71,16 @@ public interface DerivedColumnList5 extends QueryPart { /** * Specify a subselect to refer to by the DerivedColumnList to * form a common table expression. + *

+ * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

*/ @NotNull @Support @@ -83,6 +93,16 @@ public interface DerivedColumnList5 extends QueryPart { * This adds the PostgreSQL 12 MATERIALIZED hint to the common * table expression definition, or silently ignores it, if the hint is not * supported. + *

+ * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

*/ @NotNull @Support @@ -95,6 +115,16 @@ public interface DerivedColumnList5 extends QueryPart { * This adds the PostgreSQL 12 NOT MATERIALIZED hint to the * common table expression definition, or silently ignores it, if the hint * is not supported. + *

+ * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

*/ @NotNull @Support diff --git a/jOOQ/src/main/java/org/jooq/DerivedColumnList6.java b/jOOQ/src/main/java/org/jooq/DerivedColumnList6.java index 471c2c3d00..0e36f60d76 100644 --- a/jOOQ/src/main/java/org/jooq/DerivedColumnList6.java +++ b/jOOQ/src/main/java/org/jooq/DerivedColumnList6.java @@ -71,6 +71,16 @@ public interface DerivedColumnList6 extends QueryPart { /** * Specify a subselect to refer to by the DerivedColumnList to * form a common table expression. + *

+ * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

*/ @NotNull @Support @@ -83,6 +93,16 @@ public interface DerivedColumnList6 extends QueryPart { * This adds the PostgreSQL 12 MATERIALIZED hint to the common * table expression definition, or silently ignores it, if the hint is not * supported. + *

+ * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

*/ @NotNull @Support @@ -95,6 +115,16 @@ public interface DerivedColumnList6 extends QueryPart { * This adds the PostgreSQL 12 NOT MATERIALIZED hint to the * common table expression definition, or silently ignores it, if the hint * is not supported. + *

+ * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

*/ @NotNull @Support diff --git a/jOOQ/src/main/java/org/jooq/DerivedColumnList7.java b/jOOQ/src/main/java/org/jooq/DerivedColumnList7.java index 4159b4ecb6..5b86c0920a 100644 --- a/jOOQ/src/main/java/org/jooq/DerivedColumnList7.java +++ b/jOOQ/src/main/java/org/jooq/DerivedColumnList7.java @@ -71,6 +71,16 @@ public interface DerivedColumnList7 extends QueryPart { /** * Specify a subselect to refer to by the DerivedColumnList to * form a common table expression. + *

+ * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

*/ @NotNull @Support @@ -83,6 +93,16 @@ public interface DerivedColumnList7 extends QueryPart { * This adds the PostgreSQL 12 MATERIALIZED hint to the common * table expression definition, or silently ignores it, if the hint is not * supported. + *

+ * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

*/ @NotNull @Support @@ -95,6 +115,16 @@ public interface DerivedColumnList7 extends QueryPart { * This adds the PostgreSQL 12 NOT MATERIALIZED hint to the * common table expression definition, or silently ignores it, if the hint * is not supported. + *

+ * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

*/ @NotNull @Support diff --git a/jOOQ/src/main/java/org/jooq/DerivedColumnList8.java b/jOOQ/src/main/java/org/jooq/DerivedColumnList8.java index 821b7d536b..1efa504825 100644 --- a/jOOQ/src/main/java/org/jooq/DerivedColumnList8.java +++ b/jOOQ/src/main/java/org/jooq/DerivedColumnList8.java @@ -71,6 +71,16 @@ public interface DerivedColumnList8 extends QueryPart { /** * Specify a subselect to refer to by the DerivedColumnList to * form a common table expression. + *

+ * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

*/ @NotNull @Support @@ -83,6 +93,16 @@ public interface DerivedColumnList8 extends QueryPart { * This adds the PostgreSQL 12 MATERIALIZED hint to the common * table expression definition, or silently ignores it, if the hint is not * supported. + *

+ * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

*/ @NotNull @Support @@ -95,6 +115,16 @@ public interface DerivedColumnList8 extends QueryPart { * This adds the PostgreSQL 12 NOT MATERIALIZED hint to the * common table expression definition, or silently ignores it, if the hint * is not supported. + *

+ * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

*/ @NotNull @Support diff --git a/jOOQ/src/main/java/org/jooq/DerivedColumnList9.java b/jOOQ/src/main/java/org/jooq/DerivedColumnList9.java index 448c46cecd..c4b67f951d 100644 --- a/jOOQ/src/main/java/org/jooq/DerivedColumnList9.java +++ b/jOOQ/src/main/java/org/jooq/DerivedColumnList9.java @@ -71,6 +71,16 @@ public interface DerivedColumnList9 extends QueryPart { /** * Specify a subselect to refer to by the DerivedColumnList to * form a common table expression. + *

+ * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

*/ @NotNull @Support @@ -83,6 +93,16 @@ public interface DerivedColumnList9 extends QueryPart { * This adds the PostgreSQL 12 MATERIALIZED hint to the common * table expression definition, or silently ignores it, if the hint is not * supported. + *

+ * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

*/ @NotNull @Support @@ -95,6 +115,16 @@ public interface DerivedColumnList9 extends QueryPart { * This adds the PostgreSQL 12 NOT MATERIALIZED hint to the * common table expression definition, or silently ignores it, if the hint * is not supported. + *

+ * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

*/ @NotNull @Support diff --git a/jOOQ/src/main/java/org/jooq/FieldLike.java b/jOOQ/src/main/java/org/jooq/FieldLike.java index 4f6f977cd4..56164b6c5a 100644 --- a/jOOQ/src/main/java/org/jooq/FieldLike.java +++ b/jOOQ/src/main/java/org/jooq/FieldLike.java @@ -74,6 +74,7 @@ public interface FieldLike { * quoted, and thus case-sensitive in many SQL dialects! * * @return This result provider as a Field<?> object + * @see SelectField#as(String) */ @NotNull Field asField(String alias); diff --git a/jOOQ/src/main/java/org/jooq/Name.java b/jOOQ/src/main/java/org/jooq/Name.java index 462b0797b8..751cb4ffdf 100644 --- a/jOOQ/src/main/java/org/jooq/Name.java +++ b/jOOQ/src/main/java/org/jooq/Name.java @@ -75,6 +75,8 @@ import java.util.function.Function; import org.jooq.conf.RenderQuotedNames; import org.jooq.conf.Settings; import org.jooq.impl.DSL; +import org.jooq.impl.QOM; +import org.jooq.impl.QOM.TableAlias; import org.jetbrains.annotations.NotNull; import org.jetbrains.annotations.Nullable; @@ -242,6 +244,16 @@ public interface Name extends QueryPart, Comparable { /** * Create an empty {@link WindowDefinition} from this name. + *

+ * A window definition renders itself differently, depending on + * {@link Context#declareWindows()}. There are two rendering modes: + *

    + *
  • Declaration: The window definition renders its window name + * (this) along with the AS (window specification) + * clause. This typically happens in WINDOW clauses.
    • + *
  • Reference: The window definition renders its alias identifier. This + * happens everywhere else.
    • + *
* * @see #as(WindowSpecification) */ @@ -259,6 +271,16 @@ public interface Name extends QueryPart, Comparable { *
  • referenced from the OVER clause (see * {@link AggregateFunction#over(WindowDefinition)}
    • * + *

    + * A window definition renders itself differently, depending on + * {@link Context#declareWindows()}. There are two rendering modes: + *

      + *
    • Declaration: The window definition renders its window name + * (this) along with the AS (window specification) + * clause. This typically happens in WINDOW clauses.
      • + *
    • Reference: The window definition renders its alias identifier. This + * happens everywhere else.
      • + *
    */ @NotNull @Support({ CLICKHOUSE, CUBRID, DUCKDB, FIREBIRD, H2, MARIADB, MYSQL, POSTGRES, SQLITE, TRINO, YUGABYTEDB }) @@ -270,6 +292,16 @@ public interface Name extends QueryPart, Comparable { *

    * Column names are implicitly inherited from the SELECT * statement. + *

    + * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

      + *
    • Declaration: The common table expression renders its CTE name + * (this) along with the AS (query) clause. This + * typically happens in WITH clauses.
      • + *
    • Reference: The common table expression renders its alias identifier. + * This happens everywhere else.
      • + *
    */ @NotNull @Support @@ -285,6 +317,16 @@ public interface Name extends QueryPart, Comparable { *

    * Column names are implicitly inherited from the SELECT * statement. + *

    + * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

      + *
    • Declaration: The common table expression renders its CTE name + * (this) along with the AS (query) clause. This + * typically happens in WITH clauses.
      • + *
    • Reference: The common table expression renders its alias identifier. + * This happens everywhere else.
      • + *
    */ @NotNull @Support @@ -300,6 +342,16 @@ public interface Name extends QueryPart, Comparable { *

    * Column names are implicitly inherited from the SELECT * statement. + *

    + * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

      + *
    • Declaration: The common table expression renders its CTE name + * (this) along with the AS (query) clause. This + * typically happens in WITH clauses.
      • + *
    • Reference: The common table expression renders its alias identifier. + * This happens everywhere else.
      • + *
    */ @NotNull @Support diff --git a/jOOQ/src/main/java/org/jooq/SelectField.java b/jOOQ/src/main/java/org/jooq/SelectField.java index 9bfab26fc7..28003c536c 100644 --- a/jOOQ/src/main/java/org/jooq/SelectField.java +++ b/jOOQ/src/main/java/org/jooq/SelectField.java @@ -41,6 +41,8 @@ import java.util.function.Function; import org.jooq.conf.Settings; import org.jooq.impl.DSL; +import org.jooq.impl.QOM; +import org.jooq.impl.QOM.FieldAlias; import org.jetbrains.annotations.NotNull; @@ -61,6 +63,23 @@ public interface SelectField extends SelectFieldOrAsterisk, Named, Typed { /** * Create an alias for this field. *

    + * A field alias renders itself differently, depending on + * {@link Context#declareFields()}. There are two rendering modes: + *

      + *
    • Declaration: The field alias renders its aliased expression + * (this) along with the AS alias clause. This + * typically happens in SELECT and RETURNING + * clauses.
      • + *
    • Reference: The field alias renders its alias identifier. This happens + * everywhere else.
      • + *
    + *

    + * There is no rendering mode that reproduces the aliased expression + * as there is no way to formally decide when that mode would be more + * appropriate than the referencing of the alias! If the aliased + * expression is the preferred output, it can be extracted from the + * {@link QOM} API via {@link FieldAlias#$aliased()}. + *

    * Note that the case-sensitivity of the returned field depends on * {@link Settings#getRenderQuotedNames()}. By default, field aliases are * quoted, and thus case-sensitive in many SQL dialects! @@ -75,15 +94,30 @@ public interface SelectField extends SelectFieldOrAsterisk, Named, Typed { /** * Create an alias for this field. *

    + * A field alias renders itself differently, depending on + * {@link Context#declareFields()}. There are two rendering modes: + *

      + *
    • Declaration: The field alias renders its aliased expression + * (this) along with the AS alias clause. This + * typically happens in SELECT and RETURNING + * clauses.
      • + *
    • Reference: The field alias renders its alias identifier. This happens + * everywhere else.
      • + *
    + *

    + * There is no rendering mode that reproduces the aliased expression + * as there is no way to formally decide when that mode would be more + * appropriate than the referencing of the alias! If the aliased + * expression is the preferred output, it can be extracted from the + * {@link QOM} API via {@link FieldAlias#$aliased()}. + *

    * Note that the case-sensitivity of the returned field depends on * {@link Settings#getRenderQuotedNames()} and the {@link Name}. By default, * field aliases are quoted, and thus case-sensitive in many SQL dialects - * use {@link DSL#unquotedName(String...)} for case-insensitive aliases. - *

    - * If the argument {@link Name#getName()} is qualified, then the - * {@link Name#last()} part will be used. * - * @param alias The alias name + * @param alias The alias name. If {@link Name#getName()} is qualified, then + * the {@link Name#last()} part will be used. * @return The field alias */ @NotNull @@ -92,6 +126,23 @@ public interface SelectField extends SelectFieldOrAsterisk, Named, Typed { /** * Create an alias for this field based on another field's name. + *

    + * A field alias renders itself differently, depending on + * {@link Context#declareFields()}. There are two rendering modes: + *

      + *
    • Declaration: The field alias renders its aliased expression + * (this) along with the AS alias clause. This + * typically happens in SELECT and RETURNING + * clauses.
      • + *
    • Reference: The field alias renders its alias identifier. This happens + * everywhere else.
      • + *
    + *

    + * There is no rendering mode that reproduces the aliased expression + * as there is no way to formally decide when that mode would be more + * appropriate than the referencing of the alias! If the aliased + * expression is the preferred output, it can be extracted from the + * {@link QOM} API via {@link FieldAlias#$aliased()}. * * @param otherField The other field whose name this field is aliased with. * @return The field alias. diff --git a/jOOQ/src/main/java/org/jooq/Table.java b/jOOQ/src/main/java/org/jooq/Table.java index 0988482a00..bfce6480a1 100644 --- a/jOOQ/src/main/java/org/jooq/Table.java +++ b/jOOQ/src/main/java/org/jooq/Table.java @@ -92,7 +92,9 @@ import java.util.function.Function; import org.jooq.TableOptions.TableType; import org.jooq.conf.Settings; import org.jooq.impl.DSL; +import org.jooq.impl.QOM; import org.jooq.impl.QOM.JoinHint; +import org.jooq.impl.QOM.TableAlias; import org.jetbrains.annotations.NotNull; import org.jetbrains.annotations.Nullable; @@ -396,15 +398,32 @@ extends /** * Create an alias for this table. *

    - * Note that the case-sensitivity of the returned table depends on - * {@link Settings#getRenderQuotedNames()}. By default, table aliases are - * quoted, and thus case-sensitive in many SQL dialects! - *

    * This method works both to alias the table as well as alias the table in * its {@link SelectField} form via the {@link SelectField#as(String)} * override. In order to alias only the projected table expression, use * {@link DSL#field(SelectField)} to wrap this table into a {@link Field} * first. + *

    + * A table alias renders itself differently, depending on + * {@link Context#declareTables()}. There are two rendering modes: + *

      + *
    • Declaration: The table alias renders its aliased expression + * (this) along with the AS alias clause. This + * typically happens in FROM and INTO + * clauses.
      • + *
    • Reference: The table alias renders its alias identifier. This happens + * everywhere else.
      • + *
    + *

    + * There is no rendering mode that reproduces the aliased expression + * as there is no way to formally decide when that mode would be more + * appropriate than the referencing of the alias! If the aliased + * expression is the preferred output, it can be extracted from the + * {@link QOM} API via {@link TableAlias#$aliased()}. + *

    + * Note that the case-sensitivity of the returned table depends on + * {@link Settings#getRenderQuotedNames()}. By default, table aliases are + * quoted, and thus case-sensitive in many SQL dialects! * * @param alias The alias name * @return The table alias @@ -417,10 +436,6 @@ extends /** * Create an alias for this table and its fields. *

    - * Note that the case-sensitivity of the returned table and columns depends - * on {@link Settings#getRenderQuotedNames()}. By default, table aliases are - * quoted, and thus case-sensitive in many SQL dialects! - *

    *

    Derived column lists for table references
    *

    * Note, not all databases support derived column lists for their table @@ -458,6 +473,27 @@ extends * SELECT 1, 2 FROM DUAL * ) t * + *

    + * A table alias renders itself differently, depending on + * {@link Context#declareTables()}. There are two rendering modes: + *

      + *
    • Declaration: The table alias renders its aliased expression + * (this) along with the AS alias clause. This + * typically happens in FROM and INTO + * clauses.
      • + *
    • Reference: The table alias renders its alias identifier. This happens + * everywhere else.
      • + *
    + *

    + * There is no rendering mode that reproduces the aliased expression + * as there is no way to formally decide when that mode would be more + * appropriate than the referencing of the alias! If the aliased + * expression is the preferred output, it can be extracted from the + * {@link QOM} API via {@link TableAlias#$aliased()}. + *

    + * Note that the case-sensitivity of the returned table and columns depends + * on {@link Settings#getRenderQuotedNames()}. By default, table aliases are + * quoted, and thus case-sensitive in many SQL dialects! * * @param alias The alias name * @param fieldAliases The field aliases. Excess aliases are ignored, @@ -472,10 +508,6 @@ extends /** * Create an alias for this table and its fields. *

    - * Note that the case-sensitivity of the returned table and columns depends - * on {@link Settings#getRenderQuotedNames()}. By default, table aliases are - * quoted, and thus case-sensitive in many SQL dialects! - *

    *

    Derived column lists for table references
    *

    * Note, not all databases support derived column lists for their table @@ -513,6 +545,27 @@ extends * SELECT 1, 2 FROM DUAL * ) t * + *

    + * A table alias renders itself differently, depending on + * {@link Context#declareTables()}. There are two rendering modes: + *

      + *
    • Declaration: The table alias renders its aliased expression + * (this) along with the AS alias clause. This + * typically happens in FROM and INTO + * clauses.
      • + *
    • Reference: The table alias renders its alias identifier. This happens + * everywhere else.
      • + *
    + *

    + * There is no rendering mode that reproduces the aliased expression + * as there is no way to formally decide when that mode would be more + * appropriate than the referencing of the alias! If the aliased + * expression is the preferred output, it can be extracted from the + * {@link QOM} API via {@link TableAlias#$aliased()}. + *

    + * Note that the case-sensitivity of the returned table and columns depends + * on {@link Settings#getRenderQuotedNames()}. By default, table aliases are + * quoted, and thus case-sensitive in many SQL dialects! * * @param alias The alias name * @param fieldAliases The field aliases. Excess aliases are ignored, @@ -577,20 +630,35 @@ extends /** * Create an alias for this table. *

    - * Note that the case-sensitivity of the returned table depends on - * {@link Settings#getRenderQuotedNames()} and the {@link Name}. By default, - * table aliases are quoted, and thus case-sensitive in many SQL dialects - - * use {@link DSL#unquotedName(String...)} for case-insensitive aliases. - *

    - * If the argument {@link Name#getName()} is qualified, then the - * {@link Name#last()} part will be used. - *

    * This method works both to alias the table as well as alias the table in * its {@link SelectField} form via the {@link SelectField#as(String)} * override. In order to alias only the projected table expression, use * {@link DSL#field(SelectField)} to wrap this table into a {@link Field} + *

    + * A table alias renders itself differently, depending on + * {@link Context#declareTables()}. There are two rendering modes: + *

      + *
    • Declaration: The table alias renders its aliased expression + * (this) along with the AS alias clause. This + * typically happens in FROM and INTO + * clauses.
      • + *
    • Reference: The table alias renders its alias identifier. This happens + * everywhere else.
      • + *
    + *

    + * There is no rendering mode that reproduces the aliased expression + * as there is no way to formally decide when that mode would be more + * appropriate than the referencing of the alias! If the aliased + * expression is the preferred output, it can be extracted from the + * {@link QOM} API via {@link TableAlias#$aliased()}. + *

    + * Note that the case-sensitivity of the returned table depends on + * {@link Settings#getRenderQuotedNames()} and the {@link Name}. By default, + * table aliases are quoted, and thus case-sensitive in many SQL dialects - + * use {@link DSL#unquotedName(String...)} for case-insensitive aliases. * - * @param alias The alias name + * @param alias The alias name. If {@link Name#getName()} is qualified, then + * the {@link Name#last()} part will be used. * @return The table alias */ @Override @@ -601,21 +669,16 @@ extends /** * Create an alias for this table and its fields. *

    - * Note that the case-sensitivity of the returned table depends on - * {@link Settings#getRenderQuotedNames()} and the {@link Name}. By default, - * table aliases are quoted, and thus case-sensitive in many SQL dialects - - * use {@link DSL#unquotedName(String...)} for case-insensitive aliases. - *

    - * If the argument {@link Name#getName()} is qualified, then the - * {@link Name#last()} part will be used. - *

    *

    Derived column lists for table references
    *

    * Note, not all databases support derived column lists for their table * aliases. On the other hand, some databases do support derived column * lists, but only for derived tables. jOOQ will try to turn table * references into derived tables to make this syntax work. In other words, - * the following statements are equivalent: 

    
+     * the following statements are equivalent:
+     *
+     * 
    +     * 
      * -- Using derived column lists to rename columns (e.g. Postgres)
      * SELECT t.a, t.b
      * FROM my_table t(a, b)
@@ -625,13 +688,17 @@ extends
      * FROM (
      *   SELECT * FROM my_table
      * ) t(a, b)
-     * 
    
+     *     
+     *
    *

    *

    Derived column lists for derived tables
    *

    * Other databases may not support derived column lists at all, but they do * support common table expressions. The following statements are - * equivalent: 

    
+     * equivalent:
+     *
+     * 
    +     * 
      * -- Using derived column lists to rename columns (e.g. Postgres)
      * SELECT t.a, t.b
      * FROM (
@@ -645,12 +712,37 @@ extends
      *   UNION ALL
      *   SELECT 1, 2 FROM DUAL
      * ) t
-     * 
    
+     *     
+     *
    + *

    + * A table alias renders itself differently, depending on + * {@link Context#declareTables()}. There are two rendering modes: + *

      + *
    • Declaration: The table alias renders its aliased expression + * (this) along with the AS alias clause. This + * typically happens in FROM and INTO + * clauses.
      • + *
    • Reference: The table alias renders its alias identifier. This happens + * everywhere else.
      • + *
    + *

    + * There is no rendering mode that reproduces the aliased expression + * as there is no way to formally decide when that mode would be more + * appropriate than the referencing of the alias! If the aliased + * expression is the preferred output, it can be extracted from the + * {@link QOM} API via {@link TableAlias#$aliased()}. + *

    + * Note that the case-sensitivity of the returned table depends on + * {@link Settings#getRenderQuotedNames()} and the {@link Name}. By default, + * table aliases are quoted, and thus case-sensitive in many SQL dialects - + * use {@link DSL#unquotedName(String...)} for case-insensitive aliases. * - * @param alias The alias name - * @param fieldAliases The field aliases. Excess aliases are ignored, - * missing aliases will be substituted by this table's field - * names. + * @param alias The alias name. If {@link Name#getName()} is qualified, then + * the {@link Name#last()} part will be used. + * @param fieldAliases The field aliases. If {@link Name#getName()} is + * qualified, then the {@link Name#last()} part will be used. + * Excess aliases are ignored, missing aliases will be + * substituted by this table's field names. * @return The table alias */ @NotNull @@ -660,21 +752,16 @@ extends /** * Create an alias for this table and its fields. *

    - * Note that the case-sensitivity of the returned table depends on - * {@link Settings#getRenderQuotedNames()} and the {@link Name}. By default, - * table aliases are quoted, and thus case-sensitive in many SQL dialects - - * use {@link DSL#unquotedName(String...)} for case-insensitive aliases. - *

    - * If the argument {@link Name#getName()} is qualified, then the - * {@link Name#last()} part will be used. - *

    *

    Derived column lists for table references
    *

    * Note, not all databases support derived column lists for their table * aliases. On the other hand, some databases do support derived column * lists, but only for derived tables. jOOQ will try to turn table * references into derived tables to make this syntax work. In other words, - * the following statements are equivalent: 

    
+     * the following statements are equivalent:
+     *
+     * 
    +     * 
      * -- Using derived column lists to rename columns (e.g. Postgres)
      * SELECT t.a, t.b
      * FROM my_table t(a, b)
@@ -684,13 +771,17 @@ extends
      * FROM (
      *   SELECT * FROM my_table
      * ) t(a, b)
-     * 
    
+     *     
+     *
    *

    *

    Derived column lists for derived tables
    *

    * Other databases may not support derived column lists at all, but they do * support common table expressions. The following statements are - * equivalent: 

    
+     * equivalent:
+     *
+     * 
    +     * 
      * -- Using derived column lists to rename columns (e.g. Postgres)
      * SELECT t.a, t.b
      * FROM (
@@ -704,12 +795,37 @@ extends
      *   UNION ALL
      *   SELECT 1, 2 FROM DUAL
      * ) t
-     * 
    
+     *     
+     *
    + *

    + * A table alias renders itself differently, depending on + * {@link Context#declareTables()}. There are two rendering modes: + *

      + *
    • Declaration: The table alias renders its aliased expression + * (this) along with the AS alias clause. This + * typically happens in FROM and INTO + * clauses.
      • + *
    • Reference: The table alias renders its alias identifier. This happens + * everywhere else.
      • + *
    + *

    + * There is no rendering mode that reproduces the aliased expression + * as there is no way to formally decide when that mode would be more + * appropriate than the referencing of the alias! If the aliased + * expression is the preferred output, it can be extracted from the + * {@link QOM} API via {@link TableAlias#$aliased()}. + *

    + * Note that the case-sensitivity of the returned table depends on + * {@link Settings#getRenderQuotedNames()} and the {@link Name}. By default, + * table aliases are quoted, and thus case-sensitive in many SQL dialects - + * use {@link DSL#unquotedName(String...)} for case-insensitive aliases. * - * @param alias The alias name - * @param fieldAliases The field aliases. Excess aliases are ignored, - * missing aliases will be substituted by this table's field - * names. + * @param alias The alias name. If {@link Name#getName()} is qualified, then + * the {@link Name#last()} part will be used. + * @param fieldAliases The field aliases. If {@link Name#getName()} is + * qualified, then the {@link Name#last()} part will be used. + * Excess aliases are ignored, missing aliases will be + * substituted by this table's field names. * @return The table alias */ @NotNull @@ -727,7 +843,8 @@ extends * MY_TABLE.as("t1", f ->"prefix_" + f.getName()); * * - * @param alias The alias name + * @param alias The alias name. If {@link Name#getName()} is qualified, then + * the {@link Name#last()} part will be used. * @param aliasFunction The function providing field aliases. * @return The table alias * @deprecated - 3.14.0 - [#10156] - These methods will be removed without @@ -768,6 +885,23 @@ extends /** * Create an alias for this table based on another table's name. + *

    + * A table alias renders itself differently, depending on + * {@link Context#declareTables()}. There are two rendering modes: + *

      + *
    • Declaration: The table alias renders its aliased expression + * (this) along with the AS alias clause. This + * typically happens in FROM and INTO + * clauses.
      • + *
    • Reference: The table alias renders its alias identifier. This happens + * everywhere else.
      • + *
    + *

    + * There is no rendering mode that reproduces the aliased expression + * as there is no way to formally decide when that mode would be more + * appropriate than the referencing of the alias! If the aliased + * expression is the preferred output, it can be extracted from the + * {@link QOM} API via {@link TableAlias#$aliased()}. * * @param otherTable The other table whose name this table is aliased with. * @return The table alias. @@ -778,6 +912,23 @@ extends /** * Create an alias for this table based on another table's name. + *

    + * A table alias renders itself differently, depending on + * {@link Context#declareTables()}. There are two rendering modes: + *

      + *
    • Declaration: The table alias renders its aliased expression + * (this) along with the AS alias clause. This + * typically happens in FROM and INTO + * clauses.
      • + *
    • Reference: The table alias renders its alias identifier. This happens + * everywhere else.
      • + *
    + *

    + * There is no rendering mode that reproduces the aliased expression + * as there is no way to formally decide when that mode would be more + * appropriate than the referencing of the alias! If the aliased + * expression is the preferred output, it can be extracted from the + * {@link QOM} API via {@link TableAlias#$aliased()}. * * @param otherTable The other table whose name this table is aliased with. * @param otherFields The other fields whose field name this table's fields @@ -790,6 +941,23 @@ extends /** * Create an alias for this table based on another table's name. + *

    + * A table alias renders itself differently, depending on + * {@link Context#declareTables()}. There are two rendering modes: + *

      + *
    • Declaration: The table alias renders its aliased expression + * (this) along with the AS alias clause. This + * typically happens in FROM and INTO + * clauses.
      • + *
    • Reference: The table alias renders its alias identifier. This happens + * everywhere else.
      • + *
    + *

    + * There is no rendering mode that reproduces the aliased expression + * as there is no way to formally decide when that mode would be more + * appropriate than the referencing of the alias! If the aliased + * expression is the preferred output, it can be extracted from the + * {@link QOM} API via {@link TableAlias#$aliased()}. * * @param otherTable The other table whose name this table is aliased with. * @param otherFields The other fields whose field name this table's fields diff --git a/jOOQ/src/main/java/org/jooq/WithAsStep1.java b/jOOQ/src/main/java/org/jooq/WithAsStep1.java index f58b725061..c81db76462 100644 --- a/jOOQ/src/main/java/org/jooq/WithAsStep1.java +++ b/jOOQ/src/main/java/org/jooq/WithAsStep1.java @@ -63,6 +63,16 @@ public interface WithAsStep1 { /** * Associate a subselect with a common table expression's table and column * names. + *

    + * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

      + *
    • Declaration: The common table expression renders its CTE name + * (this) along with the AS (query) clause. This + * typically happens in WITH clauses.
      • + *
    • Reference: The common table expression renders its alias identifier. + * This happens everywhere else.
      • + *
    */ @NotNull @CheckReturnValue @Support @@ -75,6 +85,16 @@ public interface WithAsStep1 { * This adds the PostgreSQL 12 MATERIALIZED hint to the common * table expression definition, or silently ignores it, if the hint is not * supported. + *

    + * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

      + *
    • Declaration: The common table expression renders its CTE name + * (this) along with the AS (query) clause. This + * typically happens in WITH clauses.
      • + *
    • Reference: The common table expression renders its alias identifier. + * This happens everywhere else.
      • + *
    */ @NotNull @CheckReturnValue @Support @@ -87,6 +107,16 @@ public interface WithAsStep1 { * This adds the PostgreSQL 12 NOT MATERIALIZED hint to the * common table expression definition, or silently ignores it, if the hint * is not supported. + *

    + * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

      + *
    • Declaration: The common table expression renders its CTE name + * (this) along with the AS (query) clause. This + * typically happens in WITH clauses.
      • + *
    • Reference: The common table expression renders its alias identifier. + * This happens everywhere else.
      • + *
    */ @NotNull @CheckReturnValue @Support diff --git a/jOOQ/src/main/java/org/jooq/WithAsStep10.java b/jOOQ/src/main/java/org/jooq/WithAsStep10.java index e2feab36c9..6db462e04a 100644 --- a/jOOQ/src/main/java/org/jooq/WithAsStep10.java +++ b/jOOQ/src/main/java/org/jooq/WithAsStep10.java @@ -63,6 +63,16 @@ public interface WithAsStep10 { /** * Associate a subselect with a common table expression's table and column * names. + *

    + * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

      + *
    • Declaration: The common table expression renders its CTE name + * (this) along with the AS (query) clause. This + * typically happens in WITH clauses.
      • + *
    • Reference: The common table expression renders its alias identifier. + * This happens everywhere else.
      • + *
    */ @NotNull @CheckReturnValue @Support @@ -75,6 +85,16 @@ public interface WithAsStep10 { * This adds the PostgreSQL 12 MATERIALIZED hint to the common * table expression definition, or silently ignores it, if the hint is not * supported. + *

    + * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

      + *
    • Declaration: The common table expression renders its CTE name + * (this) along with the AS (query) clause. This + * typically happens in WITH clauses.
      • + *
    • Reference: The common table expression renders its alias identifier. + * This happens everywhere else.
      • + *
    */ @NotNull @CheckReturnValue @Support @@ -87,6 +107,16 @@ public interface WithAsStep10 { * This adds the PostgreSQL 12 NOT MATERIALIZED hint to the * common table expression definition, or silently ignores it, if the hint * is not supported. + *

    + * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

      + *
    • Declaration: The common table expression renders its CTE name + * (this) along with the AS (query) clause. This + * typically happens in WITH clauses.
      • + *
    • Reference: The common table expression renders its alias identifier. + * This happens everywhere else.
      • + *
    */ @NotNull @CheckReturnValue @Support diff --git a/jOOQ/src/main/java/org/jooq/WithAsStep11.java b/jOOQ/src/main/java/org/jooq/WithAsStep11.java index 00e34cf1d5..7901673167 100644 --- a/jOOQ/src/main/java/org/jooq/WithAsStep11.java +++ b/jOOQ/src/main/java/org/jooq/WithAsStep11.java @@ -63,6 +63,16 @@ public interface WithAsStep11 { /** * Associate a subselect with a common table expression's table and column * names. + *

    + * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

      + *
    • Declaration: The common table expression renders its CTE name + * (this) along with the AS (query) clause. This + * typically happens in WITH clauses.
      • + *
    • Reference: The common table expression renders its alias identifier. + * This happens everywhere else.
      • + *
    */ @NotNull @CheckReturnValue @Support @@ -75,6 +85,16 @@ public interface WithAsStep11 { * This adds the PostgreSQL 12 MATERIALIZED hint to the common * table expression definition, or silently ignores it, if the hint is not * supported. + *

    + * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

      + *
    • Declaration: The common table expression renders its CTE name + * (this) along with the AS (query) clause. This + * typically happens in WITH clauses.
      • + *
    • Reference: The common table expression renders its alias identifier. + * This happens everywhere else.
      • + *
    */ @NotNull @CheckReturnValue @Support @@ -87,6 +107,16 @@ public interface WithAsStep11 { * This adds the PostgreSQL 12 NOT MATERIALIZED hint to the * common table expression definition, or silently ignores it, if the hint * is not supported. + *

    + * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

      + *
    • Declaration: The common table expression renders its CTE name + * (this) along with the AS (query) clause. This + * typically happens in WITH clauses.
      • + *
    • Reference: The common table expression renders its alias identifier. + * This happens everywhere else.
      • + *
    */ @NotNull @CheckReturnValue @Support diff --git a/jOOQ/src/main/java/org/jooq/WithAsStep12.java b/jOOQ/src/main/java/org/jooq/WithAsStep12.java index c52d5f9ce1..57c06100d0 100644 --- a/jOOQ/src/main/java/org/jooq/WithAsStep12.java +++ b/jOOQ/src/main/java/org/jooq/WithAsStep12.java @@ -63,6 +63,16 @@ public interface WithAsStep12 { /** * Associate a subselect with a common table expression's table and column * names. + *

    + * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

      + *
    • Declaration: The common table expression renders its CTE name + * (this) along with the AS (query) clause. This + * typically happens in WITH clauses.
      • + *
    • Reference: The common table expression renders its alias identifier. + * This happens everywhere else.
      • + *
    */ @NotNull @CheckReturnValue @Support @@ -75,6 +85,16 @@ public interface WithAsStep12 { * This adds the PostgreSQL 12 MATERIALIZED hint to the common * table expression definition, or silently ignores it, if the hint is not * supported. + *

    + * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

      + *
    • Declaration: The common table expression renders its CTE name + * (this) along with the AS (query) clause. This + * typically happens in WITH clauses.
      • + *
    • Reference: The common table expression renders its alias identifier. + * This happens everywhere else.
      • + *
    */ @NotNull @CheckReturnValue @Support @@ -87,6 +107,16 @@ public interface WithAsStep12 { * This adds the PostgreSQL 12 NOT MATERIALIZED hint to the * common table expression definition, or silently ignores it, if the hint * is not supported. + *

    + * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

      + *
    • Declaration: The common table expression renders its CTE name + * (this) along with the AS (query) clause. This + * typically happens in WITH clauses.
      • + *
    • Reference: The common table expression renders its alias identifier. + * This happens everywhere else.
      • + *
    */ @NotNull @CheckReturnValue @Support diff --git a/jOOQ/src/main/java/org/jooq/WithAsStep13.java b/jOOQ/src/main/java/org/jooq/WithAsStep13.java index 00dbcefd3a..bfe9473e39 100644 --- a/jOOQ/src/main/java/org/jooq/WithAsStep13.java +++ b/jOOQ/src/main/java/org/jooq/WithAsStep13.java @@ -63,6 +63,16 @@ public interface WithAsStep13 { /** * Associate a subselect with a common table expression's table and column * names. + *

    + * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

      + *
    • Declaration: The common table expression renders its CTE name + * (this) along with the AS (query) clause. This + * typically happens in WITH clauses.
      • + *
    • Reference: The common table expression renders its alias identifier. + * This happens everywhere else.
      • + *
    */ @NotNull @CheckReturnValue @Support @@ -75,6 +85,16 @@ public interface WithAsStep13 { * This adds the PostgreSQL 12 MATERIALIZED hint to the common * table expression definition, or silently ignores it, if the hint is not * supported. + *

    + * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

      + *
    • Declaration: The common table expression renders its CTE name + * (this) along with the AS (query) clause. This + * typically happens in WITH clauses.
      • + *
    • Reference: The common table expression renders its alias identifier. + * This happens everywhere else.
      • + *
    */ @NotNull @CheckReturnValue @Support @@ -87,6 +107,16 @@ public interface WithAsStep13 { * This adds the PostgreSQL 12 NOT MATERIALIZED hint to the * common table expression definition, or silently ignores it, if the hint * is not supported. + *

    + * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

      + *
    • Declaration: The common table expression renders its CTE name + * (this) along with the AS (query) clause. This + * typically happens in WITH clauses.
      • + *
    • Reference: The common table expression renders its alias identifier. + * This happens everywhere else.
      • + *
    */ @NotNull @CheckReturnValue @Support diff --git a/jOOQ/src/main/java/org/jooq/WithAsStep14.java b/jOOQ/src/main/java/org/jooq/WithAsStep14.java index 231ea8a335..49dd208ede 100644 --- a/jOOQ/src/main/java/org/jooq/WithAsStep14.java +++ b/jOOQ/src/main/java/org/jooq/WithAsStep14.java @@ -63,6 +63,16 @@ public interface WithAsStep14 { /** * Associate a subselect with a common table expression's table and column * names. + *

    + * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

      + *
    • Declaration: The common table expression renders its CTE name + * (this) along with the AS (query) clause. This + * typically happens in WITH clauses.
      • + *
    • Reference: The common table expression renders its alias identifier. + * This happens everywhere else.
      • + *
    */ @NotNull @CheckReturnValue @Support @@ -75,6 +85,16 @@ public interface WithAsStep14 { * This adds the PostgreSQL 12 MATERIALIZED hint to the common * table expression definition, or silently ignores it, if the hint is not * supported. + *

    + * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

      + *
    • Declaration: The common table expression renders its CTE name + * (this) along with the AS (query) clause. This + * typically happens in WITH clauses.
      • + *
    • Reference: The common table expression renders its alias identifier. + * This happens everywhere else.
      • + *
    */ @NotNull @CheckReturnValue @Support @@ -87,6 +107,16 @@ public interface WithAsStep14 { * This adds the PostgreSQL 12 NOT MATERIALIZED hint to the * common table expression definition, or silently ignores it, if the hint * is not supported. + *

    + * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

      + *
    • Declaration: The common table expression renders its CTE name + * (this) along with the AS (query) clause. This + * typically happens in WITH clauses.
      • + *
    • Reference: The common table expression renders its alias identifier. + * This happens everywhere else.
      • + *
    */ @NotNull @CheckReturnValue @Support diff --git a/jOOQ/src/main/java/org/jooq/WithAsStep15.java b/jOOQ/src/main/java/org/jooq/WithAsStep15.java index e4006fb1d6..451b69a08a 100644 --- a/jOOQ/src/main/java/org/jooq/WithAsStep15.java +++ b/jOOQ/src/main/java/org/jooq/WithAsStep15.java @@ -63,6 +63,16 @@ public interface WithAsStep15 { /** * Associate a subselect with a common table expression's table and column * names. + *

    + * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

      + *
    • Declaration: The common table expression renders its CTE name + * (this) along with the AS (query) clause. This + * typically happens in WITH clauses.
      • + *
    • Reference: The common table expression renders its alias identifier. + * This happens everywhere else.
      • + *
    */ @NotNull @CheckReturnValue @Support @@ -75,6 +85,16 @@ public interface WithAsStep15 { * This adds the PostgreSQL 12 MATERIALIZED hint to the common * table expression definition, or silently ignores it, if the hint is not * supported. + *

    + * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

      + *
    • Declaration: The common table expression renders its CTE name + * (this) along with the AS (query) clause. This + * typically happens in WITH clauses.
      • + *
    • Reference: The common table expression renders its alias identifier. + * This happens everywhere else.
      • + *
    */ @NotNull @CheckReturnValue @Support @@ -87,6 +107,16 @@ public interface WithAsStep15 { * This adds the PostgreSQL 12 NOT MATERIALIZED hint to the * common table expression definition, or silently ignores it, if the hint * is not supported. + *

    + * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

      + *
    • Declaration: The common table expression renders its CTE name + * (this) along with the AS (query) clause. This + * typically happens in WITH clauses.
      • + *
    • Reference: The common table expression renders its alias identifier. + * This happens everywhere else.
      • + *
    */ @NotNull @CheckReturnValue @Support diff --git a/jOOQ/src/main/java/org/jooq/WithAsStep16.java b/jOOQ/src/main/java/org/jooq/WithAsStep16.java index 07c40c59d0..638c61801c 100644 --- a/jOOQ/src/main/java/org/jooq/WithAsStep16.java +++ b/jOOQ/src/main/java/org/jooq/WithAsStep16.java @@ -63,6 +63,16 @@ public interface WithAsStep16 { /** * Associate a subselect with a common table expression's table and column * names. + *

    + * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

      + *
    • Declaration: The common table expression renders its CTE name + * (this) along with the AS (query) clause. This + * typically happens in WITH clauses.
      • + *
    • Reference: The common table expression renders its alias identifier. + * This happens everywhere else.
      • + *
    */ @NotNull @CheckReturnValue @Support @@ -75,6 +85,16 @@ public interface WithAsStep16 { * This adds the PostgreSQL 12 MATERIALIZED hint to the common * table expression definition, or silently ignores it, if the hint is not * supported. + *

    + * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

      + *
    • Declaration: The common table expression renders its CTE name + * (this) along with the AS (query) clause. This + * typically happens in WITH clauses.
      • + *
    • Reference: The common table expression renders its alias identifier. + * This happens everywhere else.
      • + *
    */ @NotNull @CheckReturnValue @Support @@ -87,6 +107,16 @@ public interface WithAsStep16 { * This adds the PostgreSQL 12 NOT MATERIALIZED hint to the * common table expression definition, or silently ignores it, if the hint * is not supported. + *

    + * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

      + *
    • Declaration: The common table expression renders its CTE name + * (this) along with the AS (query) clause. This + * typically happens in WITH clauses.
      • + *
    • Reference: The common table expression renders its alias identifier. + * This happens everywhere else.
      • + *
    */ @NotNull @CheckReturnValue @Support diff --git a/jOOQ/src/main/java/org/jooq/WithAsStep17.java b/jOOQ/src/main/java/org/jooq/WithAsStep17.java index e4d53a6282..ef74fd0a10 100644 --- a/jOOQ/src/main/java/org/jooq/WithAsStep17.java +++ b/jOOQ/src/main/java/org/jooq/WithAsStep17.java @@ -63,6 +63,16 @@ public interface WithAsStep17 { /** * Associate a subselect with a common table expression's table and column * names. + *

    + * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

      + *
    • Declaration: The common table expression renders its CTE name + * (this) along with the AS (query) clause. This + * typically happens in WITH clauses.
      • + *
    • Reference: The common table expression renders its alias identifier. + * This happens everywhere else.
      • + *
    */ @NotNull @CheckReturnValue @Support @@ -75,6 +85,16 @@ public interface WithAsStep17 { * This adds the PostgreSQL 12 MATERIALIZED hint to the common * table expression definition, or silently ignores it, if the hint is not * supported. + *

    + * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

      + *
    • Declaration: The common table expression renders its CTE name + * (this) along with the AS (query) clause. This + * typically happens in WITH clauses.
      • + *
    • Reference: The common table expression renders its alias identifier. + * This happens everywhere else.
      • + *
    */ @NotNull @CheckReturnValue @Support @@ -87,6 +107,16 @@ public interface WithAsStep17 { * This adds the PostgreSQL 12 NOT MATERIALIZED hint to the * common table expression definition, or silently ignores it, if the hint * is not supported. + *

    + * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

      + *
    • Declaration: The common table expression renders its CTE name + * (this) along with the AS (query) clause. This + * typically happens in WITH clauses.
      • + *
    • Reference: The common table expression renders its alias identifier. + * This happens everywhere else.
      • + *
    */ @NotNull @CheckReturnValue @Support diff --git a/jOOQ/src/main/java/org/jooq/WithAsStep18.java b/jOOQ/src/main/java/org/jooq/WithAsStep18.java index a26823751f..4e89b6f6fc 100644 --- a/jOOQ/src/main/java/org/jooq/WithAsStep18.java +++ b/jOOQ/src/main/java/org/jooq/WithAsStep18.java @@ -63,6 +63,16 @@ public interface WithAsStep18 { /** * Associate a subselect with a common table expression's table and column * names. + *

    + * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

      + *
    • Declaration: The common table expression renders its CTE name + * (this) along with the AS (query) clause. This + * typically happens in WITH clauses.
      • + *
    • Reference: The common table expression renders its alias identifier. + * This happens everywhere else.
      • + *
    */ @NotNull @CheckReturnValue @Support @@ -75,6 +85,16 @@ public interface WithAsStep18 { * This adds the PostgreSQL 12 MATERIALIZED hint to the common * table expression definition, or silently ignores it, if the hint is not * supported. + *

    + * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

      + *
    • Declaration: The common table expression renders its CTE name + * (this) along with the AS (query) clause. This + * typically happens in WITH clauses.
      • + *
    • Reference: The common table expression renders its alias identifier. + * This happens everywhere else.
      • + *
    */ @NotNull @CheckReturnValue @Support @@ -87,6 +107,16 @@ public interface WithAsStep18 { * This adds the PostgreSQL 12 NOT MATERIALIZED hint to the * common table expression definition, or silently ignores it, if the hint * is not supported. + *

    + * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

      + *
    • Declaration: The common table expression renders its CTE name + * (this) along with the AS (query) clause. This + * typically happens in WITH clauses.
      • + *
    • Reference: The common table expression renders its alias identifier. + * This happens everywhere else.
      • + *
    */ @NotNull @CheckReturnValue @Support diff --git a/jOOQ/src/main/java/org/jooq/WithAsStep19.java b/jOOQ/src/main/java/org/jooq/WithAsStep19.java index c1f52bd2e5..b025c2eaf9 100644 --- a/jOOQ/src/main/java/org/jooq/WithAsStep19.java +++ b/jOOQ/src/main/java/org/jooq/WithAsStep19.java @@ -63,6 +63,16 @@ public interface WithAsStep19 { /** * Associate a subselect with a common table expression's table and column * names. + *

    + * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

      + *
    • Declaration: The common table expression renders its CTE name + * (this) along with the AS (query) clause. This + * typically happens in WITH clauses.
      • + *
    • Reference: The common table expression renders its alias identifier. + * This happens everywhere else.
      • + *
    */ @NotNull @CheckReturnValue @Support @@ -75,6 +85,16 @@ public interface WithAsStep19 { * This adds the PostgreSQL 12 MATERIALIZED hint to the common * table expression definition, or silently ignores it, if the hint is not * supported. + *

    + * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

      + *
    • Declaration: The common table expression renders its CTE name + * (this) along with the AS (query) clause. This + * typically happens in WITH clauses.
      • + *
    • Reference: The common table expression renders its alias identifier. + * This happens everywhere else.
      • + *
    */ @NotNull @CheckReturnValue @Support @@ -87,6 +107,16 @@ public interface WithAsStep19 { * This adds the PostgreSQL 12 NOT MATERIALIZED hint to the * common table expression definition, or silently ignores it, if the hint * is not supported. + *

    + * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

      + *
    • Declaration: The common table expression renders its CTE name + * (this) along with the AS (query) clause. This + * typically happens in WITH clauses.
      • + *
    • Reference: The common table expression renders its alias identifier. + * This happens everywhere else.
      • + *
    */ @NotNull @CheckReturnValue @Support diff --git a/jOOQ/src/main/java/org/jooq/WithAsStep2.java b/jOOQ/src/main/java/org/jooq/WithAsStep2.java index a203580c4e..6e11c1aa14 100644 --- a/jOOQ/src/main/java/org/jooq/WithAsStep2.java +++ b/jOOQ/src/main/java/org/jooq/WithAsStep2.java @@ -63,6 +63,16 @@ public interface WithAsStep2 { /** * Associate a subselect with a common table expression's table and column * names. + *

    + * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

      + *
    • Declaration: The common table expression renders its CTE name + * (this) along with the AS (query) clause. This + * typically happens in WITH clauses.
      • + *
    • Reference: The common table expression renders its alias identifier. + * This happens everywhere else.
      • + *
    */ @NotNull @CheckReturnValue @Support @@ -75,6 +85,16 @@ public interface WithAsStep2 { * This adds the PostgreSQL 12 MATERIALIZED hint to the common * table expression definition, or silently ignores it, if the hint is not * supported. + *

    + * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

      + *
    • Declaration: The common table expression renders its CTE name + * (this) along with the AS (query) clause. This + * typically happens in WITH clauses.
      • + *
    • Reference: The common table expression renders its alias identifier. + * This happens everywhere else.
      • + *
    */ @NotNull @CheckReturnValue @Support @@ -87,6 +107,16 @@ public interface WithAsStep2 { * This adds the PostgreSQL 12 NOT MATERIALIZED hint to the * common table expression definition, or silently ignores it, if the hint * is not supported. + *

    + * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

      + *
    • Declaration: The common table expression renders its CTE name + * (this) along with the AS (query) clause. This + * typically happens in WITH clauses.
      • + *
    • Reference: The common table expression renders its alias identifier. + * This happens everywhere else.
      • + *
    */ @NotNull @CheckReturnValue @Support diff --git a/jOOQ/src/main/java/org/jooq/WithAsStep20.java b/jOOQ/src/main/java/org/jooq/WithAsStep20.java index df89e69506..5536fc469a 100644 --- a/jOOQ/src/main/java/org/jooq/WithAsStep20.java +++ b/jOOQ/src/main/java/org/jooq/WithAsStep20.java @@ -63,6 +63,16 @@ public interface WithAsStep20 { /** * Associate a subselect with a common table expression's table and column * names. + *

    + * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

      + *
    • Declaration: The common table expression renders its CTE name + * (this) along with the AS (query) clause. This + * typically happens in WITH clauses.
      • + *
    • Reference: The common table expression renders its alias identifier. + * This happens everywhere else.
      • + *
    */ @NotNull @CheckReturnValue @Support @@ -75,6 +85,16 @@ public interface WithAsStep20 { * This adds the PostgreSQL 12 MATERIALIZED hint to the common * table expression definition, or silently ignores it, if the hint is not * supported. + *

    + * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

      + *
    • Declaration: The common table expression renders its CTE name + * (this) along with the AS (query) clause. This + * typically happens in WITH clauses.
      • + *
    • Reference: The common table expression renders its alias identifier. + * This happens everywhere else.
      • + *
    */ @NotNull @CheckReturnValue @Support @@ -87,6 +107,16 @@ public interface WithAsStep20 { * This adds the PostgreSQL 12 NOT MATERIALIZED hint to the * common table expression definition, or silently ignores it, if the hint * is not supported. + *

    + * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

      + *
    • Declaration: The common table expression renders its CTE name + * (this) along with the AS (query) clause. This + * typically happens in WITH clauses.
      • + *
    • Reference: The common table expression renders its alias identifier. + * This happens everywhere else.
      • + *
    */ @NotNull @CheckReturnValue @Support diff --git a/jOOQ/src/main/java/org/jooq/WithAsStep21.java b/jOOQ/src/main/java/org/jooq/WithAsStep21.java index 1fe777af44..46d0c94fed 100644 --- a/jOOQ/src/main/java/org/jooq/WithAsStep21.java +++ b/jOOQ/src/main/java/org/jooq/WithAsStep21.java @@ -63,6 +63,16 @@ public interface WithAsStep21 { /** * Associate a subselect with a common table expression's table and column * names. + *

    + * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

      + *
    • Declaration: The common table expression renders its CTE name + * (this) along with the AS (query) clause. This + * typically happens in WITH clauses.
      • + *
    • Reference: The common table expression renders its alias identifier. + * This happens everywhere else.
      • + *
    */ @NotNull @CheckReturnValue @Support @@ -75,6 +85,16 @@ public interface WithAsStep21 { * This adds the PostgreSQL 12 MATERIALIZED hint to the common * table expression definition, or silently ignores it, if the hint is not * supported. + *

    + * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

      + *
    • Declaration: The common table expression renders its CTE name + * (this) along with the AS (query) clause. This + * typically happens in WITH clauses.
      • + *
    • Reference: The common table expression renders its alias identifier. + * This happens everywhere else.
      • + *
    */ @NotNull @CheckReturnValue @Support @@ -87,6 +107,16 @@ public interface WithAsStep21 { * This adds the PostgreSQL 12 NOT MATERIALIZED hint to the * common table expression definition, or silently ignores it, if the hint * is not supported. + *

    + * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

      + *
    • Declaration: The common table expression renders its CTE name + * (this) along with the AS (query) clause. This + * typically happens in WITH clauses.
      • + *
    • Reference: The common table expression renders its alias identifier. + * This happens everywhere else.
      • + *
    */ @NotNull @CheckReturnValue @Support diff --git a/jOOQ/src/main/java/org/jooq/WithAsStep22.java b/jOOQ/src/main/java/org/jooq/WithAsStep22.java index 972c08eb26..840d686b56 100644 --- a/jOOQ/src/main/java/org/jooq/WithAsStep22.java +++ b/jOOQ/src/main/java/org/jooq/WithAsStep22.java @@ -63,6 +63,16 @@ public interface WithAsStep22 { /** * Associate a subselect with a common table expression's table and column * names. + *

    + * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

      + *
    • Declaration: The common table expression renders its CTE name + * (this) along with the AS (query) clause. This + * typically happens in WITH clauses.
      • + *
    • Reference: The common table expression renders its alias identifier. + * This happens everywhere else.
      • + *
    */ @NotNull @CheckReturnValue @Support @@ -75,6 +85,16 @@ public interface WithAsStep22 { * This adds the PostgreSQL 12 MATERIALIZED hint to the common * table expression definition, or silently ignores it, if the hint is not * supported. + *

    + * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

      + *
    • Declaration: The common table expression renders its CTE name + * (this) along with the AS (query) clause. This + * typically happens in WITH clauses.
      • + *
    • Reference: The common table expression renders its alias identifier. + * This happens everywhere else.
      • + *
    */ @NotNull @CheckReturnValue @Support @@ -87,6 +107,16 @@ public interface WithAsStep22 { * This adds the PostgreSQL 12 NOT MATERIALIZED hint to the * common table expression definition, or silently ignores it, if the hint * is not supported. + *

    + * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

      + *
    • Declaration: The common table expression renders its CTE name + * (this) along with the AS (query) clause. This + * typically happens in WITH clauses.
      • + *
    • Reference: The common table expression renders its alias identifier. + * This happens everywhere else.
      • + *
    */ @NotNull @CheckReturnValue @Support diff --git a/jOOQ/src/main/java/org/jooq/WithAsStep3.java b/jOOQ/src/main/java/org/jooq/WithAsStep3.java index 64b997ec4d..5ed81a13b3 100644 --- a/jOOQ/src/main/java/org/jooq/WithAsStep3.java +++ b/jOOQ/src/main/java/org/jooq/WithAsStep3.java @@ -63,6 +63,16 @@ public interface WithAsStep3 { /** * Associate a subselect with a common table expression's table and column * names. + *

    + * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

      + *
    • Declaration: The common table expression renders its CTE name + * (this) along with the AS (query) clause. This + * typically happens in WITH clauses.
      • + *
    • Reference: The common table expression renders its alias identifier. + * This happens everywhere else.
      • + *
    */ @NotNull @CheckReturnValue @Support @@ -75,6 +85,16 @@ public interface WithAsStep3 { * This adds the PostgreSQL 12 MATERIALIZED hint to the common * table expression definition, or silently ignores it, if the hint is not * supported. + *

    + * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

      + *
    • Declaration: The common table expression renders its CTE name + * (this) along with the AS (query) clause. This + * typically happens in WITH clauses.
      • + *
    • Reference: The common table expression renders its alias identifier. + * This happens everywhere else.
      • + *
    */ @NotNull @CheckReturnValue @Support @@ -87,6 +107,16 @@ public interface WithAsStep3 { * This adds the PostgreSQL 12 NOT MATERIALIZED hint to the * common table expression definition, or silently ignores it, if the hint * is not supported. + *

    + * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

      + *
    • Declaration: The common table expression renders its CTE name + * (this) along with the AS (query) clause. This + * typically happens in WITH clauses.
      • + *
    • Reference: The common table expression renders its alias identifier. + * This happens everywhere else.
      • + *
    */ @NotNull @CheckReturnValue @Support diff --git a/jOOQ/src/main/java/org/jooq/WithAsStep4.java b/jOOQ/src/main/java/org/jooq/WithAsStep4.java index 583fac8fe5..397e722405 100644 --- a/jOOQ/src/main/java/org/jooq/WithAsStep4.java +++ b/jOOQ/src/main/java/org/jooq/WithAsStep4.java @@ -63,6 +63,16 @@ public interface WithAsStep4 { /** * Associate a subselect with a common table expression's table and column * names. + *

    + * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

      + *
    • Declaration: The common table expression renders its CTE name + * (this) along with the AS (query) clause. This + * typically happens in WITH clauses.
      • + *
    • Reference: The common table expression renders its alias identifier. + * This happens everywhere else.
      • + *
    */ @NotNull @CheckReturnValue @Support @@ -75,6 +85,16 @@ public interface WithAsStep4 { * This adds the PostgreSQL 12 MATERIALIZED hint to the common * table expression definition, or silently ignores it, if the hint is not * supported. + *

    + * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

      + *
    • Declaration: The common table expression renders its CTE name + * (this) along with the AS (query) clause. This + * typically happens in WITH clauses.
      • + *
    • Reference: The common table expression renders its alias identifier. + * This happens everywhere else.
      • + *
    */ @NotNull @CheckReturnValue @Support @@ -87,6 +107,16 @@ public interface WithAsStep4 { * This adds the PostgreSQL 12 NOT MATERIALIZED hint to the * common table expression definition, or silently ignores it, if the hint * is not supported. + *

    + * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

      + *
    • Declaration: The common table expression renders its CTE name + * (this) along with the AS (query) clause. This + * typically happens in WITH clauses.
      • + *
    • Reference: The common table expression renders its alias identifier. + * This happens everywhere else.
      • + *
    */ @NotNull @CheckReturnValue @Support diff --git a/jOOQ/src/main/java/org/jooq/WithAsStep5.java b/jOOQ/src/main/java/org/jooq/WithAsStep5.java index d9ad7503f6..e6110b1d13 100644 --- a/jOOQ/src/main/java/org/jooq/WithAsStep5.java +++ b/jOOQ/src/main/java/org/jooq/WithAsStep5.java @@ -63,6 +63,16 @@ public interface WithAsStep5 { /** * Associate a subselect with a common table expression's table and column * names. + *

    + * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

      + *
    • Declaration: The common table expression renders its CTE name + * (this) along with the AS (query) clause. This + * typically happens in WITH clauses.
      • + *
    • Reference: The common table expression renders its alias identifier. + * This happens everywhere else.
      • + *
    */ @NotNull @CheckReturnValue @Support @@ -75,6 +85,16 @@ public interface WithAsStep5 { * This adds the PostgreSQL 12 MATERIALIZED hint to the common * table expression definition, or silently ignores it, if the hint is not * supported. + *

    + * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

      + *
    • Declaration: The common table expression renders its CTE name + * (this) along with the AS (query) clause. This + * typically happens in WITH clauses.
      • + *
    • Reference: The common table expression renders its alias identifier. + * This happens everywhere else.
      • + *
    */ @NotNull @CheckReturnValue @Support @@ -87,6 +107,16 @@ public interface WithAsStep5 { * This adds the PostgreSQL 12 NOT MATERIALIZED hint to the * common table expression definition, or silently ignores it, if the hint * is not supported. + *

    + * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

      + *
    • Declaration: The common table expression renders its CTE name + * (this) along with the AS (query) clause. This + * typically happens in WITH clauses.
      • + *
    • Reference: The common table expression renders its alias identifier. + * This happens everywhere else.
      • + *
    */ @NotNull @CheckReturnValue @Support diff --git a/jOOQ/src/main/java/org/jooq/WithAsStep6.java b/jOOQ/src/main/java/org/jooq/WithAsStep6.java index 5721b296fd..3b4d1e1437 100644 --- a/jOOQ/src/main/java/org/jooq/WithAsStep6.java +++ b/jOOQ/src/main/java/org/jooq/WithAsStep6.java @@ -63,6 +63,16 @@ public interface WithAsStep6 { /** * Associate a subselect with a common table expression's table and column * names. + *

    + * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

      + *
    • Declaration: The common table expression renders its CTE name + * (this) along with the AS (query) clause. This + * typically happens in WITH clauses.
      • + *
    • Reference: The common table expression renders its alias identifier. + * This happens everywhere else.
      • + *
    */ @NotNull @CheckReturnValue @Support @@ -75,6 +85,16 @@ public interface WithAsStep6 { * This adds the PostgreSQL 12 MATERIALIZED hint to the common * table expression definition, or silently ignores it, if the hint is not * supported. + *

    + * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

      + *
    • Declaration: The common table expression renders its CTE name + * (this) along with the AS (query) clause. This + * typically happens in WITH clauses.
      • + *
    • Reference: The common table expression renders its alias identifier. + * This happens everywhere else.
      • + *
    */ @NotNull @CheckReturnValue @Support @@ -87,6 +107,16 @@ public interface WithAsStep6 { * This adds the PostgreSQL 12 NOT MATERIALIZED hint to the * common table expression definition, or silently ignores it, if the hint * is not supported. + *

    + * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

      + *
    • Declaration: The common table expression renders its CTE name + * (this) along with the AS (query) clause. This + * typically happens in WITH clauses.
      • + *
    • Reference: The common table expression renders its alias identifier. + * This happens everywhere else.
      • + *
    */ @NotNull @CheckReturnValue @Support diff --git a/jOOQ/src/main/java/org/jooq/WithAsStep7.java b/jOOQ/src/main/java/org/jooq/WithAsStep7.java index d451361e56..e49fa0d944 100644 --- a/jOOQ/src/main/java/org/jooq/WithAsStep7.java +++ b/jOOQ/src/main/java/org/jooq/WithAsStep7.java @@ -63,6 +63,16 @@ public interface WithAsStep7 { /** * Associate a subselect with a common table expression's table and column * names. + *

    + * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

      + *
    • Declaration: The common table expression renders its CTE name + * (this) along with the AS (query) clause. This + * typically happens in WITH clauses.
      • + *
    • Reference: The common table expression renders its alias identifier. + * This happens everywhere else.
      • + *
    */ @NotNull @CheckReturnValue @Support @@ -75,6 +85,16 @@ public interface WithAsStep7 { * This adds the PostgreSQL 12 MATERIALIZED hint to the common * table expression definition, or silently ignores it, if the hint is not * supported. + *

    + * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

      + *
    • Declaration: The common table expression renders its CTE name + * (this) along with the AS (query) clause. This + * typically happens in WITH clauses.
      • + *
    • Reference: The common table expression renders its alias identifier. + * This happens everywhere else.
      • + *
    */ @NotNull @CheckReturnValue @Support @@ -87,6 +107,16 @@ public interface WithAsStep7 { * This adds the PostgreSQL 12 NOT MATERIALIZED hint to the * common table expression definition, or silently ignores it, if the hint * is not supported. + *

    + * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

      + *
    • Declaration: The common table expression renders its CTE name + * (this) along with the AS (query) clause. This + * typically happens in WITH clauses.
      • + *
    • Reference: The common table expression renders its alias identifier. + * This happens everywhere else.
      • + *
    */ @NotNull @CheckReturnValue @Support diff --git a/jOOQ/src/main/java/org/jooq/WithAsStep8.java b/jOOQ/src/main/java/org/jooq/WithAsStep8.java index 0cd3930c41..2bf6419ed6 100644 --- a/jOOQ/src/main/java/org/jooq/WithAsStep8.java +++ b/jOOQ/src/main/java/org/jooq/WithAsStep8.java @@ -63,6 +63,16 @@ public interface WithAsStep8 { /** * Associate a subselect with a common table expression's table and column * names. + *

    + * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

      + *
    • Declaration: The common table expression renders its CTE name + * (this) along with the AS (query) clause. This + * typically happens in WITH clauses.
      • + *
    • Reference: The common table expression renders its alias identifier. + * This happens everywhere else.
      • + *
    */ @NotNull @CheckReturnValue @Support @@ -75,6 +85,16 @@ public interface WithAsStep8 { * This adds the PostgreSQL 12 MATERIALIZED hint to the common * table expression definition, or silently ignores it, if the hint is not * supported. + *

    + * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

      + *
    • Declaration: The common table expression renders its CTE name + * (this) along with the AS (query) clause. This + * typically happens in WITH clauses.
      • + *
    • Reference: The common table expression renders its alias identifier. + * This happens everywhere else.
      • + *
    */ @NotNull @CheckReturnValue @Support @@ -87,6 +107,16 @@ public interface WithAsStep8 { * This adds the PostgreSQL 12 NOT MATERIALIZED hint to the * common table expression definition, or silently ignores it, if the hint * is not supported. + *

    + * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

      + *
    • Declaration: The common table expression renders its CTE name + * (this) along with the AS (query) clause. This + * typically happens in WITH clauses.
      • + *
    • Reference: The common table expression renders its alias identifier. + * This happens everywhere else.
      • + *
    */ @NotNull @CheckReturnValue @Support diff --git a/jOOQ/src/main/java/org/jooq/WithAsStep9.java b/jOOQ/src/main/java/org/jooq/WithAsStep9.java index 0726f1a8dd..4ad44467ac 100644 --- a/jOOQ/src/main/java/org/jooq/WithAsStep9.java +++ b/jOOQ/src/main/java/org/jooq/WithAsStep9.java @@ -63,6 +63,16 @@ public interface WithAsStep9 { /** * Associate a subselect with a common table expression's table and column * names. + *

    + * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

      + *
    • Declaration: The common table expression renders its CTE name + * (this) along with the AS (query) clause. This + * typically happens in WITH clauses.
      • + *
    • Reference: The common table expression renders its alias identifier. + * This happens everywhere else.
      • + *
    */ @NotNull @CheckReturnValue @Support @@ -75,6 +85,16 @@ public interface WithAsStep9 { * This adds the PostgreSQL 12 MATERIALIZED hint to the common * table expression definition, or silently ignores it, if the hint is not * supported. + *

    + * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

      + *
    • Declaration: The common table expression renders its CTE name + * (this) along with the AS (query) clause. This + * typically happens in WITH clauses.
      • + *
    • Reference: The common table expression renders its alias identifier. + * This happens everywhere else.
      • + *
    */ @NotNull @CheckReturnValue @Support @@ -87,6 +107,16 @@ public interface WithAsStep9 { * This adds the PostgreSQL 12 NOT MATERIALIZED hint to the * common table expression definition, or silently ignores it, if the hint * is not supported. + *

    + * A common table expression renders itself differently, depending on + * {@link Context#declareCTE()}. There are two rendering modes: + *

      + *
    • Declaration: The common table expression renders its CTE name + * (this) along with the AS (query) clause. This + * typically happens in WITH clauses.
      • + *
    • Reference: The common table expression renders its alias identifier. + * This happens everywhere else.
      • + *
    */ @NotNull @CheckReturnValue @Support diff --git a/jOOQ/src/main/java/org/jooq/impl/DSL.java b/jOOQ/src/main/java/org/jooq/impl/DSL.java index 0f19c4ac14..5b31a154dd 100644 --- a/jOOQ/src/main/java/org/jooq/impl/DSL.java +++ b/jOOQ/src/main/java/org/jooq/impl/DSL.java @@ -210,6 +210,7 @@ import org.jooq.ConstraintForeignKeyReferencesStep8; import org.jooq.ConstraintForeignKeyReferencesStep9; import org.jooq.ConstraintForeignKeyReferencesStepN; import org.jooq.ConstraintTypeStep; +import org.jooq.Context; // ... import org.jooq.Converter; import org.jooq.CreateTypeStep; @@ -14535,6 +14536,17 @@ public class DSL { /** * Create an IN parameter. + *

    + * A parameter renders itself differently, depending on + * {@link Context#declareParameters()}. There are two rendering modes: + *

      + *
    • Declaration: The paramet renders its {@link Parameter#getParamMode()} + * along with the parameter name and data type. This typically happens in + * CREATE PROCEDURE or CREATE FUNCTION + * clauses.
      • + *
    • Reference: The parameter renders its identifier. This happens + * everywhere else.
      • + *
    */ @NotNull @Support @@ -14544,6 +14556,17 @@ public class DSL { /** * Create an IN parameter. + *

    + * A parameter renders itself differently, depending on + * {@link Context#declareParameters()}. There are two rendering modes: + *

      + *
    • Declaration: The paramet renders its {@link Parameter#getParamMode()} + * along with the parameter name and data type. This typically happens in + * CREATE PROCEDURE or CREATE FUNCTION + * clauses.
      • + *
    • Reference: The parameter renders its identifier. This happens + * everywhere else.
      • + *
    */ @NotNull @Support @@ -14553,6 +14576,17 @@ public class DSL { /** * Create an IN OUT parameter. + *

    + * A parameter renders itself differently, depending on + * {@link Context#declareParameters()}. There are two rendering modes: + *

      + *
    • Declaration: The paramet renders its {@link Parameter#getParamMode()} + * along with the parameter name and data type. This typically happens in + * CREATE PROCEDURE or CREATE FUNCTION + * clauses.
      • + *
    • Reference: The parameter renders its identifier. This happens + * everywhere else.
      • + *
    */ @NotNull @Support @@ -14562,6 +14596,17 @@ public class DSL { /** * Create an IN OUT parameter. + *

    + * A parameter renders itself differently, depending on + * {@link Context#declareParameters()}. There are two rendering modes: + *

      + *
    • Declaration: The paramet renders its {@link Parameter#getParamMode()} + * along with the parameter name and data type. This typically happens in + * CREATE PROCEDURE or CREATE FUNCTION + * clauses.
      • + *
    • Reference: The parameter renders its identifier. This happens + * everywhere else.
      • + *
    */ @NotNull @Support @@ -14571,6 +14616,17 @@ public class DSL { /** * Create an OUT parameter. + *

    + * A parameter renders itself differently, depending on + * {@link Context#declareParameters()}. There are two rendering modes: + *

      + *
    • Declaration: The paramet renders its {@link Parameter#getParamMode()} + * along with the parameter name and data type. This typically happens in + * CREATE PROCEDURE or CREATE FUNCTION + * clauses.
      • + *
    • Reference: The parameter renders its identifier. This happens + * everywhere else.
      • + *
    */ @NotNull @Support @@ -14580,6 +14636,17 @@ public class DSL { /** * Create an OUT parameter. + *

    + * A parameter renders itself differently, depending on + * {@link Context#declareParameters()}. There are two rendering modes: + *

      + *
    • Declaration: The paramet renders its {@link Parameter#getParamMode()} + * along with the parameter name and data type. This typically happens in + * CREATE PROCEDURE or CREATE FUNCTION + * clauses.
      • + *
    • Reference: The parameter renders its identifier. This happens + * everywhere else.
      • + *
    */ @NotNull @Support