From bae364033b60703fb677d1c71d2b700a82559e81 Mon Sep 17 00:00:00 2001
From: Lukas Eder <lukas.eder@datageekery.com>
Date: Thu, 19 Sep 2024 14:25:17 +0200
Subject: [PATCH] [jOOQ/jOOQ#4819] Document the fact that org.jooq.Binding does
 not necessarily have to implement a complete org.jooq.Converter

---
 jOOQ/src/main/java/org/jooq/Binding.java | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/jOOQ/src/main/java/org/jooq/Binding.java b/jOOQ/src/main/java/org/jooq/Binding.java
index eb1e40cb6a..78af35f0b2 100644
--- a/jOOQ/src/main/java/org/jooq/Binding.java
+++ b/jOOQ/src/main/java/org/jooq/Binding.java
@@ -82,6 +82,12 @@ public interface Binding<T, U> extends Serializable {
     /**
      * A converter that can convert between the database type and the custom
      * type.
+     * <p>
+     * While the {@link Converter} property of a binding is not optional
+     * ({@link Converter#fromType()} and {@link Converter#toType()} are needed
+     * by jOOQ's internals), the conversion implementation (i.e.
+     * {@link Converter#from(Object)} and {@link Converter#to(Object)}) isn't
+     * strictly required if implementations don't rely on it.
      */
     @NotNull
     Converter<T, U> converter();