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

1.简单属性
对于简单属性(区别于集合类型)，都是直接调用它的ToString()方法
StringTemplate query = new StringTemplate("$title$");
query.SetAttribute("title", "StringTemplate学习");
Console.WriteLine(query.ToString());输出：StringTemplate学习再看一个例子：
StringTemplate query = new StringTemplate("$title$");
query.SetAttribute("title", typeof(object));
Console.WriteLine(query.ToString());输出：System.Object
2.集合的索引
string[] strArray = new string[] { "a","b","c","d","e" };
StringTemplate query = new StringTemplate("$array:{\n当前索引 从1开始计算：$i$，从0开始计算：$i0$ }$");
query.SetAttribute("array", strArray);
Console.WriteLine(query.ToString());输出：
当前索引 从1开始计算：1，从0开始计算：0
当前索引 从1开始计算：2，从0开始计算：1
当前索引 从1开始计算：3，从0开始计算：2
当前索引 从1开始计算：4，从0开始计算：3
当前索引 从1开始计算：5，从0开始计算：4集合不限于Array，可以是实现IList,ICollection,IDictionary等接口的类型。
3.属性引用
如果attribute是一个集合 或 自定义类型，则可以通过attribute.property访问它的属性，自定义类型
class User {
public string Name {get;set;}
public int Age {get;set;}
}
public static void Main(string[] args)
{
User u = new User { Name = "囧月", Age = 1 };
StringTemplate query = new StringTemplate("姓名：$user.Name$，年龄：$user.Age$");
query.SetAttribute("user", u);
Console.WriteLine(query.ToString());
} 输出：姓名：囧月，年龄：1集合类型，可以是Dictionary，HashTable等有Key/Value的对象，如：
Dictionary u = new Dictionary(1);
u.Add("Name", "囧月");
u.Add("Age", "1");
StringTemplate query = new StringTemplate("姓名：$user.Name$，年龄：$user.Age$");
query.SetAttribute("user", u);
Console.WriteLine(query.ToString());还有一种情况，应该属性ST的自定义集合，没有详细研究：
StringTemplate st = new StringTemplate("$user:{姓名：$it.Name$，年龄：$it.Age$}$");
st.SetAttribute("user.{Name,Age}","囧月", 1);
Console.WriteLine(st.ToString());
当有保留字时：
Dictionary items = new Dictionary();
items.Add("first", "第一");
items.Add("last", "最后");
items.Add("1", "数字1");
StringTemplate st = new StringTemplate("$items.(\"first\")$，$items.(\"last\")$, $items.(\"1\")$");
st.SetAttribute("items", items);
Console.WriteLine(st.ToString()); 输出：第一,最后,数字1其中first、last为保留字，数字1不能直接作为属性名称来引用，与保留字同样处理
下面再看一个错误的例子，当key为int类型时，数字作为保留字处理不能得到预期的结果：
Dictionary dict = new Dictionary();
dict.Add(1,11);
dict.Add(2,22);
dict.Add(3,33);
StringTemplate st1 = new StringTemplate("$u.(\"1\")$");
st1.SetAttribute("u", dict);
Console.WriteLine(st1.ToString());这个例子输出为空，应该只能使用集合的方式来得到值
4.多个属性/集合
string[] strArray = new string[] { "a","b","c","d","e" };
StringTemplate query = new StringTemplate("$array$");
query.SetAttribute("array", strArray);
Console.WriteLine(query.ToString()); 输出：abcde它等效于：
string[] strArray = new string[] { "a","b","c"};
StringTemplate query = new StringTemplate("$array$");
query.SetAttribute("array", strArray);
query.SetAttribute("array", "d");
query.SetAttribute("array", "e");
Console.WriteLine(query.ToString());最终都会把array合并成一个集合
Type[] typeArray = new Type[]{typeof(object),typeof(string),typeof(int),typeof(IList)};
StringTemplate query = new StringTemplate("$array$");
query.SetAttribute("array", typeArray);
Console.WriteLine(query.ToString()); 输出：System.ObjectSystem.StringSystem.Int32System.Collections.IList通过以上例子可以看出，ST对集合类型，都是先调用每个元素的ToString()方法，再把它们连接起来。
而且默认情况下，是没有分隔符的。接下来看一下分隔符的使用，分隔符两边必须加上双引号：
string[] strArray = new string[] { "a","b","c","d","e" };
StringTemplate query = new StringTemplate("$array;separator=\"--\"$");
query.SetAttribute("array", strArray);
Console.WriteLine(query.ToString()); 结果：a--b--c--d--e当集合中有元素为null的时候，这个元素将不会被输出，如果需要输出，则需要指定null条件：
string[] strArray = new string[] { "a",null,"c",null,"e" };
StringTemplate query = new StringTemplate("$array;null=\"k\",separator=\"--\"$");
query.SetAttribute("array", strArray);
Console.WriteLine(query.ToString()); 结果：a--k--c--k--e (如果未指定null则为：a--c--e)
5、集合合并
对于多个attribute参数，使用方括号把它们合并成单个集合：
string[] array1 = new string[] { "a","b","c" };
string[] array2 = new string[] { "d","e" };
StringTemplate query = new StringTemplate("$[list1,list2]:{$it$};separator=\",\"$");
query.SetAttribute("list1", array1);
query.SetAttribute("list2", array2);
Console.WriteLine(query.ToString()); 输出结果：a-b-c-d-e可以看到array1和array2被合并成1个集合，如果模板定义改为$[list1,list2]:{x,y|$x$,$y$};separator=","$则会出现错误。
再看一个例子，不同元素长度：
StringTemplate st1 = new StringTemplate("$[a,b,c]:{$it$};separator=\",\"$");
st1.SetAttribute("a", "aa");
st1.SetAttribute("b", new string[]{"b","c","d"});
st1.SetAttribute("c", typeof(object));
Console.WriteLine(st1.ToString()); 输出结果：aa,b,c,d,System.Object再看一个例子，不同类型的合并：
StringTemplate st1 = new StringTemplate("$[a,b,c]:{$if(it.Name)$ $it.Name$ $else$ $it$ $endif$};separator=\",\"$");
st1.SetAttribute("a", new User{Name="aa"});
st1.SetAttribute("b", new User[]{new User{Name="b"},new User{Name="c"},new User{Name="d"}});
st1.SetAttribute("c", typeof(object));
Console.WriteLine(st1.ToString()); 输出结果： aa , b , c , d , Object可以看出支持不同类型合并到同一个集合
另外，虽然与$list1,list2:{ x,y | ...}$只差了一对方括号[]，但绝对不是一样的。
看起来内容有点多，还是分成2部分吧，省得等下格式乱掉了。
参考：http://www.antlr.org/wiki/display/ST/Expressions
原文来自：雨枫技术教程网 http://www.fengfly.com
原文网址：http://www.fengfly.com/plus/view-175119-1.html

Tags: 

延伸阅读