Class OpenTemplate

java.lang.Object

cloud.opencode.base.string.OpenTemplate

public final class OpenTemplate
extends Object

Template Utility - Provides simple string template rendering. 模板工具 - 提供简单的字符串模板渲染。

Features | 主要功能:

• Variable placeholder rendering - 变量占位符渲染
• Named and indexed parameter support - 命名和索引参数支持
• Template compilation and caching - 模板编译和缓存
• Built-in filters (upper, lower, truncate, etc.) - 内置过滤器

Usage Examples | 使用示例:

// Simple placeholder rendering
String result = OpenTemplate.render("Hello ${name}!", Map.of("name", "World"));
// "Hello World!"

// Indexed format
String formatted = OpenTemplate.format("Hello {0}, welcome to {1}!", "Alice", "Java");

// Compiled template
Template tpl = OpenTemplate.compile("${greeting} ${name}");
String output = tpl.render(Map.of("greeting", "Hi", "name", "Bob"));

Security | 安全性:

• Thread-safe: Yes (ConcurrentHashMap for filters and cache) - 线程安全: 是（过滤器和缓存使用 ConcurrentHashMap）
• Null-safe: Yes - 空值安全: 是
• Cache bounded: Yes (max 1024 templates) - 缓存有界: 是（最多1024个模板）

Since:

JDK 25, opencode-base-string V1.0.0

Author:

Leon Soo www.LeonSoo.com

See Also:

• OpenCode.cloud

Method Summary

Modifier and Type	Method	Description
static void	clearCache()
static Template	compile(String template)
static String	format(String template, Object... args)
static String	format(String template, Map<String,Object> values)
static TemplateFilter	getFilter(String name)
static StringTemplate	of(String template)
static PlaceholderTemplate	placeholder(String template, String prefix, String suffix)
static void	register(String name, String template)	Register a named template.
static void	registerFilter(String name, TemplateFilter filter)
static String	render(String template, Map<String,Object> values)
static String	render(String template, Map<String,Object> values, String defaultValue)
static String	renderInline(String template, Map<String,Object> context)
static String	renderNamed(String templateName, Map<String,Object> context)

Methods inherited from class Object

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

Method Details

render

public static String render(String template,
 Map<String,Object> values)

render

public static String render(String template,
 Map<String,Object> values,
 String defaultValue)

format

public static String format(String template,
 Map<String,Object> values)

format

public static String format(String template,
 Object... args)

of

public static StringTemplate of(String template)

placeholder

public static PlaceholderTemplate placeholder(String template,
 String prefix,
 String suffix)

compile

public static Template compile(String template)

renderInline

public static String renderInline(String template,
 Map<String,Object> context)

registerFilter

public static void registerFilter(String name,
 TemplateFilter filter)

getFilter

public static TemplateFilter getFilter(String name)

register

public static void register(String name,
 String template)

Register a named template. Cache is bounded to 1024 entries to prevent memory exhaustion from unbounded registration. 注册命名模板。缓存限制为 1024 条，防止无限注册导致内存耗尽。

Parameters:

name - the template name | 模板名

template - the template string | 模板字符串

Throws:

IllegalStateException - if the cache is full and the name is new | 如果缓存已满且名称是新的

renderNamed

public static String renderNamed(String templateName,
 Map<String,Object> context)

clearCache

public static void clearCache()