首页 > 代码库 > [ASPX] 模版引擎XTemplate与代码生成器XCoder(源码)
[ASPX] 模版引擎XTemplate与代码生成器XCoder(源码)
模版引擎XTemplate是一个仿T4设计的引擎,功能上基本与T4一致(模版语法上完全兼容T4,模版头指令部分兼容)。
自己设计模版引擎,就是为了代码生成器、网站模版、邮件模版等多种场合,也就是要能拿出来单独使用、功能强大并且容易控制的。T4是个很好的引擎,但是它的设计基本上倾向于vs,几乎不顾别的场合。
XTemplate特点如下:
1,完全使用C#作为模版语言。跟ASP、ASP.Net页面的解析一样,把<##>标签外的文本内容当作字符串,用一个 StringBuilder,标签内作为C#原生代码,拼在一起编译,进行模版替换时,实质上就是执行编译后的程序集,这就是XTemplate的核心原 理!网络上现有的许许多多模版引擎,要么采用标签替换,要么自创模版语言,这些都增加了使用者的学习难度。XTemplate使用C#作为模版语言,这个 世界安静了!
2,支持“调试”。不是运行时调试,而是XTemplate能够把模版编译的中间类文件以及程序集等输出,方便检查错误。如果把模版编译后的程序集保存下来,可以在没有模版文件的情况下直接使用模版功能。
3,不需要ASP.Net支持。有部分模版引擎,是模拟一个ASP.Net服务器,然后以ASP.Net作为模版来实现,这就要求有一个ASP.Net服务器作为宿主,限制了模版引擎的使用范围。
4,支持批量编译。可以把多个模版放入模版处理器,进行一次编译(所有模版类都编译到一个程序集里面去)。
5,支持类成员。模版内容默认情况下将会统一编译到一个类的Render方法里面去,但是有时候我们需要给这个类增加一些属性和方法,此时可以使 用<#! #>标签,序数为单数表示开始,序数为偶数表示结束,所以不限制类成员代码的位置(T4要求只能写在模版的最后面)。
6,支持自定义基类。默认情况下,所有编译生成的模版类都继承自TemplateBase,你也可以创建自己的模版基类,然后在模版头通过指令,或者通过 外部宿主指定自定义的模版基类,模版中可以直接使用自定义模版基类的成员(因为继承嘛),比如代码生成器XCoder中的XCoderBase。
7,自动引用宿主程序集。T4在使用上最大的麻烦就是引用外部程序集和命名空间,毕竟不是在vs里面编写C#代码。XTemplate在编译的时候,自动 引用宿主(就是调用者,比如XCoder)的所有应用程序集,同时引用大部分常用的明明空间,因为这样,生成的类很臃肿,但是编译的时候,编译器会自动去 掉无用的引用。XTemplate从完成到现在为止,还没有用过引用程序集和命名空间的问题,因为一般来说,模版中需要用到的程序集,宿主里面一般都有用 到,非常符合我们的使用习惯。
8,与宿主的良好交互。在XTemplate中,编译的模版程序集是直接加载在默认域,这点与T4不同,T4会新建一个域,应该是为了防止模版代码弄脏默 认域的数据吧(比如干扰vs运行)。因为在同一个域,XTemplate与宿主进行交互,就不需要“FQ”(跨域)了。XTemplate的处理过程分为 分析、编译和执行三步,都可以由外部控制,比如有时候我们只是需要检查一下模版的语法,只需要检查一下模版语法是否正确,这个时候编译一下就可以了。
9,更多的特点需要大家来发现!
XCoder使用XTemplate代码(后面有XCoder的项目代码):
Dictionary<String, Object> data = http://www.mamicode.com/new Dictionary<string, object>();data["Config"] = Config;data["Tables"] = Tables;data["Table"] = table;// 声明模版引擎Template tt = new Template();Template.Debug = Config.Debug;foreach (String item in ss){ if (item.EndsWith("scc", StringComparison.Ordinal)) continue; String tempFile = item; if (!Path.IsPathRooted(tempFile) && !tempFile.StartsWith(TemplatePath, StringComparison.OrdinalIgnoreCase)) tempFile = Path.Combine(TemplatePath, tempFile); String content = File.ReadAllText(tempFile); // 添加文件头 if (Config.UseHeadTemplate && !String.IsNullOrEmpty(Config.HeadTemplate)) content = Config.HeadTemplate + content; tt.AddTemplateItem(item, content);}tt.Process();// 编译模版tt.Compile();List<String> rs = new List<string>();foreach (String item in ss){ if (item.EndsWith("scc", StringComparison.Ordinal)) continue; //String content = RenderFile(table, item, data); String content = tt.Render(item, data); // 计算输出文件名 String fileName = Path.GetFileName(item); String className = CutPrefix(table.Name); className = FixWord(className); String remark = table.Description; if (String.IsNullOrEmpty(remark)) remark = ENameToCName(className); if (Config.UseCNFileName && !String.IsNullOrEmpty(remark)) className = remark; fileName = fileName.Replace("类名", className).Replace("类说明", remark).Replace("连接名", Config.EntityConnName); fileName = Path.Combine(OuputPath, fileName); File.WriteAllText(fileName, content, Encoding.UTF8); rs.Add(content);}
XTemplate设计图(我喜欢先做图再编码):
- 1,日志组件XLog
- 2,ORM组件XCode(速览)
- 3,ORM组件XCode(简介)
- 4,与ObjectDataSource共舞
- 5,ORM组件XCode(动手)
- 6,ORM组件XCode(撬动千万级数据)
- 7,ORM组件XCode(十八般武艺)
- 8,协议序列化组件NewLife.Serialization
- 9,模版引擎XTemplate与代码生成器XCoder(源码)
- 性能&分布式&NewLife.XCode对无限数据的支持
- 改进版CodeTimer及XCode性能测试
- 新生命开发团队Orm框架XCode v3.5.2009.0714源码发布(圣诞随心大礼包)
- 数据映射框架XCode开源地址http://xcode.codeplex.com
[ASPX] 模版引擎XTemplate与代码生成器XCoder(源码)