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

[jOOQ/jOOQ#16918] Clarify in manual and Javadoc that NoXYZ QueryParts

Browse Source 
are to be used only with the DSL API, not with the QOM API
This commit is contained in:
Lukas Eder 2024-07-05 15:15:09 +02:00
parent 5f30434b0a
commit 45fa639f97
1 changed files with 30 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

30
jOOQ/src/main/java/org/jooq/impl/DSL.java
View File

@ -13398,6 +13398,11 @@ public class DSL {
* query or not. In case that clause accepts tables, the {@link #noTable()}
* can be used to avoid creating a <code>FROM</code> clause or a join
* operation.
* <p>
* <b>NOTE [#16918]</b> that this {@link Table} is meant to be used with the
* {@link DSL} API only, not with the {@link QOM} API, which cannot offer
* any no-op operations. The behaviour when used with the {@link QOM} API is
* undefined.
*/
@NotNull
@Support
@ -13428,6 +13433,11 @@ public class DSL {
* In clauses that project fields to a given {@link Record} type, the
* {@link #noField()} simply projects <code>NULL</code> and cannot be used
* to avoid the clause.
* <p>
* <b>NOTE [#16918]</b> that this {@link Field} is meant to be used with the
* {@link DSL} API only, not with the {@link QOM} API, which cannot offer
* any no-op operations. The behaviour when used with the {@link QOM} API is
* undefined.
*/
@NotNull
@Support
@ -13464,6 +13474,11 @@ public class DSL {
* {@link SQLDataType}. If you're using any custom data types by means of a
* {@link Converter} or {@link Binding}, it's better to pass that converted
* {@link DataType} reference explicitly to {@link #noField(DataType)}.
* <p>
* <b>NOTE [#16918]</b> that this {@link Field} is meant to be used with the
* {@link DSL} API only, not with the {@link QOM} API, which cannot offer
* any no-op operations. The behaviour when used with the {@link QOM} API is
* undefined.
*
* @param type A class to derive the {@link Field#getDataType()} from.
*/
@ -13496,6 +13511,11 @@ public class DSL {
* In clauses that project fields to a given {@link Record} type, the
* {@link #noField()} simply projects <code>NULL</code> and cannot be used
* to avoid the clause.
* <p>
* <b>NOTE [#16918]</b> that this {@link Field} is meant to be used with the
* {@link DSL} API only, not with the {@link QOM} API, which cannot offer
* any no-op operations. The behaviour when used with the {@link QOM} API is
* undefined.
*
* @param type A type to derive the {@link Field#getDataType()} from.
*/
@ -13528,6 +13548,11 @@ public class DSL {
* In clauses that project fields to a given {@link Record} type, the
* {@link #noField()} simply projects <code>NULL</code> and cannot be used
* to avoid the clause.
* <p>
* <b>NOTE [#16918]</b> that this {@link Field} is meant to be used with the
* {@link DSL} API only, not with the {@link QOM} API, which cannot offer
* any no-op operations. The behaviour when used with the {@link QOM} API is
* undefined.
*
* @param type A field to derive the {@link Field#getDataType()} from.
*/
@ -16460,6 +16485,11 @@ public class DSL {
* <pre><code>
* SELECT * FROM t
* </code></pre>
* <p>
* <b>NOTE [#16918]</b> that this {@link Condition} is meant to be used with the
* {@link DSL} API only, not with the {@link QOM} API, which cannot offer
* any no-op operations. The behaviour when used with the {@link QOM} API is
* undefined.
*/
@NotNull
@Support