详解模版引擎XTemplate与代码生成器XCode（源码）-51CTO.COM

模版引擎XTemplate与代码生成器XCode是本文要介绍的内容，主要是来学习模版引擎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，你也可以创建自己的模版基类，然后在模版头通过指令，或者通过外部宿主指定自定义的模版基类，模版中可以直接使用自定义模版基类的成员（因为继承嘛），比如代码生成器XCode中的XCodeBase。

7、自动引用宿主程序集。T4在使用上***的麻烦就是引用外部程序集和命名空间，毕竟不是在vs里面编写C#代码。XTemplate在编译的时候，自动引用宿主（就是调用者，比如XCode）的所有应用程序集，同时引用大部分常用的明明空间，因为这样，生成的类很臃肿，但是编译的时候，编译器会自动去掉无用的引用。XTemplate从完成到现在为止，还没有用过引用程序集和命名空间的问题，因为一般来说，模版中需要用到的程序集，宿主里面一般都有用到，非常符合我们的使用习惯。

8、与宿主的良好交互。在XTemplate中，编译的模版程序集是直接加载在默认域，这点与T4不同，T4会新建一个域，应该是为了防止模版代码弄脏默认域的数据吧（比如干扰vs运行）。因为在同一个域，XTemplate与宿主进行交互，就不需要“***”（跨域）了。XTemplate的处理过程分为分析、编译和执行三步，都可以由外部控制，比如有时候我们只是需要检查一下模版的语法，只需要检查一下模版语法是否正确，这个时候编译一下就可以了。

9、更多的特点需要大家来发现！

XCode使用XTemplate代码（后面有XCode的项目代码）：

Dictionary<String, Object> data = 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;  
    fileNamefileName = fileName.Replace("类名", className).Replace("类说明", remark).Replace("连接名", Config.EntityConnName);  
 
    fileName = Path.Combine(OuputPath, fileName);  
    File.WriteAllText(fileName, content, Encoding.UTF8);  
 
    rs.Add(content);  
}

XTemplate设计图（我喜欢先做图再编码）单击放大：

小结：详解模版引擎XTemplate与代码生成器XCode（源码）的内容介绍完了，希望通过本文的学习能对你有所帮助！