diff --git a/jOOQ/src/main/java/org/jooq/Row1.java b/jOOQ/src/main/java/org/jooq/Row1.java index 40bc0f7695..0c042d5d67 100644 --- a/jOOQ/src/main/java/org/jooq/Row1.java +++ b/jOOQ/src/main/java/org/jooq/Row1.java @@ -99,8 +99,9 @@ public interface Row1 extends Row, SelectField> { *

* Unlike {@link #mapping(Class, Function1)}, this method attempts to work * without an explicit {@link Class} reference for the underlying - * {@link Converter#toType()}, e.g. when nesting rows in arrays, the class - * literal is required for reflective array creation. + * {@link Converter#toType()}. There may be some edge cases where this + * doesn't work, e.g. when nesting rows in arrays, the class literal is + * required for reflective array creation. *

* Combine this with e.g. {@link Functions#nullOnAllNull(Function1)} or * {@link Functions#nullOnAnyNull(Function1)} to achieve null diff --git a/jOOQ/src/main/java/org/jooq/Row10.java b/jOOQ/src/main/java/org/jooq/Row10.java index 874f051a16..baa785cc5d 100644 --- a/jOOQ/src/main/java/org/jooq/Row10.java +++ b/jOOQ/src/main/java/org/jooq/Row10.java @@ -99,8 +99,9 @@ public interface Row10 extends Row, Sel *

* Unlike {@link #mapping(Class, Function10)}, this method attempts to work * without an explicit {@link Class} reference for the underlying - * {@link Converter#toType()}, e.g. when nesting rows in arrays, the class - * literal is required for reflective array creation. + * {@link Converter#toType()}. There may be some edge cases where this + * doesn't work, e.g. when nesting rows in arrays, the class literal is + * required for reflective array creation. *

* Combine this with e.g. {@link Functions#nullOnAllNull(Function10)} or * {@link Functions#nullOnAnyNull(Function10)} to achieve null diff --git a/jOOQ/src/main/java/org/jooq/Row11.java b/jOOQ/src/main/java/org/jooq/Row11.java index 0d19703ad7..83fd0aedd3 100644 --- a/jOOQ/src/main/java/org/jooq/Row11.java +++ b/jOOQ/src/main/java/org/jooq/Row11.java @@ -99,8 +99,9 @@ public interface Row11 extends Row *

* Unlike {@link #mapping(Class, Function11)}, this method attempts to work * without an explicit {@link Class} reference for the underlying - * {@link Converter#toType()}, e.g. when nesting rows in arrays, the class - * literal is required for reflective array creation. + * {@link Converter#toType()}. There may be some edge cases where this + * doesn't work, e.g. when nesting rows in arrays, the class literal is + * required for reflective array creation. *

* Combine this with e.g. {@link Functions#nullOnAllNull(Function11)} or * {@link Functions#nullOnAnyNull(Function11)} to achieve null diff --git a/jOOQ/src/main/java/org/jooq/Row12.java b/jOOQ/src/main/java/org/jooq/Row12.java index 196721355e..f34acf6a70 100644 --- a/jOOQ/src/main/java/org/jooq/Row12.java +++ b/jOOQ/src/main/java/org/jooq/Row12.java @@ -99,8 +99,9 @@ public interface Row12 extend *

* Unlike {@link #mapping(Class, Function12)}, this method attempts to work * without an explicit {@link Class} reference for the underlying - * {@link Converter#toType()}, e.g. when nesting rows in arrays, the class - * literal is required for reflective array creation. + * {@link Converter#toType()}. There may be some edge cases where this + * doesn't work, e.g. when nesting rows in arrays, the class literal is + * required for reflective array creation. *

* Combine this with e.g. {@link Functions#nullOnAllNull(Function12)} or * {@link Functions#nullOnAnyNull(Function12)} to achieve null diff --git a/jOOQ/src/main/java/org/jooq/Row13.java b/jOOQ/src/main/java/org/jooq/Row13.java index be8baf7e5e..2fd263bb49 100644 --- a/jOOQ/src/main/java/org/jooq/Row13.java +++ b/jOOQ/src/main/java/org/jooq/Row13.java @@ -99,8 +99,9 @@ public interface Row13 e *

* Unlike {@link #mapping(Class, Function13)}, this method attempts to work * without an explicit {@link Class} reference for the underlying - * {@link Converter#toType()}, e.g. when nesting rows in arrays, the class - * literal is required for reflective array creation. + * {@link Converter#toType()}. There may be some edge cases where this + * doesn't work, e.g. when nesting rows in arrays, the class literal is + * required for reflective array creation. *

* Combine this with e.g. {@link Functions#nullOnAllNull(Function13)} or * {@link Functions#nullOnAnyNull(Function13)} to achieve null diff --git a/jOOQ/src/main/java/org/jooq/Row14.java b/jOOQ/src/main/java/org/jooq/Row14.java index d86f765509..3c92466a16 100644 --- a/jOOQ/src/main/java/org/jooq/Row14.java +++ b/jOOQ/src/main/java/org/jooq/Row14.java @@ -99,8 +99,9 @@ public interface Row14 * Unlike {@link #mapping(Class, Function14)}, this method attempts to work * without an explicit {@link Class} reference for the underlying - * {@link Converter#toType()}, e.g. when nesting rows in arrays, the class - * literal is required for reflective array creation. + * {@link Converter#toType()}. There may be some edge cases where this + * doesn't work, e.g. when nesting rows in arrays, the class literal is + * required for reflective array creation. *

* Combine this with e.g. {@link Functions#nullOnAllNull(Function14)} or * {@link Functions#nullOnAnyNull(Function14)} to achieve null diff --git a/jOOQ/src/main/java/org/jooq/Row15.java b/jOOQ/src/main/java/org/jooq/Row15.java index 37b74b1a03..f7a24a8597 100644 --- a/jOOQ/src/main/java/org/jooq/Row15.java +++ b/jOOQ/src/main/java/org/jooq/Row15.java @@ -99,8 +99,9 @@ public interface Row15 * Unlike {@link #mapping(Class, Function15)}, this method attempts to work * without an explicit {@link Class} reference for the underlying - * {@link Converter#toType()}, e.g. when nesting rows in arrays, the class - * literal is required for reflective array creation. + * {@link Converter#toType()}. There may be some edge cases where this + * doesn't work, e.g. when nesting rows in arrays, the class literal is + * required for reflective array creation. *

* Combine this with e.g. {@link Functions#nullOnAllNull(Function15)} or * {@link Functions#nullOnAnyNull(Function15)} to achieve null diff --git a/jOOQ/src/main/java/org/jooq/Row16.java b/jOOQ/src/main/java/org/jooq/Row16.java index f20529a779..3c58d47004 100644 --- a/jOOQ/src/main/java/org/jooq/Row16.java +++ b/jOOQ/src/main/java/org/jooq/Row16.java @@ -99,8 +99,9 @@ public interface Row16 * Unlike {@link #mapping(Class, Function16)}, this method attempts to work * without an explicit {@link Class} reference for the underlying - * {@link Converter#toType()}, e.g. when nesting rows in arrays, the class - * literal is required for reflective array creation. + * {@link Converter#toType()}. There may be some edge cases where this + * doesn't work, e.g. when nesting rows in arrays, the class literal is + * required for reflective array creation. *

* Combine this with e.g. {@link Functions#nullOnAllNull(Function16)} or * {@link Functions#nullOnAnyNull(Function16)} to achieve null diff --git a/jOOQ/src/main/java/org/jooq/Row17.java b/jOOQ/src/main/java/org/jooq/Row17.java index 1878af988e..50ea4767d1 100644 --- a/jOOQ/src/main/java/org/jooq/Row17.java +++ b/jOOQ/src/main/java/org/jooq/Row17.java @@ -99,8 +99,9 @@ public interface Row17 * Unlike {@link #mapping(Class, Function17)}, this method attempts to work * without an explicit {@link Class} reference for the underlying - * {@link Converter#toType()}, e.g. when nesting rows in arrays, the class - * literal is required for reflective array creation. + * {@link Converter#toType()}. There may be some edge cases where this + * doesn't work, e.g. when nesting rows in arrays, the class literal is + * required for reflective array creation. *

* Combine this with e.g. {@link Functions#nullOnAllNull(Function17)} or * {@link Functions#nullOnAnyNull(Function17)} to achieve null diff --git a/jOOQ/src/main/java/org/jooq/Row18.java b/jOOQ/src/main/java/org/jooq/Row18.java index ae1075c0a1..571d5e7c8b 100644 --- a/jOOQ/src/main/java/org/jooq/Row18.java +++ b/jOOQ/src/main/java/org/jooq/Row18.java @@ -99,8 +99,9 @@ public interface Row18 * Unlike {@link #mapping(Class, Function18)}, this method attempts to work * without an explicit {@link Class} reference for the underlying - * {@link Converter#toType()}, e.g. when nesting rows in arrays, the class - * literal is required for reflective array creation. + * {@link Converter#toType()}. There may be some edge cases where this + * doesn't work, e.g. when nesting rows in arrays, the class literal is + * required for reflective array creation. *

* Combine this with e.g. {@link Functions#nullOnAllNull(Function18)} or * {@link Functions#nullOnAnyNull(Function18)} to achieve null diff --git a/jOOQ/src/main/java/org/jooq/Row19.java b/jOOQ/src/main/java/org/jooq/Row19.java index ac3827922b..0bed512ce1 100644 --- a/jOOQ/src/main/java/org/jooq/Row19.java +++ b/jOOQ/src/main/java/org/jooq/Row19.java @@ -99,8 +99,9 @@ public interface Row19 * Unlike {@link #mapping(Class, Function19)}, this method attempts to work * without an explicit {@link Class} reference for the underlying - * {@link Converter#toType()}, e.g. when nesting rows in arrays, the class - * literal is required for reflective array creation. + * {@link Converter#toType()}. There may be some edge cases where this + * doesn't work, e.g. when nesting rows in arrays, the class literal is + * required for reflective array creation. *

* Combine this with e.g. {@link Functions#nullOnAllNull(Function19)} or * {@link Functions#nullOnAnyNull(Function19)} to achieve null diff --git a/jOOQ/src/main/java/org/jooq/Row2.java b/jOOQ/src/main/java/org/jooq/Row2.java index a7fa4b825e..3e42a192f1 100644 --- a/jOOQ/src/main/java/org/jooq/Row2.java +++ b/jOOQ/src/main/java/org/jooq/Row2.java @@ -99,8 +99,9 @@ public interface Row2 extends Row, SelectField> { *

* Unlike {@link #mapping(Class, Function2)}, this method attempts to work * without an explicit {@link Class} reference for the underlying - * {@link Converter#toType()}, e.g. when nesting rows in arrays, the class - * literal is required for reflective array creation. + * {@link Converter#toType()}. There may be some edge cases where this + * doesn't work, e.g. when nesting rows in arrays, the class literal is + * required for reflective array creation. *

* Combine this with e.g. {@link Functions#nullOnAllNull(Function2)} or * {@link Functions#nullOnAnyNull(Function2)} to achieve null diff --git a/jOOQ/src/main/java/org/jooq/Row20.java b/jOOQ/src/main/java/org/jooq/Row20.java index 9e688ad6e9..068a744441 100644 --- a/jOOQ/src/main/java/org/jooq/Row20.java +++ b/jOOQ/src/main/java/org/jooq/Row20.java @@ -99,8 +99,9 @@ public interface Row20 * Unlike {@link #mapping(Class, Function20)}, this method attempts to work * without an explicit {@link Class} reference for the underlying - * {@link Converter#toType()}, e.g. when nesting rows in arrays, the class - * literal is required for reflective array creation. + * {@link Converter#toType()}. There may be some edge cases where this + * doesn't work, e.g. when nesting rows in arrays, the class literal is + * required for reflective array creation. *

* Combine this with e.g. {@link Functions#nullOnAllNull(Function20)} or * {@link Functions#nullOnAnyNull(Function20)} to achieve null diff --git a/jOOQ/src/main/java/org/jooq/Row21.java b/jOOQ/src/main/java/org/jooq/Row21.java index d3b21c1926..2b63157b4b 100644 --- a/jOOQ/src/main/java/org/jooq/Row21.java +++ b/jOOQ/src/main/java/org/jooq/Row21.java @@ -99,8 +99,9 @@ public interface Row21 * Unlike {@link #mapping(Class, Function21)}, this method attempts to work * without an explicit {@link Class} reference for the underlying - * {@link Converter#toType()}, e.g. when nesting rows in arrays, the class - * literal is required for reflective array creation. + * {@link Converter#toType()}. There may be some edge cases where this + * doesn't work, e.g. when nesting rows in arrays, the class literal is + * required for reflective array creation. *

* Combine this with e.g. {@link Functions#nullOnAllNull(Function21)} or * {@link Functions#nullOnAnyNull(Function21)} to achieve null diff --git a/jOOQ/src/main/java/org/jooq/Row22.java b/jOOQ/src/main/java/org/jooq/Row22.java index 28707c6f97..1ad4bdfb21 100644 --- a/jOOQ/src/main/java/org/jooq/Row22.java +++ b/jOOQ/src/main/java/org/jooq/Row22.java @@ -99,8 +99,9 @@ public interface Row22 * Unlike {@link #mapping(Class, Function22)}, this method attempts to work * without an explicit {@link Class} reference for the underlying - * {@link Converter#toType()}, e.g. when nesting rows in arrays, the class - * literal is required for reflective array creation. + * {@link Converter#toType()}. There may be some edge cases where this + * doesn't work, e.g. when nesting rows in arrays, the class literal is + * required for reflective array creation. *

* Combine this with e.g. {@link Functions#nullOnAllNull(Function22)} or * {@link Functions#nullOnAnyNull(Function22)} to achieve null diff --git a/jOOQ/src/main/java/org/jooq/Row3.java b/jOOQ/src/main/java/org/jooq/Row3.java index a5432d5f39..44ce97c932 100644 --- a/jOOQ/src/main/java/org/jooq/Row3.java +++ b/jOOQ/src/main/java/org/jooq/Row3.java @@ -99,8 +99,9 @@ public interface Row3 extends Row, SelectField> *

* Unlike {@link #mapping(Class, Function3)}, this method attempts to work * without an explicit {@link Class} reference for the underlying - * {@link Converter#toType()}, e.g. when nesting rows in arrays, the class - * literal is required for reflective array creation. + * {@link Converter#toType()}. There may be some edge cases where this + * doesn't work, e.g. when nesting rows in arrays, the class literal is + * required for reflective array creation. *

* Combine this with e.g. {@link Functions#nullOnAllNull(Function3)} or * {@link Functions#nullOnAnyNull(Function3)} to achieve null diff --git a/jOOQ/src/main/java/org/jooq/Row4.java b/jOOQ/src/main/java/org/jooq/Row4.java index ae56935c15..122c40ce10 100644 --- a/jOOQ/src/main/java/org/jooq/Row4.java +++ b/jOOQ/src/main/java/org/jooq/Row4.java @@ -99,8 +99,9 @@ public interface Row4 extends Row, SelectField * Unlike {@link #mapping(Class, Function4)}, this method attempts to work * without an explicit {@link Class} reference for the underlying - * {@link Converter#toType()}, e.g. when nesting rows in arrays, the class - * literal is required for reflective array creation. + * {@link Converter#toType()}. There may be some edge cases where this + * doesn't work, e.g. when nesting rows in arrays, the class literal is + * required for reflective array creation. *

* Combine this with e.g. {@link Functions#nullOnAllNull(Function4)} or * {@link Functions#nullOnAnyNull(Function4)} to achieve null diff --git a/jOOQ/src/main/java/org/jooq/Row5.java b/jOOQ/src/main/java/org/jooq/Row5.java index a29547dc6f..afe285c474 100644 --- a/jOOQ/src/main/java/org/jooq/Row5.java +++ b/jOOQ/src/main/java/org/jooq/Row5.java @@ -99,8 +99,9 @@ public interface Row5 extends Row, SelectField * Unlike {@link #mapping(Class, Function5)}, this method attempts to work * without an explicit {@link Class} reference for the underlying - * {@link Converter#toType()}, e.g. when nesting rows in arrays, the class - * literal is required for reflective array creation. + * {@link Converter#toType()}. There may be some edge cases where this + * doesn't work, e.g. when nesting rows in arrays, the class literal is + * required for reflective array creation. *

* Combine this with e.g. {@link Functions#nullOnAllNull(Function5)} or * {@link Functions#nullOnAnyNull(Function5)} to achieve null diff --git a/jOOQ/src/main/java/org/jooq/Row6.java b/jOOQ/src/main/java/org/jooq/Row6.java index 94f6256327..4842efc5d4 100644 --- a/jOOQ/src/main/java/org/jooq/Row6.java +++ b/jOOQ/src/main/java/org/jooq/Row6.java @@ -99,8 +99,9 @@ public interface Row6 extends Row, SelectField * Unlike {@link #mapping(Class, Function6)}, this method attempts to work * without an explicit {@link Class} reference for the underlying - * {@link Converter#toType()}, e.g. when nesting rows in arrays, the class - * literal is required for reflective array creation. + * {@link Converter#toType()}. There may be some edge cases where this + * doesn't work, e.g. when nesting rows in arrays, the class literal is + * required for reflective array creation. *

* Combine this with e.g. {@link Functions#nullOnAllNull(Function6)} or * {@link Functions#nullOnAnyNull(Function6)} to achieve null diff --git a/jOOQ/src/main/java/org/jooq/Row7.java b/jOOQ/src/main/java/org/jooq/Row7.java index 60d6e953d2..fa1b9b9439 100644 --- a/jOOQ/src/main/java/org/jooq/Row7.java +++ b/jOOQ/src/main/java/org/jooq/Row7.java @@ -99,8 +99,9 @@ public interface Row7 extends Row, SelectField * Unlike {@link #mapping(Class, Function7)}, this method attempts to work * without an explicit {@link Class} reference for the underlying - * {@link Converter#toType()}, e.g. when nesting rows in arrays, the class - * literal is required for reflective array creation. + * {@link Converter#toType()}. There may be some edge cases where this + * doesn't work, e.g. when nesting rows in arrays, the class literal is + * required for reflective array creation. *

* Combine this with e.g. {@link Functions#nullOnAllNull(Function7)} or * {@link Functions#nullOnAnyNull(Function7)} to achieve null diff --git a/jOOQ/src/main/java/org/jooq/Row8.java b/jOOQ/src/main/java/org/jooq/Row8.java index 9d94b05735..85bb599bc4 100644 --- a/jOOQ/src/main/java/org/jooq/Row8.java +++ b/jOOQ/src/main/java/org/jooq/Row8.java @@ -99,8 +99,9 @@ public interface Row8 extends Row, SelectField * Unlike {@link #mapping(Class, Function8)}, this method attempts to work * without an explicit {@link Class} reference for the underlying - * {@link Converter#toType()}, e.g. when nesting rows in arrays, the class - * literal is required for reflective array creation. + * {@link Converter#toType()}. There may be some edge cases where this + * doesn't work, e.g. when nesting rows in arrays, the class literal is + * required for reflective array creation. *

* Combine this with e.g. {@link Functions#nullOnAllNull(Function8)} or * {@link Functions#nullOnAnyNull(Function8)} to achieve null diff --git a/jOOQ/src/main/java/org/jooq/Row9.java b/jOOQ/src/main/java/org/jooq/Row9.java index 2040a05c8e..899fda843d 100644 --- a/jOOQ/src/main/java/org/jooq/Row9.java +++ b/jOOQ/src/main/java/org/jooq/Row9.java @@ -99,8 +99,9 @@ public interface Row9 extends Row, SelectFie *

* Unlike {@link #mapping(Class, Function9)}, this method attempts to work * without an explicit {@link Class} reference for the underlying - * {@link Converter#toType()}, e.g. when nesting rows in arrays, the class - * literal is required for reflective array creation. + * {@link Converter#toType()}. There may be some edge cases where this + * doesn't work, e.g. when nesting rows in arrays, the class literal is + * required for reflective array creation. *

* Combine this with e.g. {@link Functions#nullOnAllNull(Function9)} or * {@link Functions#nullOnAnyNull(Function9)} to achieve null diff --git a/jOOQ/src/main/java/org/jooq/RowN.java b/jOOQ/src/main/java/org/jooq/RowN.java index bee86495c0..c44e981bda 100644 --- a/jOOQ/src/main/java/org/jooq/RowN.java +++ b/jOOQ/src/main/java/org/jooq/RowN.java @@ -99,8 +99,9 @@ public interface RowN extends Row, SelectField { *

* Unlike {@link #mapping(Class, Function)}, this method attempts to work * without an explicit {@link Class} reference for the underlying - * {@link Converter#toType()}, e.g. when nesting rows in arrays, the class - * literal is required for reflective array creation. + * {@link Converter#toType()}. There may be some edge cases where this + * doesn't work, e.g. when nesting rows in arrays, the class literal is + * required for reflective array creation. */ @NotNull SelectField mapping(Function function); diff --git a/jOOQ/src/main/java/org/jooq/SelectField.java b/jOOQ/src/main/java/org/jooq/SelectField.java index f8d44fc254..0f698df2db 100644 --- a/jOOQ/src/main/java/org/jooq/SelectField.java +++ b/jOOQ/src/main/java/org/jooq/SelectField.java @@ -187,11 +187,11 @@ public /* non-sealed */ interface SelectField extends SelectFieldOrAsterisk, * allows for creating a derived field expression with an ad-hoc data type * converter for single query usage. *

- * EXPERIMENTAL. Unlike {@link #convertFrom(Class, Function)}, this method - * attempts to work without an explicit {@link Class} reference for the underlying - * {@link Converter#toType()}. There may be some edge cases where this doesn't - * work. Please report any bugs here: - * https://github.com/jOOQ/jOOQ/issues/new/choose + * Unlike {@link #convertFrom(Class, Function)}, this method attempts to + * work without an explicit {@link Class} reference for the underlying + * {@link Converter#toType()}. There may be some edge cases where this + * doesn't work, e.g. when nesting rows in arrays, the class literal is + * required for reflective array creation. * * @param The user type. * @param converter The read-only converter to be applied on any operations @@ -229,11 +229,11 @@ public /* non-sealed */ interface SelectField extends SelectFieldOrAsterisk, * allows for creating a derived field expression with an ad-hoc data type * converter for single query usage. *

- * EXPERIMENTAL. Unlike {@link #convertTo(Class, Function)}, this method - * attempts to work without an explicit {@link Class} reference for the underlying - * {@link Converter#toType()}. There may be some edge cases where this doesn't - * work. Please report any bugs here: - * https://github.com/jOOQ/jOOQ/issues/new/choose + * Unlike {@link #convertTo(Class, Function)}, this method attempts to work + * without an explicit {@link Class} reference for the underlying + * {@link Converter#toType()}. There may be some edge cases where this + * doesn't work, e.g. when nesting rows in arrays, the class literal is + * required for reflective array creation. * * @param The user type. * @param converter The write-only converter to be applied on any operations