PostgreSQL自定义jsonb函数与Java CriteriaBuilder调用逻辑解析及前缀匹配函数开发需求

我来帮你拆解现有函数的逻辑，然后一步步实现支持前缀匹配的版本：

一、现有jsonb_function的执行逻辑解析 #

先从你疑惑的两个核心操作符说起：

• #> 路径提取操作符：它接受一个JSONB对象和文本数组形式的路径，返回路径指向的JSONB子对象。比如你例子里的json #> cast('{"transitCurrencyAccount"}' as text[])，就是从数据库返回的JSONB数据中，提取transitCurrencyAccount字段对应的子JSON内容。
• @> 包含匹配操作符：用于判断左侧的JSONB对象是否完整包含右侧JSONB的所有键值对。只有当右侧的每一个键值都能在左侧找到完全一致的匹配时，才会返回true。

把这两个操作符串起来，现有jsonb_function的完整逻辑是：

1. 把传入的path文本转成文本数组，用#>从数据库的JSONB数据里定位到指定路径的子对象
2. 把传入的searchSeq文本转成JSONB，判断提取出的子JSONB是否完全包含这个目标JSONB的所有键值对
3. 返回最终的布尔判断结果

用你给的参数示例来说：只有当数据库里transitCurrencyAccount字段同时包含accountType="12"和accountNumber="718294019284103"这两个完全匹配的键值对时，函数才会返回true。

二、支持前缀匹配的自定义函数实现 #

要实现accountNumber支持完整值或前缀匹配的需求，我们需要拆分搜索条件，对普通字段保持完全匹配，对accountNumber单独做前缀判断。以下是具体的函数代码：

CREATE OR REPLACE FUNCTION jsonb_function_prefix(path TEXT, json JSONB, searchSeq TEXT) RETURNS BOOLEAN AS $BODY$
DECLARE
  target_subjson jsonb;
  search_json jsonb;
  search_account_number text;
  target_account_number text;
  other_search_conditions jsonb;
BEGIN
  -- 步骤1：提取指定路径的目标JSONB子对象（和原函数逻辑一致）
  target_subjson := json #> cast(path as text[]);
  
  -- 步骤2：将传入的搜索字符串转为JSONB格式
  search_json := cast(searchSeq as jsonb);
  
  -- 步骤3：拆分搜索条件中的accountNumber和其他字段
  search_account_number := search_json ->> 'accountNumber';
  other_search_conditions := search_json - 'accountNumber'; -- 移除accountNumber，保留其他需要完全匹配的字段
  
  -- 边界情况处理1：如果搜索条件里没有accountNumber，直接判断其他字段是否完全匹配
  IF search_account_number IS NULL THEN
    RETURN target_subjson @> other_search_conditions;
  END IF;
  
  -- 边界情况处理2：如果目标子JSON里没有accountNumber字段，直接返回false
  target_account_number := target_subjson ->> 'accountNumber';
  IF target_account_number IS NULL THEN
    RETURN false;
  END IF;
  
  -- 核心判断：其他字段完全匹配，且accountNumber是前缀匹配（或完全相等）
  RETURN (target_subjson @> other_search_conditions) AND (target_account_number LIKE search_account_number || '%');
END;
$BODY$ LANGUAGE plpgsql;

函数逻辑说明： #

1. 保留了原函数的路径提取逻辑，保证和原有调用方式兼容
2. 拆分搜索条件，把accountNumber单独拎出来做前缀匹配（用LIKE '前缀%'实现，只要目标值以传入的字符串开头就满足）
3. 其他字段依然用@>做完全包含匹配，保证原有逻辑不变
4. 处理了多种边界情况：比如搜索条件不含accountNumber、目标JSON不含accountNumber的场景

三、Java CriteriaBuilder调用示例 #

对应的Java代码只需要修改函数名即可，和原有调用逻辑完全兼容：

builder.equal(
    builder.function("jsonb_function_prefix", Boolean.class, 
        builder.literal(pathArrayLiteral), 
        root.get(ATTRIBUTE_COMPOSITION), 
        builder.literal(simpleEntries)), 
    Boolean.TRUE
);

内容的提问来源于stack exchange，提问作者Evgenia Rubanova