github/jooq
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

[jOOQ/jOOQ#13072] Remove EXPERIMENTAL status also from convertFrom() and convertTo()

Browse Source
This commit is contained in:
Lukas Eder 2022-02-21 16:07:22 +01:00
parent 95125b7f57
commit 04da361d9b
24 changed files with 79 additions and 56 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

5
jOOQ/src/main/java/org/jooq/Row1.java
View File

@ -99,8 +99,9 @@ public interface Row1<T1> extends Row, SelectField<Record1<T1>> {
* <p>
* 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.
* <p>
* Combine this with e.g. {@link Functions#nullOnAllNull(Function1)} or
* {@link Functions#nullOnAnyNull(Function1)} to achieve <code>null</code>

5
jOOQ/src/main/java/org/jooq/Row10.java
View File

@ -99,8 +99,9 @@ public interface Row10<T1, T2, T3, T4, T5, T6, T7, T8, T9, T10> extends Row, Sel
* <p>
* 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.
* <p>
* Combine this with e.g. {@link Functions#nullOnAllNull(Function10)} or
* {@link Functions#nullOnAnyNull(Function10)} to achieve <code>null</code>

5
jOOQ/src/main/java/org/jooq/Row11.java
View File

@ -99,8 +99,9 @@ public interface Row11<T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11> extends Row
* <p>
* 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.
* <p>
* Combine this with e.g. {@link Functions#nullOnAllNull(Function11)} or
* {@link Functions#nullOnAnyNull(Function11)} to achieve <code>null</code>

5
jOOQ/src/main/java/org/jooq/Row12.java
View File

@ -99,8 +99,9 @@ public interface Row12<T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12> extend
* <p>
* 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.
* <p>
* Combine this with e.g. {@link Functions#nullOnAllNull(Function12)} or
* {@link Functions#nullOnAnyNull(Function12)} to achieve <code>null</code>

5
jOOQ/src/main/java/org/jooq/Row13.java
View File

@ -99,8 +99,9 @@ public interface Row13<T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13> e
* <p>
* 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.
* <p>
* Combine this with e.g. {@link Functions#nullOnAllNull(Function13)} or
* {@link Functions#nullOnAnyNull(Function13)} to achieve <code>null</code>

5
jOOQ/src/main/java/org/jooq/Row14.java
View File

@ -99,8 +99,9 @@ public interface Row14<T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T
* <p>
* 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.
* <p>
* Combine this with e.g. {@link Functions#nullOnAllNull(Function14)} or
* {@link Functions#nullOnAnyNull(Function14)} to achieve <code>null</code>

5
jOOQ/src/main/java/org/jooq/Row15.java
View File

@ -99,8 +99,9 @@ public interface Row15<T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T
* <p>
* 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.
* <p>
* Combine this with e.g. {@link Functions#nullOnAllNull(Function15)} or
* {@link Functions#nullOnAnyNull(Function15)} to achieve <code>null</code>

5
jOOQ/src/main/java/org/jooq/Row16.java
View File

@ -99,8 +99,9 @@ public interface Row16<T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T
* <p>
* 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.
* <p>
* Combine this with e.g. {@link Functions#nullOnAllNull(Function16)} or
* {@link Functions#nullOnAnyNull(Function16)} to achieve <code>null</code>

5
jOOQ/src/main/java/org/jooq/Row17.java
View File

@ -99,8 +99,9 @@ public interface Row17<T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T
* <p>
* 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.
* <p>
* Combine this with e.g. {@link Functions#nullOnAllNull(Function17)} or
* {@link Functions#nullOnAnyNull(Function17)} to achieve <code>null</code>

5
jOOQ/src/main/java/org/jooq/Row18.java
View File

@ -99,8 +99,9 @@ public interface Row18<T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T
* <p>
* 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.
* <p>
* Combine this with e.g. {@link Functions#nullOnAllNull(Function18)} or
* {@link Functions#nullOnAnyNull(Function18)} to achieve <code>null</code>

5
jOOQ/src/main/java/org/jooq/Row19.java
View File

@ -99,8 +99,9 @@ public interface Row19<T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T
* <p>
* 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.
* <p>
* Combine this with e.g. {@link Functions#nullOnAllNull(Function19)} or
* {@link Functions#nullOnAnyNull(Function19)} to achieve <code>null</code>

5
jOOQ/src/main/java/org/jooq/Row2.java
View File

@ -99,8 +99,9 @@ public interface Row2<T1, T2> extends Row, SelectField<Record2<T1, T2>> {
* <p>
* 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.
* <p>
* Combine this with e.g. {@link Functions#nullOnAllNull(Function2)} or
* {@link Functions#nullOnAnyNull(Function2)} to achieve <code>null</code>

5
jOOQ/src/main/java/org/jooq/Row20.java
View File

@ -99,8 +99,9 @@ public interface Row20<T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T
* <p>
* 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.
* <p>
* Combine this with e.g. {@link Functions#nullOnAllNull(Function20)} or
* {@link Functions#nullOnAnyNull(Function20)} to achieve <code>null</code>

5
jOOQ/src/main/java/org/jooq/Row21.java
View File

@ -99,8 +99,9 @@ public interface Row21<T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T
* <p>
* 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.
* <p>
* Combine this with e.g. {@link Functions#nullOnAllNull(Function21)} or
* {@link Functions#nullOnAnyNull(Function21)} to achieve <code>null</code>

5
jOOQ/src/main/java/org/jooq/Row22.java
View File

@ -99,8 +99,9 @@ public interface Row22<T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T
* <p>
* 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.
* <p>
* Combine this with e.g. {@link Functions#nullOnAllNull(Function22)} or
* {@link Functions#nullOnAnyNull(Function22)} to achieve <code>null</code>

5
jOOQ/src/main/java/org/jooq/Row3.java
View File

@ -99,8 +99,9 @@ public interface Row3<T1, T2, T3> extends Row, SelectField<Record3<T1, T2, T3>>
* <p>
* 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.
* <p>
* Combine this with e.g. {@link Functions#nullOnAllNull(Function3)} or
* {@link Functions#nullOnAnyNull(Function3)} to achieve <code>null</code>

5
jOOQ/src/main/java/org/jooq/Row4.java
View File

@ -99,8 +99,9 @@ public interface Row4<T1, T2, T3, T4> extends Row, SelectField<Record4<T1, T2, T
* <p>
* 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.
* <p>
* Combine this with e.g. {@link Functions#nullOnAllNull(Function4)} or
* {@link Functions#nullOnAnyNull(Function4)} to achieve <code>null</code>

5
jOOQ/src/main/java/org/jooq/Row5.java
View File

@ -99,8 +99,9 @@ public interface Row5<T1, T2, T3, T4, T5> extends Row, SelectField<Record5<T1, T
* <p>
* 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.
* <p>
* Combine this with e.g. {@link Functions#nullOnAllNull(Function5)} or
* {@link Functions#nullOnAnyNull(Function5)} to achieve <code>null</code>

5
jOOQ/src/main/java/org/jooq/Row6.java
View File

@ -99,8 +99,9 @@ public interface Row6<T1, T2, T3, T4, T5, T6> extends Row, SelectField<Record6<T
* <p>
* 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.
* <p>
* Combine this with e.g. {@link Functions#nullOnAllNull(Function6)} or
* {@link Functions#nullOnAnyNull(Function6)} to achieve <code>null</code>

5
jOOQ/src/main/java/org/jooq/Row7.java
View File

@ -99,8 +99,9 @@ public interface Row7<T1, T2, T3, T4, T5, T6, T7> extends Row, SelectField<Recor
* <p>
* 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.
* <p>
* Combine this with e.g. {@link Functions#nullOnAllNull(Function7)} or
* {@link Functions#nullOnAnyNull(Function7)} to achieve <code>null</code>

5
jOOQ/src/main/java/org/jooq/Row8.java
View File

@ -99,8 +99,9 @@ public interface Row8<T1, T2, T3, T4, T5, T6, T7, T8> extends Row, SelectField<R
* <p>
* 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.
* <p>
* Combine this with e.g. {@link Functions#nullOnAllNull(Function8)} or
* {@link Functions#nullOnAnyNull(Function8)} to achieve <code>null</code>

5
jOOQ/src/main/java/org/jooq/Row9.java
View File

@ -99,8 +99,9 @@ public interface Row9<T1, T2, T3, T4, T5, T6, T7, T8, T9> extends Row, SelectFie
* <p>
* 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.
* <p>
* Combine this with e.g. {@link Functions#nullOnAllNull(Function9)} or
* {@link Functions#nullOnAnyNull(Function9)} to achieve <code>null</code>

5
jOOQ/src/main/java/org/jooq/RowN.java
View File

@ -99,8 +99,9 @@ public interface RowN extends Row, SelectField<Record> {
* <p>
* 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
<U> SelectField<U> mapping(Function<? super Object[], ? extends U> function);

20
jOOQ/src/main/java/org/jooq/SelectField.java
View File

@ -187,11 +187,11 @@ public /* non-sealed */ interface SelectField<T> extends SelectFieldOrAsterisk,
* allows for creating a derived field expression with an ad-hoc data type
* converter for single query usage.
* <p>
* 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:
* <a href="https://github.com/jOOQ/jOOQ/issues/new/choose">https://github.com/jOOQ/jOOQ/issues/new/choose</a>
* 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 <U> The user type.
* @param converter The read-only converter to be applied on any operations
@ -229,11 +229,11 @@ public /* non-sealed */ interface SelectField<T> extends SelectFieldOrAsterisk,
* allows for creating a derived field expression with an ad-hoc data type
* converter for single query usage.
* <p>
* 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:
* <a href="https://github.com/jOOQ/jOOQ/issues/new/choose">https://github.com/jOOQ/jOOQ/issues/new/choose</a>
* 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 <U> The user type.
* @param converter The write-only converter to be applied on any operations