Clarify custom predicate examples

Author: xiangfu0

pinot-common/src/main/java/org/apache/pinot/common/filter/FilterPredicatePlugin.java

@@ -26,7 +26,7 @@
 /**
  * SPI interface for registering custom filter predicates into Pinot.
  *
- * <p>A plugin implementing this interface can introduce a new filter predicate (e.g., SEMANTIC_MATCH)
+ * <p>A plugin implementing this interface can introduce a new filter predicate (for example, anyLike)
  * without modifying Pinot core code. The plugin handles three layers:
  * <ol>
  *   <li><b>SQL Parsing</b> — validation and rewriting of the Thrift expression tree</li>
@@ -42,7 +42,7 @@
 public interface FilterPredicatePlugin {
 
   /**
-   * Returns the canonical name of this filter predicate (e.g., "SEMANTIC_MATCH").
+   * Returns the canonical name of this filter predicate (for example, "LIKE_ANY").
    * Must be unique across all registered plugins and built-in filter kinds.
    * The name is case-insensitive and will be canonicalized for matching.
    */
@@ -79,8 +79,8 @@ default void rewriteExpression(List<org.apache.pinot.common.request.Expression>
    * Returns the operand type families for Calcite SQL operator registration.
    * Each element corresponds to one operand and specifies its expected SQL type family.
    *
-   * <p>Example for SEMANTIC_MATCH(column, 'query', topK):
-   * {@code List.of(OperandType.STRING, OperandType.STRING, OperandType.INTEGER)}
+   * <p>Example for anyLike(column, 'foo%', '%bar'):
+   * {@code List.of(OperandType.STRING, OperandType.STRING, OperandType.STRING)}
    */
   List<OperandType> getOperandTypes();
 

pinot-common/src/main/java/org/apache/pinot/common/request/context/predicate/CustomPredicate.java

@@ -25,20 +25,18 @@
  * Base class for custom filter predicates registered via the plugin system.
  *
  * <p>Plugin authors should extend this class to define their own predicate types
- * (e.g., SemanticMatchPredicate). The {@link #getCustomTypeName()} method returns
+ * (for example, AnyLikePredicate). The {@link #getCustomTypeName()} method returns
  * the unique predicate name used to look up the corresponding filter operator factory
  * at query execution time.
  *
  * <p>Example:
  * <pre>
- * public class SemanticMatchPredicate extends CustomPredicate {
- *     private final String _queryText;
- *     private final int _topK;
+ * public class AnyLikePredicate extends CustomPredicate {
+ *     private final List<String> _patterns;
  *
- *     public SemanticMatchPredicate(ExpressionContext lhs, String queryText, int topK) {
- *         super(lhs, "SEMANTIC_MATCH");
- *         _queryText = queryText;
- *         _topK = topK;
+ *     public AnyLikePredicate(ExpressionContext lhs, List<String> patterns) {
+ *         super(lhs, "LIKE_ANY");
+ *         _patterns = patterns;
  *     }
  *     // ... getters, equals, hashCode, toString
  * }
@@ -59,7 +57,7 @@ public final Type getType() {
   }
 
   /**
-   * Returns the unique name of this custom predicate type (e.g., "SEMANTIC_MATCH").
+   * Returns the unique name of this custom predicate type (for example, "LIKE_ANY").
    * Used to look up the corresponding filter operator factory at execution time.
    */
   public String getCustomTypeName() {

pinot-core/src/main/java/org/apache/pinot/core/operator/filter/custom/CustomFilterOperatorFactory.java

@@ -41,7 +41,7 @@
 public interface CustomFilterOperatorFactory {
 
   /**
-   * Returns the predicate name this factory handles (e.g., "SEMANTIC_MATCH").
+   * Returns the predicate name this factory handles (for example, "LIKE_ANY").
    * Must match the name returned by the corresponding
    * {@link org.apache.pinot.common.request.context.predicate.CustomPredicate#getCustomTypeName()}.
    */