feat: add Target to aggregate-nearText queries

Author: bevzzz

src/main/java/io/weaviate/client6/v1/api/collections/aggregate/AbstractAggregateClient.java

@@ -675,6 +675,21 @@ public ResponseT nearText(List<String> concepts, Function<Aggregation.Builder, O
     return nearText(NearText.of(Target.text(concepts)), fn);
   }
 
+  /**
+   * Aggregate results of a near text query.
+   *
+   * @param searchTarget Query target.
+   * @param fn           Lambda expression for optional aggregation parameters.
+   * @return Aggregation result.
+   *
+   * @throws WeaviateApiException in case the server returned with an
+   *                              error status code.
+   * @see AggregateResponse
+   */
+  public ResponseT nearText(Target searchTarget, Function<Aggregation.Builder, ObjectBuilder<Aggregation>> fn) {
+    return nearText(NearText.of(searchTarget), fn);
+  }
+
   /**
    * Aggregate results of a near text query.
    *
@@ -687,7 +702,8 @@ public ResponseT nearText(List<String> concepts, Function<Aggregation.Builder, O
    *                              error status code.
    * @see AggregateResponse
    */
-  public ResponseT nearText(String text, Function<NearText.Builder, ObjectBuilder<NearText>> nt,
+  public ResponseT nearText(String text,
+      Function<NearText.Builder, ObjectBuilder<NearText>> nt,
       Function<Aggregation.Builder, ObjectBuilder<Aggregation>> fn) {
     return nearText(NearText.of(Target.text(List.of(text)), nt), fn);
   }
@@ -704,11 +720,30 @@ public ResponseT nearText(String text, Function<NearText.Builder, ObjectBuilder<
    *                              error status code.
    * @see AggregateResponse
    */
-  public ResponseT nearText(List<String> concepts, Function<NearText.Builder, ObjectBuilder<NearText>> nt,
+  public ResponseT nearText(List<String> concepts,
+      Function<NearText.Builder, ObjectBuilder<NearText>> nt,
       Function<Aggregation.Builder, ObjectBuilder<Aggregation>> fn) {
     return nearText(NearText.of(Target.text(concepts), nt), fn);
   }
 
+  /**
+   * Aggregate results of a near text query.
+   *
+   * @param searchTarget Query target.
+   * @param nt           Lambda expression for optional near text parameters.
+   * @param fn           Lambda expression for optional aggregation parameters.
+   * @return Aggregation result.
+   *
+   * @throws WeaviateApiException in case the server returned with an
+   *                              error status code.
+   * @see AggregateResponse
+   */
+  public ResponseT nearText(Target searchTarget,
+      Function<NearText.Builder, ObjectBuilder<NearText>> nt,
+      Function<Aggregation.Builder, ObjectBuilder<Aggregation>> fn) {
+    return nearText(NearText.of(searchTarget, nt), fn);
+  }
+
   /**
    * Aggregate results of a near text query.
    *
@@ -719,7 +754,8 @@ public ResponseT nearText(List<String> concepts, Function<NearText.Builder, Obje
    * @throws WeaviateApiException in case the server returned with an
    *                              error status code.
    */
-  public ResponseT nearText(NearText filter, Function<Aggregation.Builder, ObjectBuilder<Aggregation>> fn) {
+  public ResponseT nearText(NearText filter,
+      Function<Aggregation.Builder, ObjectBuilder<Aggregation>> fn) {
     return performRequest(Aggregation.of(filter, fn));
   }
 
@@ -737,7 +773,8 @@ public ResponseT nearText(NearText filter, Function<Aggregation.Builder, ObjectB
    * @see GroupBy
    * @see AggregateResponseGrouped
    */
-  public GroupedResponseT nearText(String text, Function<Aggregation.Builder, ObjectBuilder<Aggregation>> fn,
+  public GroupedResponseT nearText(String text,
+      Function<Aggregation.Builder, ObjectBuilder<Aggregation>> fn,
       GroupBy groupBy) {
     return nearText(NearText.of(text), fn, groupBy);
   }
@@ -756,11 +793,32 @@ public GroupedResponseT nearText(String text, Function<Aggregation.Builder, Obje
    * @see GroupBy
    * @see AggregateResponseGrouped
    */
-  public GroupedResponseT nearText(List<String> concepts, Function<Aggregation.Builder, ObjectBuilder<Aggregation>> fn,
+  public GroupedResponseT nearText(List<String> concepts,
+      Function<Aggregation.Builder, ObjectBuilder<Aggregation>> fn,
       GroupBy groupBy) {
     return nearText(NearText.of(Target.text(concepts)), fn, groupBy);
   }
 
+  /**
+   * Aggregate results of a near text query.
+   *
+   * @param searchTarget Query target.
+   * @param fn           Lambda expression for optional aggregation parameters.
+   * @param groupBy      GroupBy clause.
+   * @return Grouped aggregation result.
+   *
+   * @throws WeaviateApiException in case the server returned with an
+   *                              error status code.
+   *
+   * @see GroupBy
+   * @see AggregateResponseGrouped
+   */
+  public GroupedResponseT nearText(Target searchTarget,
+      Function<Aggregation.Builder, ObjectBuilder<Aggregation>> fn,
+      GroupBy groupBy) {
+    return nearText(NearText.of(searchTarget), fn, groupBy);
+  }
+
   /**
    * Aggregate results of a near text query.
    *
@@ -776,8 +834,10 @@ public GroupedResponseT nearText(List<String> concepts, Function<Aggregation.Bui
    * @see GroupBy
    * @see AggregateResponseGrouped
    */
-  public GroupedResponseT nearText(String text, Function<NearText.Builder, ObjectBuilder<NearText>> nt,
-      Function<Aggregation.Builder, ObjectBuilder<Aggregation>> fn, GroupBy groupBy) {
+  public GroupedResponseT nearText(String text,
+      Function<NearText.Builder, ObjectBuilder<NearText>> nt,
+      Function<Aggregation.Builder, ObjectBuilder<Aggregation>> fn,
+      GroupBy groupBy) {
     return nearText(NearText.of(text, nt), fn, groupBy);
   }
 
@@ -796,11 +856,35 @@ public GroupedResponseT nearText(String text, Function<NearText.Builder, ObjectB
    * @see GroupBy
    * @see AggregateResponseGrouped
    */
-  public GroupedResponseT nearText(List<String> concepts, Function<NearText.Builder, ObjectBuilder<NearText>> nt,
-      Function<Aggregation.Builder, ObjectBuilder<Aggregation>> fn, GroupBy groupBy) {
+  public GroupedResponseT nearText(List<String> concepts,
+      Function<NearText.Builder, ObjectBuilder<NearText>> nt,
+      Function<Aggregation.Builder, ObjectBuilder<Aggregation>> fn,
+      GroupBy groupBy) {
     return nearText(NearText.of(Target.text(concepts), nt), fn, groupBy);
   }
 
+  /**
+   * Aggregate results of a near text query.
+   *
+   * @param searchTarget Query target.
+   * @param nt           Lambda expression for optional near text parameters.
+   * @param fn           Lambda expression for optional aggregation parameters.
+   * @param groupBy      GroupBy clause.
+   * @return Grouped aggregation result.
+   *
+   * @throws WeaviateApiException in case the server returned with an
+   *                              error status code.
+   *
+   * @see GroupBy
+   * @see AggregateResponseGrouped
+   */
+  public GroupedResponseT nearText(Target searchTarget,
+      Function<NearText.Builder, ObjectBuilder<NearText>> nt,
+      Function<Aggregation.Builder, ObjectBuilder<Aggregation>> fn,
+      GroupBy groupBy) {
+    return nearText(NearText.of(searchTarget, nt), fn, groupBy);
+  }
+
   /**
    * Aggregate results of a near text query.
    *