程序包 dev.tinyflow.core.util

类 TextTemplate

java.lang.Object

dev.tinyflow.core.util.TextTemplate

public class TextTemplate
extends Object

文本模板引擎，用于将包含 {{xxx}} 占位符的字符串模板，动态渲染为最终文本。 支持 JSONPath 取值语法与 “??” 空值兜底逻辑。

例如： 模板: "Hello {{ user.name ?? 'Unknown' }}!" 数据: { "user": { "name": "Alice" } } 输出: "Hello Alice!"

支持缓存模板与 JSONPath 编译结果，提升性能。

嵌套类概要

嵌套类

修饰符和类型	类	说明
private static class	TextTemplate.ParseResult	表达式解析结果。
private static class	TextTemplate.TemplateParseResult	模板解析的最终结果，包含： - 解析后的表达式树（ParseResult） - 是否显式声明空兜底
private static class	TextTemplate.TemplateToken	模板片段对象。

字段概要

字段

修饰符和类型	字段	说明
private static final Map<String,com.alibaba.fastjson.JSONPath>	JSONPATH_CACHE	JSONPath 编译缓存，避免重复编译
private final String	originalTemplate	原始模板字符串
private static final Pattern	PLACEHOLDER_PATTERN	匹配 {{ expression }} 的正则表达式
private static final Map<String,TextTemplate>	TEMPLATE_CACHE	模板缓存（按原始模板字符串）
private final List<TextTemplate.TemplateToken>	tokens	模板中拆分出的静态与动态 token 列表

构造器概要

构造器

构造器	说明
TextTemplate(String template)

方法概要

修饰符和类型	方法	说明
static void	clearCache()	清空模板与 JSONPath 缓存
private static String	escapeJsonString(String input)	将字符串进行 JSON 安全转义
private String	evaluate(TextTemplate.ParseResult pr, Map<String,Object> root, boolean escapeForJsonOutput)	递归求值表达式（支持多级兜底）
String	formatToString(List<Map<String,Object>> rootMaps)
String	formatToString(Map<String,Object> rootMap)	将模板格式化为字符串
String	formatToString(Map<String,Object> rootMap, boolean escapeForJsonOutput)	将模板格式化为字符串，可选择是否对结果进行 JSON 转义
private Object	getValueByJsonPath(Map<String,Object> root, String path, boolean escapeForJsonOutput)	根据 JSONPath 获取对象值
static TextTemplate	of(String template)	从缓存中获取或新建模板实例
private List<TextTemplate.TemplateToken>	parseTemplate(String template)	解析模板字符串，将其拆解为静态文本与动态占位符片段
private TextTemplate.TemplateParseResult	parseTemplateExpression(String expr)	解析单个表达式内容，处理 ??
private static String	unquote(String str)	去掉字符串两端的引号

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

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

字段详细资料

PLACEHOLDER_PATTERN

private static final Pattern PLACEHOLDER_PATTERN

匹配 {{ expression }} 的正则表达式

TEMPLATE_CACHE

private static final Map<String,TextTemplate> TEMPLATE_CACHE

模板缓存（按原始模板字符串）

JSONPATH_CACHE

private static final Map<String,com.alibaba.fastjson.JSONPath> JSONPATH_CACHE

JSONPath 编译缓存，避免重复编译

originalTemplate

private final String originalTemplate

原始模板字符串

tokens

private final List<TextTemplate.TemplateToken> tokens

模板中拆分出的静态与动态 token 列表

构造器详细资料

TextTemplate

public TextTemplate(String template)

方法详细资料

of

public static TextTemplate of(String template)

从缓存中获取或新建模板实例

clearCache

public static void clearCache()

清空模板与 JSONPath 缓存

formatToString

public String formatToString(List<Map<String,Object>> rootMaps)

formatToString

public String formatToString(Map<String,Object> rootMap)

将模板格式化为字符串

formatToString

public String formatToString(Map<String,Object> rootMap,
 boolean escapeForJsonOutput)

将模板格式化为字符串，可选择是否对结果进行 JSON 转义

参数:

rootMap - 数据上下文

escapeForJsonOutput - 是否对结果进行 JSON 字符串转义

parseTemplate

private List<TextTemplate.TemplateToken> parseTemplate(String template)

解析模板字符串，将其拆解为静态文本与动态占位符片段

parseTemplateExpression

private TextTemplate.TemplateParseResult parseTemplateExpression(String expr)

解析单个表达式内容，处理 ?? 空值兜底逻辑。 例如： user.name ?? user.nick ?? "未知"

evaluate

private String evaluate(TextTemplate.ParseResult pr,
 Map<String,Object> root,
 boolean escapeForJsonOutput)

递归求值表达式（支持多级兜底）

getValueByJsonPath

private Object getValueByJsonPath(Map<String,Object> root,
 String path,
 boolean escapeForJsonOutput)

根据 JSONPath 获取对象值

escapeJsonString

private static String escapeJsonString(String input)

将字符串进行 JSON 安全转义

unquote

private static String unquote(String str)

去掉字符串两端的引号