diff --git a/jOOQ/src/main/java/org/jooq/DSLContext.java b/jOOQ/src/main/java/org/jooq/DSLContext.java index a4277d4436..a59b11bab0 100644 --- a/jOOQ/src/main/java/org/jooq/DSLContext.java +++ b/jOOQ/src/main/java/org/jooq/DSLContext.java @@ -3979,7 +3979,14 @@ public interface DSLContext extends Scope , AutoCloseable { * This works in a similar way as {@link #with(String, String...)}, except * that all column names are produced by a function that receives the CTE's * {@link Select} columns as input. + * + * @deprecated - 3.14.0 - [#10156] - These methods will be removed without + * replacement from a future jOOQ. They offer convenience that + * is unidiomatic for jOOQ's DSL, without offering functionality + * that would not be possible otherwise - yet they add + * complexity in jOOQ's internals. */ + @Deprecated @Support({ FIREBIRD, H2, HSQLDB, MARIADB, MYSQL, POSTGRES, SQLITE }) WithAsStep with(String alias, Function, ? extends String> fieldNameFunction); @@ -3998,7 +4005,14 @@ public interface DSLContext extends Scope , AutoCloseable { * This works in a similar way as {@link #with(String, String...)}, except * that all column names are produced by a function that receives the CTE's * {@link Select} columns and their column indexes as input. + * + * @deprecated - 3.14.0 - [#10156] - These methods will be removed without + * replacement from a future jOOQ. They offer convenience that + * is unidiomatic for jOOQ's DSL, without offering functionality + * that would not be possible otherwise - yet they add + * complexity in jOOQ's internals. */ + @Deprecated @Support({ FIREBIRD, H2, HSQLDB, MARIADB, MYSQL, POSTGRES, SQLITE }) WithAsStep with(String alias, BiFunction, ? super Integer, ? extends String> fieldNameFunction); @@ -4872,7 +4886,14 @@ public interface DSLContext extends Scope , AutoCloseable { * This works in a similar way as {@link #with(String, String...)}, except * that all column names are produced by a function that receives the CTE's * {@link Select} columns as input. + * + * @deprecated - 3.14.0 - [#10156] - These methods will be removed without + * replacement from a future jOOQ. They offer convenience that + * is unidiomatic for jOOQ's DSL, without offering functionality + * that would not be possible otherwise - yet they add + * complexity in jOOQ's internals. */ + @Deprecated @Support({ FIREBIRD, H2, HSQLDB, MARIADB, MYSQL, POSTGRES, SQLITE }) WithAsStep withRecursive(String alias, Function, ? extends String> fieldNameFunction); @@ -4892,7 +4913,14 @@ public interface DSLContext extends Scope , AutoCloseable { * This works in a similar way as {@link #with(String, String...)}, except * that all column names are produced by a function that receives the CTE's * {@link Select} columns and their column indexes as input. + * + * @deprecated - 3.14.0 - [#10156] - These methods will be removed without + * replacement from a future jOOQ. They offer convenience that + * is unidiomatic for jOOQ's DSL, without offering functionality + * that would not be possible otherwise - yet they add + * complexity in jOOQ's internals. */ + @Deprecated @Support({ FIREBIRD, HSQLDB, MARIADB, MYSQL, POSTGRES, SQLITE }) WithAsStep withRecursive(String alias, BiFunction, ? super Integer, ? extends String> fieldNameFunction); @@ -8977,7 +9005,13 @@ public interface DSLContext extends Scope , AutoCloseable { * using a function. * * @see DSL#createView(String, String...) + * @deprecated - 3.14.0 - [#10156] - These methods will be removed without + * replacement from a future jOOQ. They offer convenience that + * is unidiomatic for jOOQ's DSL, without offering functionality + * that would not be possible otherwise - yet they add + * complexity in jOOQ's internals. */ + @Deprecated @Support CreateViewAsStep createView(String view, Function, ? extends String> fieldNameFunction); @@ -8989,7 +9023,13 @@ public interface DSLContext extends Scope , AutoCloseable { * using a function. * * @see DSL#createView(String, String...) + * @deprecated - 3.14.0 - [#10156] - These methods will be removed without + * replacement from a future jOOQ. They offer convenience that + * is unidiomatic for jOOQ's DSL, without offering functionality + * that would not be possible otherwise - yet they add + * complexity in jOOQ's internals. */ + @Deprecated @Support CreateViewAsStep createView(String view, BiFunction, ? super Integer, ? extends String> fieldNameFunction); @@ -9001,7 +9041,13 @@ public interface DSLContext extends Scope , AutoCloseable { * using a function. * * @see DSL#createView(String, String...) + * @deprecated - 3.14.0 - [#10156] - These methods will be removed without + * replacement from a future jOOQ. They offer convenience that + * is unidiomatic for jOOQ's DSL, without offering functionality + * that would not be possible otherwise - yet they add + * complexity in jOOQ's internals. */ + @Deprecated @Support CreateViewAsStep createView(Name view, Function, ? extends Name> fieldNameFunction); @@ -9013,7 +9059,13 @@ public interface DSLContext extends Scope , AutoCloseable { * using a function. * * @see DSL#createView(String, String...) + * @deprecated - 3.14.0 - [#10156] - These methods will be removed without + * replacement from a future jOOQ. They offer convenience that + * is unidiomatic for jOOQ's DSL, without offering functionality + * that would not be possible otherwise - yet they add + * complexity in jOOQ's internals. */ + @Deprecated @Support CreateViewAsStep createView(Name view, BiFunction, ? super Integer, ? extends Name> fieldNameFunction); @@ -9025,7 +9077,13 @@ public interface DSLContext extends Scope , AutoCloseable { * using a function. * * @see DSL#createView(String, String...) + * @deprecated - 3.14.0 - [#10156] - These methods will be removed without + * replacement from a future jOOQ. They offer convenience that + * is unidiomatic for jOOQ's DSL, without offering functionality + * that would not be possible otherwise - yet they add + * complexity in jOOQ's internals. */ + @Deprecated @Support CreateViewAsStep createView(Table view, Function, ? extends Field> fieldNameFunction); @@ -9037,7 +9095,13 @@ public interface DSLContext extends Scope , AutoCloseable { * using a function. * * @see DSL#createView(String, String...) + * @deprecated - 3.14.0 - [#10156] - These methods will be removed without + * replacement from a future jOOQ. They offer convenience that + * is unidiomatic for jOOQ's DSL, without offering functionality + * that would not be possible otherwise - yet they add + * complexity in jOOQ's internals. */ + @Deprecated @Support CreateViewAsStep createView(Table view, BiFunction, ? super Integer, ? extends Field> fieldNameFunction); @@ -9075,19 +9139,31 @@ public interface DSLContext extends Scope , AutoCloseable { * using a function. * * @see DSL#createOrReplaceView(String, String...) + * @deprecated - 3.14.0 - [#10156] - These methods will be removed without + * replacement from a future jOOQ. They offer convenience that + * is unidiomatic for jOOQ's DSL, without offering functionality + * that would not be possible otherwise - yet they add + * complexity in jOOQ's internals. */ + @Deprecated @Support({ FIREBIRD, H2, MARIADB, MYSQL, POSTGRES }) CreateViewAsStep createOrReplaceView(String view, Function, ? extends String> fieldNameFunction); /** * Create a new DSL CREATE OR REPLACE VIEW statement. *

- * This works like {@link #createOrReplaceView(String, String...)} except that the - * view's field names are derived from the view's {@link Select} statement - * using a function. + * This works like {@link #createOrReplaceView(String, String...)} except + * that the view's field names are derived from the view's {@link Select} + * statement using a function. * * @see DSL#createOrReplaceView(String, String...) + * @deprecated - 3.14.0 - [#10156] - These methods will be removed without + * replacement from a future jOOQ. They offer convenience that + * is unidiomatic for jOOQ's DSL, without offering functionality + * that would not be possible otherwise - yet they add + * complexity in jOOQ's internals. */ + @Deprecated @Support({ FIREBIRD, H2, MARIADB, MYSQL, POSTGRES }) CreateViewAsStep createOrReplaceView(String view, BiFunction, ? super Integer, ? extends String> fieldNameFunction); @@ -9099,7 +9175,13 @@ public interface DSLContext extends Scope , AutoCloseable { * using a function. * * @see DSL#createOrReplaceView(String, String...) + * @deprecated - 3.14.0 - [#10156] - These methods will be removed without + * replacement from a future jOOQ. They offer convenience that + * is unidiomatic for jOOQ's DSL, without offering functionality + * that would not be possible otherwise - yet they add + * complexity in jOOQ's internals. */ + @Deprecated @Support({ FIREBIRD, H2, MARIADB, MYSQL, POSTGRES }) CreateViewAsStep createOrReplaceView(Name view, Function, ? extends Name> fieldNameFunction); @@ -9111,7 +9193,13 @@ public interface DSLContext extends Scope , AutoCloseable { * using a function. * * @see DSL#createOrReplaceView(String, String...) + * @deprecated - 3.14.0 - [#10156] - These methods will be removed without + * replacement from a future jOOQ. They offer convenience that + * is unidiomatic for jOOQ's DSL, without offering functionality + * that would not be possible otherwise - yet they add + * complexity in jOOQ's internals. */ + @Deprecated @Support({ FIREBIRD, H2, MARIADB, MYSQL, POSTGRES }) CreateViewAsStep createOrReplaceView(Name view, BiFunction, ? super Integer, ? extends Name> fieldNameFunction); @@ -9123,7 +9211,13 @@ public interface DSLContext extends Scope , AutoCloseable { * using a function. * * @see DSL#createOrReplaceView(String, String...) + * @deprecated - 3.14.0 - [#10156] - These methods will be removed without + * replacement from a future jOOQ. They offer convenience that + * is unidiomatic for jOOQ's DSL, without offering functionality + * that would not be possible otherwise - yet they add + * complexity in jOOQ's internals. */ + @Deprecated @Support({ FIREBIRD, H2, MARIADB, MYSQL, POSTGRES }) CreateViewAsStep createOrReplaceView(Table view, Function, ? extends Field> fieldNameFunction); @@ -9135,7 +9229,13 @@ public interface DSLContext extends Scope , AutoCloseable { * using a function. * * @see DSL#createOrReplaceView(String, String...) + * @deprecated - 3.14.0 - [#10156] - These methods will be removed without + * replacement from a future jOOQ. They offer convenience that + * is unidiomatic for jOOQ's DSL, without offering functionality + * that would not be possible otherwise - yet they add + * complexity in jOOQ's internals. */ + @Deprecated @Support({ FIREBIRD, H2, MARIADB, MYSQL, POSTGRES }) CreateViewAsStep createOrReplaceView(Table view, BiFunction, ? super Integer, ? extends Field> fieldNameFunction); @@ -9173,7 +9273,13 @@ public interface DSLContext extends Scope , AutoCloseable { * using a function. * * @see DSL#createViewIfNotExists(String, String...) + * @deprecated - 3.14.0 - [#10156] - These methods will be removed without + * replacement from a future jOOQ. They offer convenience that + * is unidiomatic for jOOQ's DSL, without offering functionality + * that would not be possible otherwise - yet they add + * complexity in jOOQ's internals. */ + @Deprecated @Support({ FIREBIRD, H2, HSQLDB, MARIADB, MYSQL, POSTGRES, SQLITE }) CreateViewAsStep createViewIfNotExists(String view, Function, ? extends String> fieldNameFunction); @@ -9185,7 +9291,13 @@ public interface DSLContext extends Scope , AutoCloseable { * using a function. * * @see DSL#createViewIfNotExists(String, String...) + * @deprecated - 3.14.0 - [#10156] - These methods will be removed without + * replacement from a future jOOQ. They offer convenience that + * is unidiomatic for jOOQ's DSL, without offering functionality + * that would not be possible otherwise - yet they add + * complexity in jOOQ's internals. */ + @Deprecated @Support({ FIREBIRD, H2, HSQLDB, MARIADB, MYSQL, POSTGRES, SQLITE }) CreateViewAsStep createViewIfNotExists(String view, BiFunction, ? super Integer, ? extends String> fieldNameFunction); @@ -9197,7 +9309,13 @@ public interface DSLContext extends Scope , AutoCloseable { * using a function. * * @see DSL#createViewIfNotExists(String, String...) + * @deprecated - 3.14.0 - [#10156] - These methods will be removed without + * replacement from a future jOOQ. They offer convenience that + * is unidiomatic for jOOQ's DSL, without offering functionality + * that would not be possible otherwise - yet they add + * complexity in jOOQ's internals. */ + @Deprecated @Support({ FIREBIRD, H2, HSQLDB, MARIADB, MYSQL, POSTGRES, SQLITE }) CreateViewAsStep createViewIfNotExists(Name view, Function, ? extends Name> fieldNameFunction); @@ -9209,7 +9327,13 @@ public interface DSLContext extends Scope , AutoCloseable { * using a function. * * @see DSL#createViewIfNotExists(String, String...) + * @deprecated - 3.14.0 - [#10156] - These methods will be removed without + * replacement from a future jOOQ. They offer convenience that + * is unidiomatic for jOOQ's DSL, without offering functionality + * that would not be possible otherwise - yet they add + * complexity in jOOQ's internals. */ + @Deprecated @Support({ FIREBIRD, H2, HSQLDB, MARIADB, MYSQL, POSTGRES, SQLITE }) CreateViewAsStep createViewIfNotExists(Name view, BiFunction, ? super Integer, ? extends Name> fieldNameFunction); @@ -9221,7 +9345,13 @@ public interface DSLContext extends Scope , AutoCloseable { * using a function. * * @see DSL#createViewIfNotExists(String, String...) + * @deprecated - 3.14.0 - [#10156] - These methods will be removed without + * replacement from a future jOOQ. They offer convenience that + * is unidiomatic for jOOQ's DSL, without offering functionality + * that would not be possible otherwise - yet they add + * complexity in jOOQ's internals. */ + @Deprecated @Support({ FIREBIRD, H2, HSQLDB, MARIADB, MYSQL, POSTGRES, SQLITE }) CreateViewAsStep createViewIfNotExists(Table view, Function, ? extends Field> fieldNameFunction); @@ -9233,7 +9363,13 @@ public interface DSLContext extends Scope , AutoCloseable { * using a function. * * @see DSL#createViewIfNotExists(String, String...) + * @deprecated - 3.14.0 - [#10156] - These methods will be removed without + * replacement from a future jOOQ. They offer convenience that + * is unidiomatic for jOOQ's DSL, without offering functionality + * that would not be possible otherwise - yet they add + * complexity in jOOQ's internals. */ + @Deprecated @Support({ FIREBIRD, H2, HSQLDB, MARIADB, MYSQL, POSTGRES, SQLITE }) CreateViewAsStep createViewIfNotExists(Table view, BiFunction, ? super Integer, ? extends Field> fieldNameFunction); diff --git a/jOOQ/src/main/java/org/jooq/Field.java b/jOOQ/src/main/java/org/jooq/Field.java index e7b7dd62c7..4beffcfd4b 100644 --- a/jOOQ/src/main/java/org/jooq/Field.java +++ b/jOOQ/src/main/java/org/jooq/Field.java @@ -229,7 +229,14 @@ extends *

      * MY_TABLE.MY_COLUMN.as(f -> "prefix_" + f.getName());
      * 
+ * + * @deprecated - 3.14.0 - [#10156] - These methods will be removed without + * replacement from a future jOOQ. They offer convenience that + * is unidiomatic for jOOQ's DSL, without offering functionality + * that would not be possible otherwise - yet they add + * complexity in jOOQ's internals. */ + @Deprecated @Support Field as(Function, ? extends String> aliasFunction); diff --git a/jOOQ/src/main/java/org/jooq/FieldLike.java b/jOOQ/src/main/java/org/jooq/FieldLike.java index 5c6bc7977c..94e2bd2cad 100644 --- a/jOOQ/src/main/java/org/jooq/FieldLike.java +++ b/jOOQ/src/main/java/org/jooq/FieldLike.java @@ -98,7 +98,14 @@ public interface FieldLike { *
      * MY_TABLE.MY_COLUMN.as(f -> "prefix_" + f.getName());
      * 
+ * + * @deprecated - 3.14.0 - [#10156] - These methods will be removed without + * replacement from a future jOOQ. They offer convenience that + * is unidiomatic for jOOQ's DSL, without offering functionality + * that would not be possible otherwise - yet they add + * complexity in jOOQ's internals. */ + @Deprecated @Support Field asField(Function, ? extends String> aliasFunction); diff --git a/jOOQ/src/main/java/org/jooq/Name.java b/jOOQ/src/main/java/org/jooq/Name.java index a8d5165013..5f00c85c6e 100644 --- a/jOOQ/src/main/java/org/jooq/Name.java +++ b/jOOQ/src/main/java/org/jooq/Name.java @@ -266,7 +266,14 @@ public interface Name extends QueryPart, Comparable { * This works in a similar way as {@link #fields(String...)}, except * that all column names are produced by a function that receives the CTE's * {@link Select} columns and their column indexes as input. + * + * @deprecated - 3.14.0 - [#10156] - These methods will be removed without + * replacement from a future jOOQ. They offer convenience that + * is unidiomatic for jOOQ's DSL, without offering functionality + * that would not be possible otherwise - yet they add + * complexity in jOOQ's internals. */ + @Deprecated @Support({ FIREBIRD, H2, HSQLDB, MYSQL, POSTGRES, SQLITE }) DerivedColumnList fields(Function, ? extends String> fieldNameFunction); @@ -281,7 +288,14 @@ public interface Name extends QueryPart, Comparable { * This works in a similar way as {@link #fields(String...)}, except * that all column names are produced by a function that receives the CTE's * {@link Select} columns as input. + * + * @deprecated - 3.14.0 - [#10156] - These methods will be removed without + * replacement from a future jOOQ. They offer convenience that + * is unidiomatic for jOOQ's DSL, without offering functionality + * that would not be possible otherwise - yet they add + * complexity in jOOQ's internals. */ + @Deprecated @Support({ FIREBIRD, H2, HSQLDB, MYSQL, POSTGRES, SQLITE }) DerivedColumnList fields(BiFunction, ? super Integer, ? extends String> fieldNameFunction); diff --git a/jOOQ/src/main/java/org/jooq/Table.java b/jOOQ/src/main/java/org/jooq/Table.java index a79844143e..55a2fe8075 100644 --- a/jOOQ/src/main/java/org/jooq/Table.java +++ b/jOOQ/src/main/java/org/jooq/Table.java @@ -460,7 +460,13 @@ public interface Table extends TableLike, Named { * @param alias The alias name * @param aliasFunction The function providing field aliases. * @return The table alias + * @deprecated - 3.14.0 - [#10156] - These methods will be removed without + * replacement from a future jOOQ. They offer convenience that + * is unidiomatic for jOOQ's DSL, without offering functionality + * that would not be possible otherwise - yet they add + * complexity in jOOQ's internals. */ + @Deprecated @Support Table as(String alias, Function, ? extends String> aliasFunction); @@ -478,7 +484,13 @@ public interface Table extends TableLike, Named { * @param alias The alias name * @param aliasFunction The function providing field aliases. * @return The table alias + * @deprecated - 3.14.0 - [#10156] - These methods will be removed without + * replacement from a future jOOQ. They offer convenience that + * is unidiomatic for jOOQ's DSL, without offering functionality + * that would not be possible otherwise - yet they add + * complexity in jOOQ's internals. */ + @Deprecated @Support Table as(String alias, BiFunction, ? super Integer, ? extends String> aliasFunction); @@ -573,7 +585,13 @@ public interface Table extends TableLike, Named { * @param alias The alias name * @param aliasFunction The function providing field aliases. * @return The table alias + * @deprecated - 3.14.0 - [#10156] - These methods will be removed without + * replacement from a future jOOQ. They offer convenience that + * is unidiomatic for jOOQ's DSL, without offering functionality + * that would not be possible otherwise - yet they add + * complexity in jOOQ's internals. */ + @Deprecated @Support Table as(Name alias, Function, ? extends Name> aliasFunction); @@ -591,7 +609,13 @@ public interface Table extends TableLike, Named { * @param alias The alias name * @param aliasFunction The function providing field aliases. * @return The table alias + * @deprecated - 3.14.0 - [#10156] - These methods will be removed without + * replacement from a future jOOQ. They offer convenience that + * is unidiomatic for jOOQ's DSL, without offering functionality + * that would not be possible otherwise - yet they add + * complexity in jOOQ's internals. */ + @Deprecated @Support Table as(Name alias, BiFunction, ? super Integer, ? extends Name> aliasFunction); @@ -631,7 +655,13 @@ public interface Table extends TableLike, Named { * @param otherTable The other table whose name is used as alias name * @param aliasFunction The function providing field aliases. * @return The table alias + * @deprecated - 3.14.0 - [#10156] - These methods will be removed without + * replacement from a future jOOQ. They offer convenience that + * is unidiomatic for jOOQ's DSL, without offering functionality + * that would not be possible otherwise - yet they add + * complexity in jOOQ's internals. */ + @Deprecated @Support Table as(Table otherTable, Function, ? extends Field> aliasFunction); @@ -649,7 +679,13 @@ public interface Table extends TableLike, Named { * @param otherTable The other table whose name is used as alias name * @param aliasFunction The function providing field aliases. * @return The table alias + * @deprecated - 3.14.0 - [#10156] - These methods will be removed without + * replacement from a future jOOQ. They offer convenience that + * is unidiomatic for jOOQ's DSL, without offering functionality + * that would not be possible otherwise - yet they add + * complexity in jOOQ's internals. */ + @Deprecated @Support Table as(Table otherTable, BiFunction, ? super Integer, ? extends Field> aliasFunction); diff --git a/jOOQ/src/main/java/org/jooq/TableLike.java b/jOOQ/src/main/java/org/jooq/TableLike.java index 888f8e7893..7689d21fa0 100644 --- a/jOOQ/src/main/java/org/jooq/TableLike.java +++ b/jOOQ/src/main/java/org/jooq/TableLike.java @@ -260,7 +260,13 @@ public interface TableLike extends QueryPart { * The underlying aliased table representation of this object. * * @see Table#as(String, Function) + * @deprecated - 3.14.0 - [#10156] - These methods will be removed without + * replacement from a future jOOQ. They offer convenience that + * is unidiomatic for jOOQ's DSL, without offering functionality + * that would not be possible otherwise - yet they add + * complexity in jOOQ's internals. */ + @Deprecated @Support Table asTable(String alias, Function, ? extends String> aliasFunction); @@ -268,7 +274,13 @@ public interface TableLike extends QueryPart { * The underlying aliased table representation of this object. * * @see Table#as(String, BiFunction) + * @deprecated - 3.14.0 - [#10156] - These methods will be removed without + * replacement from a future jOOQ. They offer convenience that + * is unidiomatic for jOOQ's DSL, without offering functionality + * that would not be possible otherwise - yet they add + * complexity in jOOQ's internals. */ + @Deprecated @Support Table asTable(String alias, BiFunction, ? super Integer, ? extends String> aliasFunction); diff --git a/jOOQ/src/main/java/org/jooq/WithStep.java b/jOOQ/src/main/java/org/jooq/WithStep.java index 933c2d38e2..4310b03c4f 100644 --- a/jOOQ/src/main/java/org/jooq/WithStep.java +++ b/jOOQ/src/main/java/org/jooq/WithStep.java @@ -147,7 +147,14 @@ public interface WithStep extends QueryPart { * This works in a similar way as {@link #with(String, String...)}, except * that all column names are produced by a function that receives the CTE's * {@link Select} columns as input. + * + * @deprecated - 3.14.0 - [#10156] - These methods will be removed without + * replacement from a future jOOQ. They offer convenience that + * is unidiomatic for jOOQ's DSL, without offering functionality + * that would not be possible otherwise - yet they add + * complexity in jOOQ's internals. */ + @Deprecated @Support({ FIREBIRD, H2, HSQLDB, MARIADB, MYSQL, POSTGRES, SQLITE }) WithAsStep with(String alias, Function, ? extends String> fieldNameFunction); @@ -157,7 +164,14 @@ public interface WithStep extends QueryPart { * This works in a similar way as {@link #with(String, String...)}, except * that all column names are produced by a function that receives the CTE's * {@link Select} columns and their column indexes as input. + * + * @deprecated - 3.14.0 - [#10156] - These methods will be removed without + * replacement from a future jOOQ. They offer convenience that + * is unidiomatic for jOOQ's DSL, without offering functionality + * that would not be possible otherwise - yet they add + * complexity in jOOQ's internals. */ + @Deprecated @Support({ FIREBIRD, H2, HSQLDB, MARIADB, MYSQL, POSTGRES, SQLITE }) WithAsStep with(String alias, BiFunction, ? super Integer, ? extends String> fieldNameFunction); diff --git a/jOOQ/src/main/java/org/jooq/impl/DSL.java b/jOOQ/src/main/java/org/jooq/impl/DSL.java index 18e4d8af6b..db23360bd7 100644 --- a/jOOQ/src/main/java/org/jooq/impl/DSL.java +++ b/jOOQ/src/main/java/org/jooq/impl/DSL.java @@ -869,7 +869,14 @@ public class DSL { * This works in a similar way as {@link #with(String, String...)}, except * that all column names are produced by a function that receives the CTE's * {@link Select} columns as input. + * + * @deprecated - 3.14.0 - [#10156] - These methods will be removed without + * replacement from a future jOOQ. They offer convenience that + * is unidiomatic for jOOQ's DSL, without offering functionality + * that would not be possible otherwise - yet they add + * complexity in jOOQ's internals. */ + @Deprecated @Support({ FIREBIRD, H2, HSQLDB, MARIADB, MYSQL, POSTGRES, SQLITE }) public static WithAsStep with(String alias, Function, ? extends String> fieldNameFunction) { return new WithImpl(null, false).with(alias, fieldNameFunction); @@ -1864,7 +1871,14 @@ public class DSL { * This works in a similar way as {@link #with(String, String...)}, except * that all column names are produced by a function that receives the CTE's * {@link Select} columns as input. + * + * @deprecated - 3.14.0 - [#10156] - These methods will be removed without + * replacement from a future jOOQ. They offer convenience that + * is unidiomatic for jOOQ's DSL, without offering functionality + * that would not be possible otherwise - yet they add + * complexity in jOOQ's internals. */ + @Deprecated @Support({ FIREBIRD, H2, HSQLDB, MARIADB, MYSQL, POSTGRES, SQLITE }) public static WithAsStep withRecursive(String alias, Function, ? extends String> fieldNameFunction) { return new WithImpl(null, true).with(alias, fieldNameFunction); @@ -7046,7 +7060,13 @@ public class DSL { * using a function. * * @see DSLContext#createView(String, String...) + * @deprecated - 3.14.0 - [#10156] - These methods will be removed without + * replacement from a future jOOQ. They offer convenience that + * is unidiomatic for jOOQ's DSL, without offering functionality + * that would not be possible otherwise - yet they add + * complexity in jOOQ's internals. */ + @Deprecated @Support public static CreateViewAsStep createView(String view, Function, ? extends String> fieldNameFunction) { return dsl().createView(view, fieldNameFunction); @@ -7060,7 +7080,13 @@ public class DSL { * using a function. * * @see DSLContext#createView(Name, Name...) + * @deprecated - 3.14.0 - [#10156] - These methods will be removed without + * replacement from a future jOOQ. They offer convenience that + * is unidiomatic for jOOQ's DSL, without offering functionality + * that would not be possible otherwise - yet they add + * complexity in jOOQ's internals. */ + @Deprecated @Support public static CreateViewAsStep createView(Name view, Function, ? extends Name> fieldNameFunction) { return dsl().createView(view, fieldNameFunction); @@ -7074,7 +7100,13 @@ public class DSL { * using a function. * * @see DSLContext#createView(Table, Field...) + * @deprecated - 3.14.0 - [#10156] - These methods will be removed without + * replacement from a future jOOQ. They offer convenience that + * is unidiomatic for jOOQ's DSL, without offering functionality + * that would not be possible otherwise - yet they add + * complexity in jOOQ's internals. */ + @Deprecated @Support public static CreateViewAsStep createView(Table view, Function, ? extends Field> fieldNameFunction) { return dsl().createView(view, fieldNameFunction); @@ -7120,7 +7152,13 @@ public class DSL { * using a function. * * @see DSLContext#createOrReplaceView(String, String...) + * @deprecated - 3.14.0 - [#10156] - These methods will be removed without + * replacement from a future jOOQ. They offer convenience that + * is unidiomatic for jOOQ's DSL, without offering functionality + * that would not be possible otherwise - yet they add + * complexity in jOOQ's internals. */ + @Deprecated @Support({ FIREBIRD, H2, MARIADB, MYSQL, POSTGRES }) public static CreateViewAsStep createOrReplaceView(String view, Function, ? extends String> fieldNameFunction) { return dsl().createOrReplaceView(view, fieldNameFunction); @@ -7134,7 +7172,13 @@ public class DSL { * using a function. * * @see DSLContext#createOrReplaceView(Name, Name...) + * @deprecated - 3.14.0 - [#10156] - These methods will be removed without + * replacement from a future jOOQ. They offer convenience that + * is unidiomatic for jOOQ's DSL, without offering functionality + * that would not be possible otherwise - yet they add + * complexity in jOOQ's internals. */ + @Deprecated @Support({ FIREBIRD, H2, MARIADB, MYSQL, POSTGRES }) public static CreateViewAsStep createOrReplaceView(Name view, Function, ? extends Name> fieldNameFunction) { return dsl().createOrReplaceView(view, fieldNameFunction); @@ -7148,7 +7192,13 @@ public class DSL { * using a function. * * @see DSLContext#createOrReplaceView(Table, Field...) + * @deprecated - 3.14.0 - [#10156] - These methods will be removed without + * replacement from a future jOOQ. They offer convenience that + * is unidiomatic for jOOQ's DSL, without offering functionality + * that would not be possible otherwise - yet they add + * complexity in jOOQ's internals. */ + @Deprecated @Support({ FIREBIRD, H2, MARIADB, MYSQL, POSTGRES }) public static CreateViewAsStep createOrReplaceView(Table view, Function, ? extends Field> fieldNameFunction) { return dsl().createOrReplaceView(view, fieldNameFunction); @@ -7194,7 +7244,13 @@ public class DSL { * using a function. * * @see DSLContext#createViewIfNotExists(String, String...) + * @deprecated - 3.14.0 - [#10156] - These methods will be removed without + * replacement from a future jOOQ. They offer convenience that + * is unidiomatic for jOOQ's DSL, without offering functionality + * that would not be possible otherwise - yet they add + * complexity in jOOQ's internals. */ + @Deprecated @Support({ FIREBIRD, H2, HSQLDB, MARIADB, MYSQL, POSTGRES, SQLITE }) public static CreateViewAsStep createViewIfNotExists(String view, Function, ? extends String> fieldNameFunction) { return dsl().createViewIfNotExists(view, fieldNameFunction); @@ -7208,7 +7264,13 @@ public class DSL { * using a function. * * @see DSLContext#createViewIfNotExists(Name, Name...) + * @deprecated - 3.14.0 - [#10156] - These methods will be removed without + * replacement from a future jOOQ. They offer convenience that + * is unidiomatic for jOOQ's DSL, without offering functionality + * that would not be possible otherwise - yet they add + * complexity in jOOQ's internals. */ + @Deprecated @Support({ FIREBIRD, H2, HSQLDB, MARIADB, MYSQL, POSTGRES, SQLITE }) public static CreateViewAsStep createViewIfNotExists(Name view, Function, ? extends Name> fieldNameFunction) { return dsl().createViewIfNotExists(view, fieldNameFunction); @@ -7222,7 +7284,13 @@ public class DSL { * using a function. * * @see DSLContext#createViewIfNotExists(Table, Field...) + * @deprecated - 3.14.0 - [#10156] - These methods will be removed without + * replacement from a future jOOQ. They offer convenience that + * is unidiomatic for jOOQ's DSL, without offering functionality + * that would not be possible otherwise - yet they add + * complexity in jOOQ's internals. */ + @Deprecated @Support({ FIREBIRD, H2, HSQLDB, MARIADB, MYSQL, POSTGRES, SQLITE }) public static CreateViewAsStep createViewIfNotExists(Table view, Function, ? extends Field> fieldNameFunction) { return dsl().createViewIfNotExists(view, fieldNameFunction);