Update

Author: injectives

driver/src/main/java/org/neo4j/driver/Config.java

@@ -38,7 +38,6 @@
 import org.neo4j.driver.internal.handlers.pulln.FetchSizeUtil;
 import org.neo4j.driver.internal.retry.ExponentialBackoffRetryLogic;
 import org.neo4j.driver.net.ServerAddressResolver;
-import org.neo4j.driver.querytask.QueryConfig;
 import org.neo4j.driver.util.Experimental;
 import org.neo4j.driver.util.Immutable;
 
@@ -129,7 +128,7 @@ private Config(ConfigBuilder builder) {
 
     /**
      * A {@link BookmarkManager} implementation for the driver to use on
-     * {@link Driver#executeQuery(Query, QueryConfig)} method and its variants by default.
+     * {@link Driver#queryTask(String)} method and its variants by default.
      * <p>
      * Please note that sessions will not use this automatically, but it is possible to enable it explicitly
      * using {@link SessionConfig.Builder#withBookmarkManager(BookmarkManager)}.
@@ -302,7 +301,7 @@ private ConfigBuilder() {}
 
         /**
          * Sets a {@link BookmarkManager} implementation for the driver to use on
-         * {@link Driver#executeQuery(Query, QueryConfig)} method and its variants by default.
+         * {@link Driver#queryTask(String)} method and its variants by default.
          * <p>
          * Please note that sessions will not use this automatically, but it is possible to enable it explicitly
          * using {@link SessionConfig.Builder#withBookmarkManager(BookmarkManager)}.

driver/src/main/java/org/neo4j/driver/querytask/QueryConfig.java

@@ -27,11 +27,10 @@
 import org.neo4j.driver.BookmarkManager;
 import org.neo4j.driver.Config;
 import org.neo4j.driver.Driver;
-import org.neo4j.driver.Query;
 import org.neo4j.driver.util.Experimental;
 
 /**
- * Query configuration used by {@link Driver#executeQuery(Query, QueryConfig)} and its variants.
+ * Query configuration used by {@link Driver#queryTask(String)} and its variants.
  * @since 5.5
  */
 @Experimental
@@ -65,8 +64,8 @@ private QueryConfig(Builder builder) {
     }
 
     /**
-     * Creates a new {@link Builder} used to construct a configuration object with default {@link ResultTransformer}
-     * implementation returning {@link EagerResult}.
+     * Creates a new {@link Builder} used to construct a configuration object with default implementation returning
+     * {@link EagerResult}.
      *
      * @return a query configuration builder
      */

driver/src/main/java/org/neo4j/driver/querytask/QueryTask.java

@@ -68,11 +68,20 @@
  * }
  * </pre>
  * <p>
- * In addition, it is possible to transform query result by using a provided {@link Collector}.
- * Examples:
+ * In addition, it is possible to transform query result by using a supplied {@link Collector} implementation.
+ * <p>
+ * <b>It is strongly recommended to use Cypher query language capabilities where possible</b>. The examples below just
+ * provide a sample usage of the API.
  * <pre>
  * {@code
+ * import static java.util.stream.Collectors.*;
  *
+ * var averagingLong = driver.queryTask("UNWIND range(0, 5) as N RETURN N")
+ *         .execute(averagingLong(record -> record.get("N").asLong()));
+ * var filteredValues = driver.queryTask("UNWIND range(0, 5) as N RETURN N")
+ *         .execute(mapping(record -> record.get("N").asLong(), filtering(value -> value > 2, toList())));
+ * var maxValue = driver.queryTask("UNWIND range(0, 5) as N RETURN N")
+ *         .execute(mapping(record -> record.get("N").asLong(), maxBy(Long::compare)));
  * }
  * </pre>
  *