从.NET诞生之日起就有了XML类库,但是从使用上来说非常不方便。例如我们需要构造一个XML文档时,使用DOM API就要这样搞:
var xmlDoc = new XmlDocument(); var rootEle = xmlDoc.CreateElement("persons"); xmlDoc.AppendChild(rootEle); var person1 = xmlDoc.CreateElement("person"); person1.InnerText = "Tom"; var person1Age = xmlDoc.CreateAttribute("age"); person1Age.Value = "10"; person1.Attributes.Append(person1Age); rootEle.AppendChild(person1); var person2 = xmlDoc.CreateElement("person"); person2.InnerText = "Jerry"; var person2Age = xmlDoc.CreateAttribute("age"); person2Age.Value = "8"; person2.Attributes.Append(person2Age); rootEle.AppendChild(person2);
别看这么多行代码,但实际上它只构造了这么简单的一个XML:
<persons> <person age="10">Tomperson> <person age="8">Jerryperson> persons>
我承认,DOM API的确非常严谨(如XmlDocument和XmlElement的归属关系),非常符合定义,也非常的面向对象,但是这易用性也实在太差了。记得在03还是04年的时候,我为在为项目做一个编辑XML文档的WinForm应用程序,当时也不像现在那么容易想到“偷懒”的法门,而VS 2003也不像VS 2005/2008那么好用,因此可谓做的劳心费神。这个情况在.NET 2.0中也没有得到改变,直到有一天,LINQ to XML随.NET 3.5横空出世,于是乎XML的生活一下子变得美好了很多。例如上面的功能只需寥寥数行便可以实现:
var xmlDoc = new XElement("persons", new XElement("person", "Tom", new XAttribute("age", 10)), new XElement("person", "Jerry", new XAttribute("age", 8)));
虽然LINQ to XML一直是所谓C# 3.0中LINQ特性的一部分,与LINQ to SQL,LINQ to Object及LINQ to……某个别的并列,但我始终认为LINQ to XML实则还是LINQ to Object的一种特殊形式,只是它用于操作XML而已。它的一切都是System.Xml.Linq命名空间下相关类库(如XElement)在起作用,不关LINQ什么事情。XElement等相关类型大大简化了我们的开发,与DOM API相比,无论是XML的构造还是读取都容易了许多。不过俗话说得好:“不怕不识货,就怕货比货”,这样的API与Ruby Markup Builder相比还是有明显差距。请看:
builder = Builder::XmlMarkup.new xml = builder.persons { |b| b.person("Tom", :age => "10") b.person("Jerry", :age => "8") }
请看上面这段代码,它自然没有使用Ruby语言的标准着色方式。我着色的目的是体现这个构造方式中的“噪音”——也就是与XML内容无关的部分。从中可以发现,Ruby不愧是一种噪音较少的语言,如果您尝试使用这个方式来观察C#中LINQ to XML的做法,就会发现两者之间的确有明显的差距。当然,如果使用VB.NET的XML Literal可能噪音也很少,但是在我看来,XML Literal在XML构造方面的表现有些罗嗦,例如它需要开发人员同时提供元素的开始标签和闭合标签,可能在IDE的帮助下此类代码输入较为简单,但是代码还是略显冗余。
但是我们这些可怜的C#程序员难道只有在一边眼馋的份吗?不见得,我们也可以来“享受”一把:
dynamic b = new XmlMarkupBuilder(); XElement xml = b.persons( b.person("Tom", age: 10), b.person("Jerry", age: 8));
哇,这是什么,怎么代码那么简单。很明显,从dynamic关键字上可以看出,这是C# 4.0中新增的功能。您可能会想“原来.NET 4.0对XML又有增强了”……其实并非如此,这是我们自己扩展的功能。不过这应该算是更好的消息,因为这说明我们已经有能力自行扩展,自行设计这样的API了——这可是“渔”,比“鱼”可要值钱多了。而实现这样的功能也只需要短短二十几行C#代码:
public class XmlMarkupBuilder : DynamicObject { public override bool TryInvokeMember(InvokeMemberBinder binder,
object[] args, out object result) { XElement xml = new XElement(binder.Name); var attrCount = binder.CallInfo.ArgumentNames.Count; var elementCount = args.Length - attrCount; for (int i = 0; i < elementCount; i++) { xml.Add(args[i]); } for (var i = 0; i < attrCount; i++) { var attrName = binder.CallInfo.ArgumentNames[i]; if (attrName[0] == '@') attrName = attrName.Substring(1); xml.Add(new XAttribute(attrName, args[i + elementCount])); } result = xml; return true; } }
DynamicObject是个特殊的对象,简单地说它的行为可以被“扩展”——是如动态语言般真正的扩展,而非静态的多态。当我们使用dynamic修饰变量后,在它之上的方法调用会由编译器和DLR配合出不一样的行为。例如,我们在调用一个方法的时候,DLR会先检查这个动态对象上是否存在符合这个签名的方法,存在则最好,否则便会调用TryInvokeMember来“执行”一个动态方法,而它的参数便是此次调用的全部信息。这样的做法被称为“Method Missing”操作,事实上Ruby Markup Builder也是使用Ruby对象中的这个特性来实现“调用什么方法,便生成什么元素”的功能。事实上,我们还可以这么用:
var persons = new [] { new Person("Tom", 10), new Person("Jerry", 8) }; XElement xml2 = b.persons( from p in persons select b.person(p.Name, age: p.Age));
XmlMarkupBuilder对LINQ的直接支持得益于XElement无与伦比的“包容性”(因此我认为LINQ to XML其实只是LINQ to Object + 类库)。至于age: 10这样的代码,其实是使用了C# 4.0的新特性:命名参数(Named Parameters)——C#还真把什么都为我们准备好了。
即便是大部分DynamicObject的示例都喜欢拿XML操作开涮(但还是没有出现我这篇的用法,所以我还是“原创”),但事实上这个功能可发挥的余地非常之大。例如,陈猫同学提到他想用这个功能来简化Silverlight中的JSON操作,刚“喜得贵女”的Phil Haack同学在上个月也提到一个设想,它在ASP.NET MVC中使用dynamic关键字来修饰View的Model,这样在访问Model的属性时变可附加一些约定好的操作。例如,Model.Content表示读取Content属性的内容,而Model._Content则表示在读取Content之后自动进行HTML编码。这无疑简化了我们的开发——当然,强类型的各种优势就不复存在了。
而这个功能对我的意义在于,我又找到了一种设计API的方式,它可以使类库变得简单好用——就好比上面的XmlMarkupBuilder一样。虽然,这个示例的功能非常简单,但是这也足以证明C# 4.0中的dynamic特性并不仅仅是“方便Interop操作”或是“简化反射”这么简单,如果我们可以发挥想象能力,加以充分利用同时又不滥用,我们的程序开发生活就会变得越来越美好。
最后……我还是承认了吧,这篇文章其实是标题党,真正Ruby Markup Builder功能非常强大而复杂,我们的XmlMarkupBuilder类只能算是冰山一角而已。