CodeSmith 使用教程(1): 概述

前面正在介绍hibernate的开发教程,提到hibernate 在.Net 平台上相应的ORM工具为NHibernate ,使用NHibernate 就不能不提到CodeSmith。

CodeSmith 是一种基于模板的代码生成工具,它使用类似于 ASP.NET 的语法来生成任意类型的代码或文本。与其他许多代码生成工具不同,CodeSmith 不要求您订阅特定的应用程序设计或体系结构。使用 CodeSmith,可以生成包括简单的强类型集合和完整应用程序在内的任何东西。   当您生成应用程序时,您经常需要重复完成某些特定的任务,例如编写数据访问代码或者生成自定义集合。CodeSmith 在这些时候特别有用,因为您可以编写模板自动完成这些任务,从而不仅提高您的工作效率,而且能够自动完成那些最为乏味的任务。CodeSmith 附带了许多模板,包括对应于所有 .NET 集合类型的模板以及用于生成存储过程的模板,但该工具的真正威力在于能够创建自定义模板。

CodeSmith可以从网站http://www.codesmithtools.com/ 下载,个人开发版费用在300美元左右,个人认为还是物有所值。

还是用一个例子来说明一下使用CodeSmith可以大大减轻程序代码的工作量,对于数据库应用来说,尽管数据库表不尽相同,但基本过程都是定义数据库表,设计表对应的类,然后使用ADO或是SQL语句来访问数据库,创建对应的类对象等。

使用CodeSmith提供的模板,可以几乎不用手工编写一行代码,就可以自动生成上述数据库相关的代码。

本例使用Visual Studio 2010 ,Codesmith 安装时提供了Visual Studio 插件支持。使用的示例数据库也是Sales,可以参见Hibernate开发教程(2):准备开始。

由于使用MySQL数据库,需要下载MySQL .Net 库。使用SQL Server 可以直接使用。

1. 创建一个命令行应用solution。

2. 使用CodeSmith的SchemaExplorer 添加一个MySQL 数据源

这里的Connection String 为:SERVER=localhost;DATABASE=sales;UID=username;PASSWORD=password; (根据你自己服务器自行修改参数)

添加成功后,在Schema Explorer 中会显示所连接的数据库的表定义等

3. 在这个solution 中添加一个Sales.Data Class Library. 然后在项目中添加一个CodeSmith 项目Item

4. 点击Sales.csp 使用鼠标右键Context Menu

使用有Add Output 可以在项目中添加生成代码的模板,这里选用CodeSmith自带的PLINQO-NH\CSharp下的三个模板,

模板路径为..\Users\…\Documents\CodeSmith Generator\Samples\v6.5\Templates\Frameworks\PLINQO-NH\CSharp\

分别添加三个模板,SourceDatabase 选择Schema Explorer 中添加的Sales数据库,其它属性使用缺省值。

三个模板分别为

  • Hbms 生成 hbm.xml 映射文件
  • Entities 生成和数据库表对应的.Net类定义
  • Queries 生成查询数据对应的类

然后通过Sales.csp 的Generate code 生成代码。

可以看到CodeSmith自动生成了很多代码,并添加了所需的引用。

此时用来访问数据的类全部由CodeSmith生成,无需自己写一行代码。

5. 看看如果使用生成的代码来访问数据库,修改命令行应用的Program.cs 的main 函数,打印出所有Customer的姓名。

var salesDataContext = new SalesDataContext();
foreach (var s in salesDataContext.Customer.ToList())
{
	Console.WriteLine(s.FirstName+" " + s.LastName);
}

使用SalesDataContext 中Customer查询 对象。然后枚举列表中每个Customer对象并打印出FirstName 和 Last Name. 可以看到代码自动完成了对数据库的读取访问。

由本例看到使用CodeSmith可以大大减轻手工代码量,其使用的一般步骤是

  1. 选择使用合适的模板,CodeSmith随开发包自带了大量常用的模板,如果找不到合适的模板,CodeSmith支持自定义模板。
  2. 为模板选择合适的参数设置。
  3. 自动生成代码(可以为任意类型的代码,C#,Java, .XML 文本等)

后面将详细介绍CodeSmith使用的基本方法,CodeSmith的核心为模板,因此重点在模板的设计和使用。


你可能感兴趣的:(CodeSmith 使用教程(1): 概述)