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

[jOOQ/jOOQ#3862] Improve Javadoc on DSLContext.executeInsert(), executeUpdate(), and executeDelete() about optimistic locking not applying

Browse Source
This commit is contained in:
Lukas Eder 2023-05-30 10:56:54 +02:00
parent 9b969d41cf
commit c2c5cd72af
1 changed files with 51 additions and 8 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

59
jOOQ/src/main/java/org/jooq/DSLContext.java
View File

@ -14795,13 +14795,20 @@ public interface DSLContext extends Scope {
/**
* Insert one record.
* <p>
* This executes something like the following statement:
* <pre><code>INSERT INTO [table] … VALUES [record] </code></pre>
* This executes the following statement:
*
* <pre>
* <code>INSERT INTO [table] ([modified columns in record])
* VALUES ([modified values in record])</code>
* </pre>
* <p>
* Unlike {@link UpdatableRecord#store()}, this does not change any of the
* Unlike {@link UpdatableRecord#insert()}, this does not change any of the
* argument <code>record</code>'s internal "changed" flags, such that a
* subsequent call to {@link UpdatableRecord#store()} might lead to another
* subsequent call to {@link UpdatableRecord#insert()} might lead to another
* <code>INSERT</code> statement being executed.
* <p>
* Also any optimistic locking related {@link Settings} do not apply for
* this method.
*
* @return The number of inserted records
* @throws DataAccessException if something went wrong executing the query
@ -14812,7 +14819,17 @@ public interface DSLContext extends Scope {
/**
* Update a table.
* <pre><code>UPDATE [table] SET [modified values in record] WHERE [record is supplied record] </code></pre>
* <p>
* This executes the following statement:
*
* <pre>
* <code>UPDATE [table]
* SET [modified values in record]
* WHERE [record is supplied record]</code>
* </pre>
* <p>
* Any optimistic locking related {@link Settings} do not apply for this
* method.
*
* @return The number of updated records
* @throws DataAccessException if something went wrong executing the query
@ -14823,7 +14840,17 @@ public interface DSLContext extends Scope {
/**
* Update a table.
* <pre><code>UPDATE [table] SET [modified values in record] WHERE [condition]</code></pre>
* <p>
* This executes the following statement:
*
* <pre>
* <code>UPDATE [table]
* SET [modified values in record]
* WHERE [condition]</code>
* </pre>
* <p>
* Any optimistic locking related {@link Settings} do not apply for this
* method.
*
* @return The number of updated records
* @throws DataAccessException if something went wrong executing the query
@ -14834,7 +14861,15 @@ public interface DSLContext extends Scope {
/**
* Delete a record from a table.
* <pre><code>DELETE FROM [table] WHERE [record is supplied record]</code></pre>
* <p>
* This executes the following statement:
*
* <pre>
* <code>DELETE FROM [table] WHERE [record is supplied record]</code>
* </pre>
* <p>
* Any optimistic locking related {@link Settings} do not apply for this
* method.
*
* @return The number of deleted records
* @throws DataAccessException if something went wrong executing the query
@ -14845,7 +14880,15 @@ public interface DSLContext extends Scope {
/**
* Delete a record from a table.
* <pre><code>DELETE FROM [table] WHERE [condition]</code></pre>
* <p>
* This executes the following statement:
*
* <pre>
* <code>DELETE FROM [table] WHERE [condition]</code>
* </pre>
* <p>
* Any optimistic locking related {@link Settings} do not apply for this
* method.
*
* @return The number of deleted records
* @throws DataAccessException if something went wrong executing the query