add new overloads

Author: wu-hui

google-cloud-firestore/src/main/java/com/google/cloud/firestore/Pipeline.java

@@ -718,6 +718,10 @@ public void onStart(StreamController controller) {
 
           @Override
           public void onResponse(ExecutePipelineResponse response) {
+            if (executionTime == null) {
+              executionTime = Timestamp.fromProto(response.getExecutionTime());
+            }
+
             if (!firstResponse) {
               firstResponse = true;
               Tracing.getTracer()
@@ -739,10 +743,6 @@ public void onResponse(ExecutePipelineResponse response) {
                 resultObserver.onNext(PipelineResult.fromDocument(rpcContext, executionTime, doc));
               }
             }
-
-            if (executionTime == null) {
-              executionTime = Timestamp.fromProto(response.getExecutionTime());
-            }
           }
 
           @Override

google-cloud-firestore/src/main/java/com/google/cloud/firestore/pipeline/expressions/Expr.java

@@ -1109,6 +1109,24 @@ default Like like(String pattern) {
     return new Like(this, Constant.of(pattern));
   }
 
+  /**
+   * Creates an expression that performs a case-sensitive string comparison.
+   *
+   * <p>Example:
+   *
+   * <pre>{@code
+   * // Check if the 'title' field matches the pattern specified in field 'pattern'.
+   * Field.of("title").like(Field.of("pattern"));
+   * }</pre>
+   *
+   * @param pattern The expression evaluates to a pattern.
+   * @return A new {@code Expr} representing the 'like' comparison.
+   */
+  @BetaApi
+  default Like like(Expr pattern) {
+    return new Like(this, pattern);
+  }
+
   /**
    * Creates an expression that checks if a string contains a specified regular expression as a
    * substring.

google-cloud-firestore/src/main/java/com/google/cloud/firestore/pipeline/expressions/Function.java

@@ -2250,6 +2250,25 @@ public static ByteLength byteLength(String field) {
     return new ByteLength(Field.of(field));
   }
 
+  /**
+   * Creates an expression that performs a case-sensitive wildcard string comparison.
+   *
+   * <p>Example:
+   *
+   * <pre>{@code
+   * // Check if the 'title' field contains the pattern specified in field 'pattern'.
+   * Function.like(Field.of("title"), Field.of("pattern"));
+   * }</pre>
+   *
+   * @param expr The expression representing the string to perform the comparison on.
+   * @param pattern The expression evaluates to the pattern to compare to.
+   * @return A new {@code Expr} representing the 'like' comparison.
+   */
+  @BetaApi
+  public static Like like(Expr expr, Expr pattern) {
+    return new Like(expr, pattern);
+  }
+
   /**
    * Creates an expression that performs a case-sensitive wildcard string comparison.
    *
@@ -2289,6 +2308,26 @@ public static Like like(String field, String pattern) {
     return new Like(Field.of(field), Constant.of(pattern));
   }
 
+  /**
+   * Creates an expression that checks if a string expression contains a specified regular
+   * expression as a substring.
+   *
+   * <p>Example:
+   *
+   * <pre>{@code
+   * // Check if the 'description' field contains "example" (case-insensitive)
+   * Function.regexContains(Field.of("description"), Constant.of("(?i)example"));
+   * }</pre>
+   *
+   * @param expr The expression representing the string to perform the comparison on.
+   * @param pattern The expression evaluates to a regular expression string.
+   * @return A new {@code Expr} representing the 'contains' comparison.
+   */
+  @BetaApi
+  public static RegexContains regexContains(Expr expr, Expr pattern) {
+    return new RegexContains(expr, pattern);
+  }
+
   /**
    * Creates an expression that checks if a string expression contains a specified regular
    * expression as a substring.
@@ -2329,6 +2368,26 @@ public static RegexContains regexContains(String field, String pattern) {
     return new RegexContains(Field.of(field), Constant.of(pattern));
   }
 
+  /**
+   * Creates an expression that checks if a string expression matches a specified regular
+   * expression.
+   *
+   * <p>Example:
+   *
+   * <pre>{@code
+   * // Check if the 'email' field matches a valid email pattern
+   * Function.regexMatch(Field.of("email"), Constant.of("[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\\.[A-Za-z]{2,}"));
+   * }</pre>
+   *
+   * @param expr The expression representing the string to match against.
+   * @param pattern The expression evaluates to a regular expression string.
+   * @return A new {@code Expr} representing the regular expression match.
+   */
+  @BetaApi
+  public static RegexMatch regexMatch(Expr expr, Expr pattern) {
+    return new RegexMatch(expr, pattern);
+  }
+
   /**
    * Creates an expression that checks if a string expression matches a specified regular
    * expression.
@@ -2368,6 +2427,25 @@ public static RegexMatch regexMatch(String field, String pattern) {
     return new RegexMatch(Field.of(field), Constant.of(pattern));
   }
 
+  /**
+   * Creates an expression that checks if a string expression contains a specified substring.
+   *
+   * <p>Example:
+   *
+   * <pre>{@code
+   * // Check if the 'description' field contains "example".
+   * Function.regexContains(Field.of("description"), Constant.of("example"));
+   * }</pre>
+   *
+   * @param expr The expression representing the string to perform the comparison on.
+   * @param substring The expression evaluates to a substring to use for the search.
+   * @return A new {@code Expr} representing the 'contains' comparison.
+   */
+  @BetaApi
+  public static StrContains strContains(Expr expr, Expr substring) {
+    return new StrContains(expr, Constant.of(substring));
+  }
+
   /**
    * Creates an expression that checks if a string expression contains a specified substring.
    *