CodeSmith (转)

CodeSmith 是一种基于模板的代码生成工具，它使用类似于 ASP.NET 的语法来生成任意类型的代码或文本。与其他许多代码生成工具不同，CodeSmith 不要求您订阅特定的应用程序设计或体系结构。使用 CodeSmith，可以生成包括简单的强类型集合和完整应用程序在内的任何东西。 

当您生成应用程序时，您经常需要重复完成某些特定的任务，例如编写数据访问代码或者生成自定义集合。CodeSmith 在这些时候特别有用，因为您可以编写模板自动完成这些任务，从而不仅提高您的工作效率，而且能够自动完成那些最为乏味的任务。CodeSmith 附带了许多模板，包括对应于所有 .NET 集合类型的模板以及用于生成存储过程的模板，但该工具的真正威力在于能够创建自定义模板。为了使您能够入门，我将快速介绍一下如何生成自定义模板。 


生成自定义模板 
CodeSmith 模板只是一些可以在任意文本编辑器中创建的文本文件。它们的唯一要求是用 .cst 文件扩展名来保存它们。我将要生成的示例模板将接受一个字符串，然后基于该字符串生成一个类。创建模板的第一步是添加模板头，它可声明模板的语言、目标语言以及简要模板说明： 

<%@ CodeTemplate Language="C#" 
TargetLanguage="C#" 
Description="Car Template" %> 

模板的下一部分是属性声明，在这里可声明将在模板每次运行时指定的属性。就该模板而言，我要使用的唯一属性只是一个字符串，因此属性声明如下所示： 

<%@ Property Name="ClassName" Type="String" Category="Context" 
Description="Class Name" %> 

该属性声明将使 ClassName 属性出现在 CodeSmith 属性窗口中，以便可以在模板运行时指定它。下一步是实际生成模板主体，它非常类似于用 ASP.NET 进行编码。Custom Template 
public sealed class <%= ClassName %> 
{ 
private static volatile <%= ClassName %> _instance; 
private <%= ClassName %>() {} 
private static readonly object _syncRoot = new object(); 

public static <%= ClassName %> Value 
{ 
get 
{ 
if (_instance == null) 
{ 
lock(_syncRoot) 
{ 
if (_instance == null) 
{ 
_instance = new <%= ClassName %>(); 
} 
} 
} 
return _instance; 
} 
} 
} 

SingletonClass 
public sealed class SingletonClass 
{ 
private static volatile SingletonClass _instance; 
private SingletonClass() {} 
private static readonly object _syncRoot = new object(); 

public static SingletonClass Value 
{ 
get 
{ 
if (_instance == null) 
{ 
lock(_syncRoot) 
{ 
if (_instance == null) 
{ 
_instance = new SingletonClass(); 
} 
} 
} 
return _instance; 
} 
} 
} 


正如您所见，该模板接受字符串输入并使用该类名生成单独的类。在模板主体中，使用与 ASP.NET 中相同的起始和结束标记。在该模板中，我只是插入属性值，但您还可以在这些标记内部使用任意类型的 .NET 代码。在该模板完成之后，您就可以通过双击它或者从 CodeSmith 应用程序中打开它将其加载到 CodeSmith 中。图中显示了已经加载到 CodeSmith 中的该模板。 


您可以看到左侧的属性正是我在该模板中声明的属性。如果我输入“SingletonClass”作为类名，并单击 Generate 按钮，则将生成底部显示的类。 

CodeSmith 使用起来相当容易，如果能够正确应用，则可以产生一些令人难以置信的结果。面向代码生成的应用程序中最常见的部分之一是数据访问层。CodeSmith 包括一个名为 SchemaExplorer 的特殊的程序集，可用来从表、存储过程或几乎任何其他 SQL Server? 对象生成模板。 

CodeSmith 由 Eric J. Smith 编写，并且可以在  http://www.ericjsmith.net/codesmith 下载。