CodeSmith 使用教程(1): 概述

我就是我 2024-02-17 14:14 30阅读 0赞

前面正在介绍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):准备开始][Hibernate_2]。

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

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

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

[![20121022003][]][20121022003]

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

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

[![20121022004][]][20121022004]

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

[![20121022001][]][20121022001]

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

[![20121022002][]][20121022002]

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

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

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

[![20121022005][]][20121022005]

三个模板分别为

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

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

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

[![20121022006][]][20121022006]

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

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

**\[csharp\]** [ view plain][view plain] [copy][view plain] [print][view plain] [?][view plain]

1.  var salesDataContext = new SalesDataContext();
2.  foreach (var s in salesDataContext.Customer.ToList())
3.  \{
4.  Console.WriteLine(s.FirstName+" " \+ s.LastName);
5.  \}

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

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

[![20121022007][]][20121022007]

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

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

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

[Hibernate_2]: http://www.imobilebbs.com/wordpress/archives/3545
[MySQL .Net]: http://dev.mysql.com/downloads/connector/net/
[20121022003]: http://www.imobilebbs.com/wordpress/wp-content/uploads/2012/10/20121022003.png
[20121022004]: http://www.imobilebbs.com/wordpress/wp-content/uploads/2012/10/20121022004.png
[20121022001]: http://www.imobilebbs.com/wordpress/wp-content/uploads/2012/10/20121022001.png
[20121022002]: http://www.imobilebbs.com/wordpress/wp-content/uploads/2012/10/20121022002.png
[20121022005]: http://www.imobilebbs.com/wordpress/wp-content/uploads/2012/10/20121022005.png
[20121022006]: http://www.imobilebbs.com/wordpress/wp-content/uploads/2012/10/20121022006.png
[view plain]: http://blog.csdn.net/mapdigit/article/details/8105497#
[20121022007]: http://www.imobilebbs.com/wordpress/wp-content/uploads/2012/10/20121022007.png