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