fixup! In the convenience methods for join, make column equality op…

…tional
JetBrains · Jan 15, 2024 · 08d0a35 · 08d0a35
1 parent 57ed329
commit 08d0a35
Showing 1 changed file with 10 additions and 0 deletions.
diff --git a/exposed-core/src/main/kotlin/org/jetbrains/exposed/sql/Table.kt b/exposed-core/src/main/kotlin/org/jetbrains/exposed/sql/Table.kt
@@ -140,6 +140,8 @@ abstract class ColumnSet : FieldSet {
 /**
  * Creates an inner join relation with [otherTable] using [onColumn] and [otherColumn] equality
  * and/or [additionalConstraint] as the join condition.
+ *
+ * @throws IllegalStateException if the join cannot be performed. See the exception message for more details.
  */
 fun <C1 : ColumnSet, C2 : ColumnSet> C1.innerJoin(
     otherTable: C2,
@@ -151,6 +153,8 @@ fun <C1 : ColumnSet, C2 : ColumnSet> C1.innerJoin(
 /**
  * Creates a left outer join relation with [otherTable] using [onColumn] and [otherColumn] equality
  * and/or [additionalConstraint] as the join condition.
+ *
+ * @throws IllegalStateException if the join cannot be performed. See the exception message for more details.
  */
 fun <C1 : ColumnSet, C2 : ColumnSet> C1.leftJoin(
     otherTable: C2,
@@ -162,6 +166,8 @@ fun <C1 : ColumnSet, C2 : ColumnSet> C1.leftJoin(
 /**
  * Creates a right outer join relation with [otherTable] using [onColumn] and [otherColumn] equality
  * and/or [additionalConstraint] as the join condition.
+ *
+ * @throws IllegalStateException if the join cannot be performed. See the exception message for more details.
  */
 fun <C1 : ColumnSet, C2 : ColumnSet> C1.rightJoin(
     otherTable: C2,
@@ -173,6 +179,8 @@ fun <C1 : ColumnSet, C2 : ColumnSet> C1.rightJoin(
 /**
  * Creates a full outer join relation with [otherTable] using [onColumn] and [otherColumn] equality
  * and/or [additionalConstraint] as the join condition.
+ *
+ * @throws IllegalStateException if the join cannot be performed. See the exception message for more details.
  */
 fun <C1 : ColumnSet, C2 : ColumnSet> C1.fullJoin(
     otherTable: C2,
@@ -184,6 +192,8 @@ fun <C1 : ColumnSet, C2 : ColumnSet> C1.fullJoin(
 /**
  * Creates a cross join relation with [otherTable] using [onColumn] and [otherColumn] equality
  * and/or [additionalConstraint] as the join condition.
+ *
+ * @throws IllegalStateException if the join cannot be performed. See the exception message for more details.
  */
 fun <C1 : ColumnSet, C2 : ColumnSet> C1.crossJoin(
     otherTable: C2,