DATAMONGO-2138 - Document Typed Queries

Author: TjeuKayim

src/main/asciidoc/reference/mongodb.adoc

@@ -1821,6 +1821,38 @@ List<Person> findByFirstname(String firstname);
 ----
 ====
 
+[[mongo.query.kotlin-support]]
+=== Typed Queries for Kotlin
+
+https://kotlinlang.org/docs/reference/reflection.html#property-references[Kotlin property references]
+can be used to build typed queries.
+
+Most methods in `Criteria` have a matching Kotlin extension, like `inValues` and `regex`.
+
+====
+[source,kotlin]
+----
+import org.springframework.data.mongodb.core.query.*
+
+mongoOperations.find<Book>(
+  Query(Book::name isEqualTo "Moby-Dick") <1>
+)
+
+// vararg & infix variations
+Book::category.inValues("Fantasy", "Science fiction")
+Book::category inValues listOf("Fantasy", "Science fiction")
+
+// Binary operators
+BinaryMessage::payload bits { allClear(0b101) } <2>
+
+// Nested Properties (i.e. refer to "book.author")
+Book::author / Author::name regex "^H" <3>
+----
+<1> `isEqualTo()` is an infix extension function with receiver type `KProperty<T>` that returns `Criteria`.
+<2> For bitwise operators, pass a lambda argument where you call one of the methods of `Criteria.BitwiseCriteriaOperators`.
+<3> To construct nested properties, use the `/` character (overloaded operator `div`).
+====
+
 include::../{spring-data-commons-docs}/query-by-example.adoc[leveloffset=+1]
 include::query-by-example.adoc[leveloffset=+1]