From e9bc9cf5cb98b3cfe235761d821d48e302a85d77 Mon Sep 17 00:00:00 2001
From: Lukas Eder <lukas.eder@gmail.com>
Date: Tue, 17 Jan 2023 15:41:27 +0100
Subject: [PATCH] [jOOQ/jOOQ#14510] Add Field<T>.comment(Comment): Field<T>

---
 jOOQ/src/main/java/org/jooq/Field.java           | 16 ++++++++++++++++
 .../main/java/org/jooq/impl/AbstractField.java   | 14 ++++++++++++++
 2 files changed, 30 insertions(+)

diff --git a/jOOQ/src/main/java/org/jooq/Field.java b/jOOQ/src/main/java/org/jooq/Field.java
index 0cc5526176..8ab184ce32 100644
--- a/jOOQ/src/main/java/org/jooq/Field.java
+++ b/jOOQ/src/main/java/org/jooq/Field.java
@@ -287,6 +287,22 @@ extends
     @NotNull
     <U> Field<U> convertTo(Function<? super U, ? extends T> to);
 
+    // ------------------------------------------------------------------------
+    // DDL API
+    // ------------------------------------------------------------------------
+
+    /**
+     * Attach a {@link Comment} to this field, for use in DDL statements, such
+     * as {@link DSLContext#createTable(Table)}.
+     */
+    Field<T> comment(String comment);
+
+    /**
+     * Attach a {@link Comment} to this field, for use in DDL statements, such
+     * as {@link DSLContext#createTable(Table)}.
+     */
+    Field<T> comment(Comment comment);
+
     // ------------------------------------------------------------------------
     // Type casts
     // ------------------------------------------------------------------------
diff --git a/jOOQ/src/main/java/org/jooq/impl/AbstractField.java b/jOOQ/src/main/java/org/jooq/impl/AbstractField.java
index ed6cf7e16b..d6227b9a7b 100644
--- a/jOOQ/src/main/java/org/jooq/impl/AbstractField.java
+++ b/jOOQ/src/main/java/org/jooq/impl/AbstractField.java
@@ -266,6 +266,20 @@ implements
         return as(aliasFunction.apply(this));
     }
 
+    // ------------------------------------------------------------------------
+    // XXX: DDL API
+    // ------------------------------------------------------------------------
+
+    @Override
+    public final Field<T> comment(String comment) {
+        return comment(DSL.comment(comment));
+    }
+
+    @Override
+    public final Field<T> comment(Comment comment) {
+        return DSL.field(getQualifiedName(), getDataType(), comment);
+    }
+
     // ------------------------------------------------------------------------
     // XXX: Type casts
     // ------------------------------------------------------------------------