[jOOQ/jOOQ#9372] Improve SEMI / ANTI JOIN documentation

This commit is contained in:
Lukas Eder 2019-10-15 11:34:09 +02:00
parent 4acb3b85e4
commit 4d7d1a4dd8
2 changed files with 28 additions and 0 deletions

View File

@ -1584,6 +1584,13 @@ public interface SelectJoinStep<R extends Record> extends SelectWhereStep<R> {
* SELECT 1 FROM B WHERE A.ID = B.ID
* )
* </pre></code>
* <p>
* Notice that according to
* <a href="https://en.wikipedia.org/wiki/Relational_algebra">Relational
* algebra's</a> understanding of left semi join, the right hand side of the
* left semi join operator is not projected, i.e. it cannot be accessed from
* <code>WHERE</code> or <code>SELECT</code> or any other clause than
* <code>ON</code>.
*
* @see Table#leftSemiJoin(TableLike)
*/
@ -1607,6 +1614,13 @@ public interface SelectJoinStep<R extends Record> extends SelectWhereStep<R> {
* SELECT 1 FROM B WHERE A.ID = B.ID
* )
* </pre></code>
* <p>
* Notice that according to
* <a href="https://en.wikipedia.org/wiki/Relational_algebra">Relational
* algebra's</a> understanding of left semi join, the right hand side of the
* left semi join operator is not projected, i.e. it cannot be accessed from
* <code>WHERE</code> or <code>SELECT</code> or any other clause than
* <code>ON</code>.
*
* @see Table#leftAntiJoin(TableLike)
*/

View File

@ -2687,6 +2687,13 @@ public interface Table<R extends Record> extends TableLike<R>, Named {
* SELECT 1 FROM B WHERE A.ID = B.ID
* )
* </pre></code>
* <p>
* Notice that according to
* <a href="https://en.wikipedia.org/wiki/Relational_algebra">Relational
* algebra's</a> understanding of left semi join, the right hand side of the
* left semi join operator is not projected, i.e. it cannot be accessed from
* <code>WHERE</code> or <code>SELECT</code> or any other clause than
* <code>ON</code>.
*/
@Support
TableOnStep<R> leftSemiJoin(TableLike<?> table);
@ -2708,6 +2715,13 @@ public interface Table<R extends Record> extends TableLike<R>, Named {
* SELECT 1 FROM B WHERE A.ID = B.ID
* )
* </pre></code>
* <p>
* Notice that according to
* <a href="https://en.wikipedia.org/wiki/Relational_algebra">Relational
* algebra's</a> understanding of left anti join, the right hand side of the
* left anti join operator is not projected, i.e. it cannot be accessed from
* <code>WHERE</code> or <code>SELECT</code> or any other clause than
* <code>ON</code>.
*/
@Support
TableOnStep<R> leftAntiJoin(TableLike<?> table);