#65 - ENH: Add support for filterMany using expressions

Author: rbygrave

pom.xml

@@ -4,7 +4,7 @@
 
   <groupId>io.ebean</groupId>
   <artifactId>ebean-querybean</artifactId>
-  <version>11.42.2-SNAPSHOT</version>
+  <version>11.43.1-SNAPSHOT</version>
 
   <parent>
     <groupId>org.avaje</groupId>
@@ -23,7 +23,7 @@
     <dependency>
       <groupId>io.ebean</groupId>
       <artifactId>ebean</artifactId>
-      <version>11.41.1</version>
+      <version>11.43.1</version>
       <scope>provided</scope>
     </dependency>
 

src/main/java/io/ebean/typequery/TQAssocBean.java

@@ -160,6 +160,39 @@ public R filterMany(ExpressionList<T> filter) {
     return _root;
   }
 
+  /**
+   * Apply a filter when fetching these beans.
+   * <p>
+   * The expressions can use any valid Ebean expression and contain
+   * placeholders for bind values using <code>?</code> or <code>?1</code> style.
+   * </p>
+   *
+   * <pre>{@code
+   *
+   *     new QCustomer()
+   *       .name.startsWith("Postgres")
+   *       .contacts.filterMany("firstName istartsWith ?", "Rob")
+   *       .findList();
+   *
+   * }</pre>
+   *
+   * <pre>{@code
+   *
+   *     new QCustomer()
+   *       .name.startsWith("Postgres")
+   *       .contacts.filterMany("whenCreated inRange ? to ?", startDate, endDate)
+   *       .findList();
+   *
+   * }</pre>
+   *
+   * @param expressions The expressions including and, or, not etc with ? and ?1 bind params.
+   * @param params      The bind parameter values
+   */
+  public R filterMany(String expressions, Object... params) {
+    expr().filterMany(_name, expressions, params);
+    return _root;
+  }
+
   /**
    * Is empty for a collection property.
    * <p>

src/test/java/org/querytest/QCustomerTest.java

@@ -23,6 +23,7 @@
 import javax.sql.DataSource;
 import java.sql.Connection;
 import java.sql.SQLException;
+import java.time.LocalDate;
 import java.util.ArrayList;
 import java.util.Arrays;
 import java.util.Collections;
@@ -288,6 +289,28 @@ public void testFindOne() {
       .findList();
   }
 
+  @Test
+  public void testFilterMany() {
+
+    Customer cust = new Customer();
+    cust.setName("Postgres Foo");
+    cust.setStatus(Customer.Status.GOOD);
+    cust.save();
+
+    new QCustomer()
+      .name.startsWith("Postgres")
+      .contacts.filterMany("firstName istartsWith ?", "Rob")
+      .findList();
+
+    final LocalDate startDate = LocalDate.now().minusDays(7);
+    final LocalDate endDate = LocalDate.now();
+
+    new QCustomer()
+      .name.startsWith("Postgres")
+      .contacts.filterMany("whenCreated inRange ? to ?", startDate, endDate)
+      .findList();
+  }
+
   @Test
   public void testDate_lessThan() {