看来越来越多的人对DCG感兴趣了,这我很高兴,不过大家不必太着急,我也是在边做边给大家一个预览,这总比等待所有都做好后在告诉大家要好的多,大家可以知道第一手消息。;-)
不过我也不愿意拖的太久,所以周五下班后就请朋友将做好的DCG上传了,同时还上传了在上一次提到的读取XML文件的示例。下载地址分别为
http://www.swallow.net.cn/dcg/dcg.zip
http://www.swallow.net.cn/dcg/ConstructClassForXml.zip
在这里对朋友Laser的感谢,多谢为我提供空间^_^ 为了让读者在下载后能够马上运用起DCG,我觉得有必要在这里稍微描述一下动态模板的语法,其实很简单,规则如下:
<%@ header params="value" %>,这种形式的tag是模板的headers,模板所支持的所有headers如下:
<%@ Template Language="language" [Name="templateName"] [Version="templateVersion"] %>,模板必须有这么一个header,有了这个header,一个模板才算是正确的模板,它的Language属性指定了模板中动态代码使用的是什么语言。此header只能出现一次。
<%@ Assembly Location="assemblyLocation" %>,这个header指出模板要引用哪个程序集,注意被引用的程序集必须在模板的根目录下,并且在指定引用时不能有任何路径信息,如:<% Assembly Location="MyAssembly.dll" %>。这个tag可以多次出现。
<%@ Import Namespace="namespace" [As="alias"] %>,就像C#中的using namespace一样,这个header导入模板中的动态代码要用到的命名空间。可以多次出现。
<%@ Parameter Name="paramName" DataType="paramDataType" %>,这是个比较关键的header,它指定模板为了运作需要哪些参数,这些参数又分别是什么类型的。可以多次出现。
<% code block %>,在这种tag中的代码为动态代码,这种动态代码并不返回任何值。
<%= code block %>,在这种tag中的代码为动态代码,这种动态代码要求返回值。
<%# function block %>,这种tag定义了一个模板方法,这种模板方法可以在模板的任何其他地方调用。
<%-- comment block --%>,位于这种tag之内的所有文字都被视为注释,在解析时将会被忽略掉。
DCG内置类,这个内置类可在任何地方调用,目前它含有两个成员,如下:
FileInfo,一个System.IO.FileInfo类型的属性,含有关于模板物理文件的信息,如CreationTime等。
CallTemplate方法,这个方法有两个参数,C#中签名如下,string CallTemplate(string templatePath, object[] paramValues),第一个参数要求被调用的模板路径,第二个参数要求被调用模板所需要的参数对象。另外关于这个嵌套模板的使用,读者要注意避免循环调用现象,否则会出现死循环。
好了,这就是基本的模板语法了,比较简单,尤其是用过CodeSmith或ASP的人就更容易上手了。至于OCD的语法嘛,实际上90%与模板的语法一样,只是稍有不同,不同之处如下:
header中的Template被改为OCD以明确他们之间的不同。
header中Parameter被改为Object以表达在模板中是接受一个参数,而在OCD中是制造一个对象的区别。
模板中的动态代码是放在<% %>中,而OCD却不用,因为OCD中的代码全部都是动态的,但OCD中的方法还是用模板同样的语法,即<%# %>。
好了,除了这些不同外,它们完全一样。懂得了模板与OCD的语法后,你就能下载DCG v1.3.4.0并马上开始使用了。DCG文件包包括以下文件:
DCG.dll,DCG本身。
Clean.exe,需与DCG放在一起使用,用来清理临时文件,如果不和DCG在同一个目录下,那么运行所产生的临时文件就是个问题了,所以必须重视哦。
dcgconsole.exe,以前所提到的Console Application,使用方法请见dcgconsole本身(在提示行下输入dcgconsole不加参数)。
如果你想将直接引用DCG.dll在你的项目中使用的话,那么调用模板的C#示例方法如下:
// 获得模板管理器。
ITemplateManager templateManager = TemplateManager.Instance;
// 通过模板管理器获得模板。
ITemplate myFirstTemplate = templateManager.GetTemplate(ReadTemplateContent(templateLocation), templateLocation);
// 准备模板所需要的参数对象。
string templateNameParam = "123";
// 调用模板返回结果。
string result = myFirstTemplate.GenerateCode(new object[] {templateNameParam});
正如你所见,在你的代码中调用模板其实很简单,不过注意这里我没有加任何try catch代码,实际运用中模板经常会因为各种原因出错,比如模板定义不对,模板中的动态代码有编译错误、模板中的动态代码有运行错误等等,所以DCG中还给出了一系列的异常类型来提供对异常的分类与处理,关于这个读者可以看看DCG.dll的每个类型,我想看一下就足够理解它们的了,至于详细文档,我会慢慢给出的,毕竟我的时间也不是很多。
最后我希望读者帮忙给出意见,无论是你觉得DCG好还是坏,都希望读者能对DCG给出反馈,以便我对它的加强,谢谢,并祝您编码愉快!