简介
StringTemplate是一种基于java的模板引擎库，类似于velocity，FreeMarker。可以用于生成源代码、web页面、电子邮件等多种样式的文本。选择StringTemplate的原因是因为相较于其他的模板引擎，他的功能更加强大。
使用
1、使用maven添加依赖
<dependency>
<groupId>org.antlr</groupId>
<artifactId>ST4</artifactId>
<version>4.0.8</version>
<scope>compile</scope>
</dependency>
2、demo
2.1示例：
import org.stringtemplate.v4.ST;
...
ST hello = new ST("Hello, <name>");
hello.add("name", "World");
System.out.println(hello.render());
输出：
Hello, World
2.2 StringTemplate基本语法
"Hello, <name>" 模板中有一个表达式<name>，代码中使用world替换了该表达式中的内容，于是输出了“Hello, World”。
基本元素
text
<expr>
<!comment !>
其中，text为文本内容，<expr>为表达式，<!comment !>为注释。可以使用"<" 或 "\>"来避免文本内容与表达式的冲突。使用ST也支持"$name$"这种方式来表示表达式。
2.3 条件表达式
ST支持条件表达式，简单实例如下：
// 第二个和第三个参数用于定义表达式的头尾字符
ST hello = new ST("Hello, $if(name)$$name$$endif$", '$', '$');
hello.add("name", "risk");
System.out.println(hello.render());
输出：
Hello, risk
可以看到这里使用了"$..$"方式来定义表达式，表达式中来如果$name$存在，则将$name$输出。
换一种方式将更加容易看懂
ST hello = new ST("Hello, <if(name)><name><endif>");
hello.add("name", "risk");
System.out.println(hello.render());
注意：条件表达式中，条件只支持true或false这两种方式，若是传入的内容为null，则当中false处理，表达式无法支持name=="parrt"这种运算形式的内如。
2.4 模板组
StringTemplate的一个强大的功能是模板功能，模板功能有点类似函数的使用方式，模板定义如下：
templateName(args, agrs, ...) ::+= "模板内容"
上述模板方式支持单行内容，这里展示一个简单的示例：
STGroup stg = new STGroupString("sqlTemplate(columns,condition) ::= \"select <columns> from table where 1=1 <if(condition)>and <condition><endif> \"");
ST sqlST = stg.getInstanceOf("sqlTemplate");
sqlST.add("columns","order_id");
sqlST.add("condition", "dt='2017-04-04'");
System.out.print(sqlST.render());
输出：
from select order_id from table where 1=1 and dt='2017-04-04'
对于模板定义，同时支持如下两种方式：
- 1、模板内容为多行
templateName(args, agrs, ...) ::+= <<
模板内容
模板内容
>>
- 2、模板内容多行，且忽略换行符和缩进
templateName(args, agrs, ...) ::+= <%
模板内容
模板内容
%>
因此可以将上例中的sql写成如下方式更好：
STGroup stg = new STGroupString("sqlTemplate(columns,condition) ::= <<select <columns> \n" +
"from table \n" +
"where 1=1 <if(condition)>and <condition><endif> >>");
ST sqlST = stg.getInstanceOf("sqlTemplate");
sqlST.add("columns","order_id");
sqlST.add("condition", "dt='2017-04-04'");
System.out.print(sqlST.render());
输出：
select order_id
from table
where 1=1 and dt='2017-04-04'
当模板过于复杂时，以硬编码的方式将模板写在代码中，实在很麻烦，因此将模板内容写入到文件dataExtarctSql.stg中，内容如下：
sqlTemplate(columns,condition)
::= <<select <columns;separator=",">
from table
where 1=1 <if(condition)>and <condition><endif>
>>
这里将<columns> 修改为 <columns;separator=","> 这样可以在列名中插入多个列名，并以","分割。
java代码如下：
STGroup stg = new STGroupFile("dataExtractSql.stg");
ST sqlST = stg.getInstanceOf("sqlTemplate");
List<String> columnList = new LinkedList<String>();
columnList.add("order_id");
columnList.add("price");
columnList.add("phone");
sqlST.add("columns", columnList);
sqlST.add("condition", "dt='2017-04-04'");
System.out.print(sqlST.render());
输出：
select order_id,price,phone
from table
where 1=1 and dt='2017-04-04'
2.5模板组的简单使用
当一个模板比较复杂时，可以拆分成多个模板，以模板组的方式使用更加方便。
模板文件dataExtarctSql.stg如下：
/**模板外注释sql模板*/
sqlTemplate(columns,condition,joinKey,tableName,childColumns,childJoinKey,childTableName,childCdtion)
::= <<
<! 模板内注释 !>
select <columns;separator=",">,<childColumns:{item|t2.<item>};separator=",">
from <tableName> as t1 left join (<childSqlTemplate(childColumns, childCdtion)>) as t2 on t1.<joinKey>=t2.<childJoinKey>
where 1=1 <if(condition)>and <condition><endif>
>>
/**模板外注释sql子模板*/
childSqlTemplate(childColumns, childCdtion)
::= <<
select <childColumns;separator=",">
from <childTableName>
where 1=1 <if(childCdtion)>and <childCdtion><endif>
>>
模板中有两个模板函数sqlTemplate、childSqlTemplate，childSqlTemplate作为一个子模板被sqlTemplate调用。sqlTemplate中select 后面的列名分为两部分，一部从数组变量columns中获取，并以“,”进行分割，另一部分从数组childColumns中获取，使用“,”分割的同时，也为每个列名增加了“t2.”的前缀，即子查询的别名。from部分中将childSqlTemplate函数模板作为一个子查询进行join。这样获得了一个比较复杂的sql语句。
java代码如下：
STGroup stg = new STGroupFile("dataExtractSql.stg");
ST sqlST = stg.getInstanceOf("sqlTemplate");
List<String> columnList = new LinkedList<String>();
columnList.add("order_id");
columnList.add("price");
columnList.add("phone");
columnList.add("user");
sqlST.add("columns", columnList);
sqlST.add("condition", "dt='2017-04-04'");
sqlST.add("joinKey", "user");
sqlST.add("tableName", "orderTable");
List<String> childColumnList = new LinkedList<String>();
childColumnList.add("user");
childColumnList.add("userLeave");
childColumnList.add("userLocation");
sqlST.add("childColumns", childColumnList);
sqlST.add("childJoinKey", "user");
sqlST.add("childTableName", "userTable");
String result = sqlST.render();
System.out.print(result);
输入内容如下：
select order_id,price,phone,user,t2.user,t2.userLeave,t2.userLocation
from orderTable as t1 left join (select user,userLeave,userLocation
from userTable
where 1=1 ) as t2 on t1.user=t2.user
where 1=1 and dt='2017-04-04'
网友评论