模板引擎StringTemplate的使用方法和特点

1,特点

1&＃xff0c;强制Model和View的分离&＃xff0c;也就是View负责呈现&＃xff0c;不能修改Model。同时View中不用来包括任何业务逻辑

2&＃xff0c;Lazy-Evaluation&＃xff0c;所有的Attribute直到st.ToString()调用时才evaluate.这样的好处是setAttribute是Order  Independent。

3&＃xff0c;Recursive enable。

2,属性(attribute)

StringTemplate语法有两种组成元素&＃xff0c;一种是属性(attribute)&＃xff0c;另一种是普通字符(plain text)。在$…$中包围的是属性&＃xff0c;其余的都是普通字符。比如&＃xff1a;

select $column$ from $table$

其中红色部分的$column$和$table$都是属性。在模板引擎呈现&＃xff0c;即调用st.ToString()时&＃xff0c;属性被实际值替换&＃xff0c;而普通字符原封不动地输出。

我们可以通过下面的方式来向模板“填充”(push)属性&＃xff1a;

public static void valid1(){StringTemplate st &＃61; new StringTemplate("select $column$ from $table$");st.setAttribute("column","123");st.setAttribute("table","234");System.out.println(st.toString());}

属性的填充方式很简单&＃xff0c;就是调用attribute.ToString()方法的结果&＃xff0c;如果attribute是null不会抛出异常&＃xff0c;而是输出空字符串。

Map值 填充

public static void valid2(){StringTemplate st &＃61; new StringTemplate("select $column$ from $table$");Map map &＃61; new HashMap();
// map.put("column","123");
// map.put("table","234");st.setAttributes(map);map.put("column","123");map.put("table","234");System.out.println(st.toString());}


对象值填充

public class Query {private String column ;private String table ;private String TABLE ;public String getColumn() {return column;}public void setColumn(String column) {this.column &＃61; column;}public String getTable() {return table;}public void setTable(String table) {this.table &＃61; table;}public String getTABLE() {return TABLE;}public void setTABLE(String TABLE) {this.TABLE &＃61; TABLE;}
}/*** 传对象*/public static void valid3(){StringTemplate st &＃61; new StringTemplate("select $b.column$ from $b.table$");Query query &＃61; new Query();query.setColumn("abc");query.setTable("bcd");query.setTABLE("fff");st.setAttribute("b",query);System.out.println(st.toString());}


间接属性值填充

public static void valid4(){StringTemplate st &＃61; new StringTemplate("$q.(property)$");Query query &＃61; new Query();query.setColumn("123");query.setTable("ttttt");query.setTABLE("TTTTT");st.setAttribute("q",query);st.setAttribute("property","table");System.out.println(st.toString());}

有些StringTemplate的保留字(reserved keyword)&＃xff0c;是不能作为属性的&＃xff1a;

如果attribute中的property和这些保留字重复了&＃xff0c;StringTemplate就会报错&＃xff0c;解决方案是使用间接属性&＃xff1a;

class Query
{public string first &＃61; "NumberOne";
}StringTemplate st &＃61; new StringTemplate("select $q.(IndirectAttr)$");Query q &＃61; new Query();
st.SetAttribute("q", q);
st.SetAttribute("IndirectAttr", "first");
Console.WriteLine(st.ToString()); //select NumberOne
//或者直接用Literal String: select $q.("first")$

2.2,多值属性(multi-valued attribute)

所谓多值属性其实就是像数组一样的可迭代对象。多值属性通常有两种输出方式&＃xff1a;1&＃xff0c;类似于String.Join()的拼接。2&＃xff0c;迭代。

A)拼接

public static void valid1(){StringTemplate st &＃61; new StringTemplate("select $columns$ from users");List columns &＃61; new ArrayList<>();columns.add("a");columns.add("b");st.setAttribute("columns",columns);System.out.println(st.toString());}//select ab from users

public static void valid2(){StringTemplate st &＃61; new StringTemplate("select $columns; separator&＃61;\",\"$ from users");List columns &＃61; new ArrayList<>();columns.add("a");columns.add("b");st.setAttribute("columns",columns);System.out.println(st.toString());//select a,b from users}

public static void valid3(){StringTemplate st &＃61; new StringTemplate("select $columns; separator&＃61;dilimiter$ from users");List columns &＃61; new ArrayList<>();columns.add("a");columns.add("b");st.setAttribute("dilimiter",",");st.setAttribute("columns",columns);System.out.println(st.toString());//select a,b from users}


B)迭代

//----------------------- 迭代 -------------------------public static void valid4(){StringTemplate st &＃61; new StringTemplate("select $columns:{ $it$ }$ from users");st.setAttribute("columns","a");st.setAttribute("columns","b");System.out.println(st.toString());}public static void valid5(){StringTemplate st &＃61; new StringTemplate("select $columns:{col|$col$}$ from users");st.setAttribute("columns","a");st.setAttribute("columns","b");System.out.println(st.toString());}