Add Kotlin extension to accept Kotlin's Pair in BulkOperations.

Closes #4911
Original pull request: #4912

Signed-off-by: audghks1996 <[email protected]>

Author: 2tsumo-hitori

spring-data-mongodb/src/main/kotlin/org/springframework/data/mongodb/core/BulkOperationsExtensions.kt

@@ -0,0 +1,50 @@
+/*
+ * Copyright 2017-2025 the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package org.springframework.data.mongodb.core
+
+import org.springframework.data.mongodb.core.query.Query
+import org.springframework.data.mongodb.core.query.Update
+import org.springframework.data.mongodb.core.query.UpdateDefinition
+import org.springframework.data.util.Pair.of
+
+/**
+ * Extension for [BulkOperations.updateMulti] that converts a [kotlin.Pair] to [org.springframework.data.util.Pair].
+ *
+ * @author 2tsumo-hitori
+ */
+fun BulkOperations.updateMulti(kotlinPairs: List<Pair<Query, UpdateDefinition>>): BulkOperations =
+        updateMulti(kotlinPairs.toSpringPairs())
+
+/**
+ * Extension for [BulkOperations.upsert] that converts a [kotlin.Pair] to [org.springframework.data.util.Pair].
+ *
+ * @author 2tsumo-hitori
+ */
+fun BulkOperations.upsert(kotlinPairs: List<Pair<Query, Update>>) : BulkOperations =
+        upsert(kotlinPairs.toSpringPairs())
+
+/**
+ * Extension for [BulkOperations.updateOne] that converts a [kotlin.Pair] to [org.springframework.data.util.Pair].
+ *
+ * @author 2tsumo-hitori
+ */
+fun BulkOperations.updateOne(kotlinPairs: List<Pair<Query, UpdateDefinition>>): BulkOperations =
+        updateOne(kotlinPairs.toSpringPairs())
+
+private fun <A : Query, B : UpdateDefinition> List<Pair<A, B>>.toSpringPairs(): List<org.springframework.data.util.Pair<A, B>> {
+
+    return map { (first, second) -> of(first, second) }
+}

spring-data-mongodb/src/test/kotlin/org/springframework/data/mongodb/core/BulkOperationExtensionsTests.kt

@@ -0,0 +1,74 @@
+/*
+ * Copyright 2017-2025 the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package org.springframework.data.mongodb.core
+
+import io.mockk.mockk
+import io.mockk.verify
+import org.junit.Test
+import org.springframework.data.mongodb.core.query.Criteria
+import org.springframework.data.mongodb.core.query.Query
+import org.springframework.data.mongodb.core.query.Update
+import org.springframework.data.mongodb.core.query.UpdateDefinition
+import org.springframework.data.util.Pair.of
+
+/**
+ * @author 2tsumo-hitori
+ */
+class BulkOperationExtensionsTests {
+
+    private val bulkOperation = mockk<BulkOperations>(relaxed = true)
+
+    @Test // GH-4911
+    fun `BulkOperation#updateMulti#updates() using kotlin#Pair should call its Java counterpart`() {
+        val list : MutableList<Pair<Query, UpdateDefinition>> = mutableListOf()
+        list.add(where("value", "v2") to set("value", "v3"))
+
+        bulkOperation.updateMulti(list)
+
+        val expected = list.map { (query, update) -> of(query, update) }
+        verify { bulkOperation.updateMulti(expected) }
+    }
+
+    @Test // GH-4911
+    fun `BulkOperation#upsert#updates() using kotlin#Pair should call its Java counterpart`() {
+        val list : MutableList<Pair<Query, Update>> = mutableListOf()
+        list.add(where("value", "v2") to set("value", "v3"))
+
+        bulkOperation.upsert(list)
+
+        val expected = list.map { (query, update) -> of(query, update) }
+        verify { bulkOperation.upsert(expected) }
+    }
+
+    @Test // GH-4911
+    fun `BulkOperation#updateOne#updates() using kotlin#Pair should call its Java counterpart`() {
+        val list : MutableList<Pair<Query, UpdateDefinition>> = mutableListOf()
+        list.add(where("value", "v2") to set("value", "v3"))
+
+        bulkOperation.updateOne(list)
+
+        val expected = list.map { (query, update) -> of(query, update) }
+        verify { bulkOperation.updateOne(expected) }
+    }
+
+    private fun where(field: String, value: String): Query {
+        return Query().addCriteria(Criteria.where(field).`is`(value))
+    }
+
+    private fun set(field: String, value: String): Update {
+        return Update().set(field, value)
+    }
+}