io.polaris.core.jdbc.sql.statement.expression

类 PatternExpression

java.lang.Object

io.polaris.core.jdbc.sql.statement.expression.BaseExpression

io.polaris.core.jdbc.sql.statement.expression.PatternExpression

所有已实现的接口:

Expression

public class PatternExpression
extends BaseExpression

SQL模式表达式类，用于处理包含变量和SQL块引用的SQL模板

 该类支持两种类型的占位符：
 1. 变量占位符：#{varName} 或 ${varName}，用于绑定参数值
 2. SQL块引用占位符：${ref} 或 ${refN} (N为数字)，用于动态插入SQL引用块, ref0等同于ref，表示基础引入块，通常是主列名或表达式
 

从以下版本开始:

Aug 22, 2023

作者:

Qt

字段概要

字段

限定符和类型	字段和说明
static Pattern	REF_PATTERN SQL块引用模式，匹配ref或ref加数字的格式
static String	REF_PREFIX SQL块引用前缀

构造器概要

构造器

构造器和说明
PatternExpression(String pattern) 构造一个新的PatternExpression实例 解析给定的SQL模式字符串，提取变量占位符和SQL块引用，并构建内部结构以支持后续的绑定操作

方法概要

限定符和类型	方法和说明
protected FunctionWithArgs3<SqlNode,SqlNode[],Object[],ContainerNode>	buildArrayFunction() 构建使用数组参数的绑定函数
protected FunctionWithArgs3<SqlNode,SqlNode[],Map<String,Object>,ContainerNode>	buildMapFunction() 构建使用Map参数的绑定函数
protected ContainerNode	createPatternSqlNode() 创建模式SQL节点的副本
static PatternExpression	of(String pattern) 获取PatternExpression实例，使用缓存机制避免重复创建相同模式的实例
String	toString() 返回该模式表达式的字符串表示形式
protected Object	wrapBinding(Object v) 包装绑定值

从类继承的方法 io.polaris.core.jdbc.sql.statement.expression.BaseExpression

nextVarName, toSqlNode, toSqlNode

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

从接口继承的方法 io.polaris.core.jdbc.sql.statement.expression.Expression

toSqlNode, toSqlNode, toSqlNode, toSqlNode, toSqlNode, toSqlNode

字段详细资料

REF_PREFIX

public static final String REF_PREFIX

SQL块引用前缀

另请参阅:

常量字段值

REF_PATTERN

public static final Pattern REF_PATTERN

SQL块引用模式，匹配ref或ref加数字的格式

构造器详细资料

PatternExpression

public PatternExpression(String pattern)

构造一个新的PatternExpression实例

解析给定的SQL模式字符串，提取变量占位符和SQL块引用，并构建内部结构以支持后续的绑定操作

参数:

pattern - SQL模式字符串，可以包含变量占位符(#{var}或${var})和SQL块引用(${ref}或${refN})

方法详细资料

of

public static PatternExpression of(String pattern)

获取PatternExpression实例，使用缓存机制避免重复创建相同模式的实例

参数:

pattern - SQL模式字符串

返回:

PatternExpression实例

buildArrayFunction

protected FunctionWithArgs3<SqlNode,SqlNode[],Object[],ContainerNode> buildArrayFunction()

构建使用数组参数的绑定函数

指定者:

buildArrayFunction 在类中 BaseExpression

返回:

三参数函数，接受基础SQL源、扩展SQL源数组和绑定值数组，返回绑定后的SQL节点容器

buildMapFunction

protected FunctionWithArgs3<SqlNode,SqlNode[],Map<String,Object>,ContainerNode> buildMapFunction()

构建使用Map参数的绑定函数

指定者:

buildMapFunction 在类中 BaseExpression

返回:

三参数函数，接受基础SQL源、扩展SQL源数组和绑定值Map，返回绑定后的SQL节点容器

createPatternSqlNode

protected ContainerNode createPatternSqlNode()

创建模式SQL节点的副本

返回:

模板SQL节点的副本

wrapBinding

protected Object wrapBinding(Object v)

包装绑定值

参数:

v - 原始绑定值

返回:

包装后的绑定值

toString

public String toString()

返回该模式表达式的字符串表示形式

覆盖:

toString 在类中 Object

返回:

模板SQL节点的字符串表示