StringTemplate.Net 学习笔记（4）：表达式元素语法(下)

6.匿名模板/遍历
匿名模板的语法为：$attribute:{anonymous-template}$，遍历attribute，对每个元素都应用此匿名模板，自动设置it为当前元素名称：
string[] strArray = new string[] { "a","b","c" }; StringTemplate st = new StringTemplate("$array:{当前元素$it$};separator=\",\"$"); st.SetAttribute("array", strArray); Console.WriteLine(st.ToString());
输出结果：当前元素a,当前元素b,当前元素c
假如不想使用it作为当前元素名称，可以手动设置：
string[] strArray = new string[] { "a","b","c" }; StringTemplate st = new StringTemplate("$array:{current|当前元素$current$};separator=\",\"$"); st.SetAttribute("array", strArray); Console.WriteLine(st.ToString());
以上都是对attribute应用单个匿名模板，多个匿名模板的使用方法与单个一样，只不过是模板个数的差别。
顺序(从左到右)应用多个模板，对每个attribute的元素都应用多个模板。
语法：$attribute:{anonymous-template1}:{anonymous-template2}...:{anonymous-templateN}$ ，示例：
string[] strArray = new string[] { "a","b","c" }; StringTemplate st = new StringTemplate("$array:{当前元素$it$}:{current|'$current$'}:{[$it$]}$"); st.SetAttribute("array", strArray); Console.WriteLine(st.ToString());
输出结果：['当前元素a']['当前元素b']['当前元素c']
交替应用多个模板，与顺序应用不同的是，每个attribute的元素只应用一个模板。
语法：$attribute:{anonymous-template1},{anonymous-template2}...,{anonymous-templateN}$，示例 ：
string[] strArray = new string[] { "a","b","c" }; StringTemplate st = new StringTemplate("$array:{current|当前元素$current$},{样式2$it$},{样式3$it$};separator=\",\"$"); st.SetAttribute("array", strArray); Console.WriteLine(st.ToString());
输出结果：当前元素a,样式2b,样式3c
还可以同时应用交替模板与顺序模板，每隔一个冒号":"为一组：
string[] strArray = new string[] { "a","b","c" }; StringTemplate st = new StringTemplate("$array:{样1式$it$},{样2式$it$}:{'$it$'},{|$it$|}:{[$it$]},{<$it$>},{($it$)}$"); st.SetAttribute("array", strArray); Console.WriteLine(st.ToString());
输出：['样1式a']<|样2式b|>('样1式c')
以上都是遍历单个集合参数，可以使用多个参数：
string[] array1 = new string[] { "a","b","c" }; string[] array2 = new string[] { "d","e" }; StringTemplate st = new StringTemplate("$array1, array2:{a1,a2|$a1$,$a2$};separator=\"-\"$"); st.SetAttribute("array1", array1); st.SetAttribute("array2", array2); Console.WriteLine(st.ToString());
输出结果：a,d-b,e-c,
当使用多个集合参数时，如果集合元素个数不一致，则以元素个数最多的那个集合为准。
另外要注意，多个参数不能应用多个模板(也可能是我没找到方法)。
话说自动设置的当前元素名称除了it外，还设置了attr，这个是从riccc翻译的http://www.cnblogs.com/RicCC/archive/2007/06/03/Enforcing-Strict-Model-View-Separation-in-Template-Engines.html看到的，it和attr可以同时使用，不过手动设置了当前元素名称以后，it和attr都会失效。
7.模板文件
为了方便演示，将使用到的模板文件都放到bin\debug目录下(当前运行在debug模式下)
先新建一个模板文件，名称为template1.st，内容为：
$title$
调用：
StringTemplate query = new StringTemplate("$template1()$"); query.SetAttribute("title", "StringTemplate学习"); Console.WriteLine(query.ToString());
输出：StringTemplate学习
还可以直接传递值：
StringTemplate query = new StringTemplate("$template1(title=\"StringTemplate学习\")$"); Console.WriteLine(query.ToString());
或者通过另外定义的变量传递：
StringTemplate query = new StringTemplate("$template1(title=mtitle)$"); query.SetAttribute("mtitle", "StringTemplate学习"); Console.WriteLine(query.ToString());
如果被调用的模板文件名为保留字，如：first，则相应调用代码为$("first")()$
新建一个模板，名称为anonymous1.st，内容：
$it$
使用匿名模板作为参数传递：
StringTemplate st = new StringTemplate("$anonymous1(it={$name1$ $name2$})$"); st.SetAttribute("name1", "囧"); st.SetAttribute("name2", "月"); Console.WriteLine(st.ToString());
输出：囧 月
新建一个模板format1.st，内容：
‘囧月’
新建一个模板format2.st，内容：
[$item$]
把模板作为参数传递：
StringTemplate st = new StringTemplate("$format2(item=format1())$"); Console.WriteLine(st.ToString());
输出：[‘囧月’]
模板应用到attribute
新建一个模板，名称为user1.st，内容：
姓名：$it.Name$,年龄：$it.Age$
声明一个User类型
class User { public string Name {get;set;} public int Age {get;set;} }
单个对象：
User u =new User { Name = "囧月", Age = 1 }; StringTemplate st = new StringTemplate("$users:user1()$"); st.SetAttribute("users", u); Console.WriteLine(st.ToString());
输出：姓名：囧月,年龄：1
集合：
User[] u = new User[]{ new User { Name = "囧月", Age = 1 }, new User { Name = "小强", Age = 2 }, new User { Name = "小红", Age = 3 } }; StringTemplate st = new StringTemplate("$users:user1();separator=\"|\"$"); st.SetAttribute("users", u); Console.WriteLine(st.ToString());
输出：姓名：囧月,年龄：1｜姓名：小强,年龄：2｜姓名：小红,年龄：3
新建一个模板文件user2.st，内容：
$title$ 姓名：$it.Name$,年龄：$it.Age$
传递参数：
User u = new User { Name = "囧月", Age = 1 }; StringTemplate st = new StringTemplate("$users:user2(title=mtitle)$"); st.SetAttribute("users", u); st.SetAttribute("mtitle", "StringTemplate学习"); Console.WriteLine(st.ToString());
输出：StringTemplate学习 姓名：囧月,年龄：1
不再一一演示，其他使用方式与匿名模板一样，区别在于：

1. 模板内容外置
2. 模板调用部分的{anonymous-template}符号换成模板文件名：template()

8.其他
string[] strArray = new string[] { "a","b","c","d",null,"e" }; StringTemplate st = new StringTemplate("第一个：$first(array)$ 最后一个：$last(array)$ 换行：$\\n$ 排除第一个$rest(array)$ 制表符$\\t$ 排除最后一个$trunc(array)$ 回车：$\\r$ 忽略空元素：$strip(array)$ 输出当前的默认表达式分隔符\\$ 长度：$length(array)$ unicode字符：$\\u56E7$ 忽略空元素之后的长度：$length(strip(array))$ $! 注释注释注释注释 !$"); st.SetAttribute("array", strArray); Console.WriteLine(st.ToString());
输出：
第一个：a 最后一个：e 换行： 排除第一个bcde 制表符 排除最后一个abcd 回车： 忽略空元素：abcde 输出当前的默认表达式分隔符$ 长度：6 unicode字符：囧 忽略空元素之后的长度：5
最后，来一个简单且完整点的例子，作为表达式元素语法部分的总结吧~
新建文件user0.st，内容：
$! 显示用户列表 !$ $\t$\$用户列表 -- $\u56E7\u6708$\$： $users:user1(),user2(),user3()$ $\n$ 记录总数：$length(users)$
新建文件user1.st，内容
$\n$[序号：$i$,姓名：$it.Name$,年龄：$it.Age$]
新建文件user2.st，内容
$\n${序号：$i$,姓名：$it.Name$,年龄：$it.Age$}
新建文件user3.st，内容
$\n$'序号：$i$,姓名：$it.Name$,年龄：$it.Age$'
代码：
class User { public string Name {get;set;} public int Age {get;set;} } public static void Main(string[] args) { User[] u = new User[]{ new User { Name = "囧月", Age = 1 }, new User { Name = "小强", Age = 2 }, null, new User { Name = "小红", Age = 3 }, new User { Name = "小黑", Age = 3 }, new User { Name = "小白", Age = 3 }, new User { Name = "小蓝", Age = 3 }, new User { Name = "小绿", Age = 3 } }; StringTemplateGroup stg = new StringTemplateGroup("stgroup", Environment.CurrentDirectory); StringTemplate st = stg.GetInstanceOf("user0"); st.SetAttribute("users", u); Console.WriteLine(st.ToString()); Console.ReadKey(true); }
输出：
$用户列表 -- 囧月$： [序号：1,姓名：囧月,年龄：1] {序号：2,姓名：小强,年龄：2} '序号：3,姓名：小红,年龄：3' [序号：4,姓名：小黑,年龄：3] {序号：5,姓名：小白,年龄：3} '序号：6,姓名：小蓝,年龄：3' [序号：7,姓名：小绿,年龄：3] 记录总数：8
弄的我晕晕乎乎,但愿没有遗漏~
困死了，准备睡觉了
参考：http://www.antlr.org/wiki/display/ST/Expressions

延伸阅读