NetTier模板生成的代码框架用法
1.1. 概述：
使用NetTier模板生成的.net代码，包括完整的数据层，使用的技术是微软的
EnterpriseLibrary1.1版本，对应每张表都生成相对应的增删改查函数和存储过程，在查询中支
持多字段查询和翻页。数据层为工厂模型，只要调用DataRepository 类即可获取相应表的接
口实例，然后可以对改表进行操作了。对于多表关联操作，在父表中可以获取子集的查询记
录，保存在IList 容器里面，对于子表，提供父表的对象实例。对于数据库的操作提供事务功
能。对于更加复杂的操作，直接提供EnterpriseLibrary的数据库操作实例，直接进行操作。
特征：
1、 生成vs.net工程和解决方案；
2、 集成EnterpriseLibrary1.1版本，对于数据库链接可以直接使用EnterpriseLibrary的配置文
件；
3、 数据表和实体的映射关系是1：1的，每张表都有一个实体生成，在实体里面对应了每个
字段，实体类是序列化的，有trigger事件，支持枚举类型的字段；
4、 对于表和视图生成的实体的操作包括：基本的CRUD操作：UPDATE, DELETE, INSERT,
SELECT ALL, PAGED SELECT, FIND；支持主键、外键、多表关联、排序、分页、sql
语句、视图查询；
5、 获取强类型的数据集存储在Ilist或者Vlist里面，可以绑定到DataGrid、GridView或
者其他的页面控件中，支持表格排序；
6、 生成webservice 服务进行数据分发；
7、 创建存储过程脚本，而且自动安装到数据库服务器上面；
8、 生成nant的完整的build.xml 文件，可以自动编译、测试代码，生成chm 格式的api
文档；
9、 根据数据库生成完整的数据验证规则，包括一个管理规则的框架；
10、 每个表都有一个实体类，你可以在你的客户代码里面继承，然后增加自己的处理方
法；
11、 生成数据源可以让你你无需再去处理数据源的问题了；
12、 创建全套的web admin用户控件，你可以对数据库进行web管理；
13、 完整的nunit测试；
14、 完整的注释，符合微软的命名规则；
15、 nettiers 模板是免费开源的。
1.2. 框架结构：
数据逻辑包括客户业务逻辑组件、数据接口逻辑组件（持久层逻辑），整个设计建筑在el
上面。
下面以northwind数据库的单表employee为例进行讲解。
Employee数据表结构：
生成的OO 结构：
接口统一的调用DataRepository 获取各功能块的provider，然后进行单表的增删改查操
作，如果需要更加复杂的业务逻辑，比如要用到事务来同时处理几个表，那么需要另外写业务
逻辑代码了，这些逻辑层代码可以放在bl 层里面。值得一提的是，现在在bl 层里面生成的代
码，只有最基本和通用的业务逻辑，只生成了单表数据的实体类VO、单表数据各字段的处理
和数据集合的排序、检索等处理。
EmployeesCollection
EmployeesCollectionBase
Employees
EmployeesBase EmployeesVO
在DataRepository 里面获取各功能模块的provider的方法是static 方法，得到的是各
个sqlprovider 的实例，而提供给外界使用的是其对应的抽象类定义的方法。
实例的调用顺序是：
:
DataRepository
:
SqlDataProvider
:
SqlEmployeesProviderBase
1: EmployeesProvider
2: GetAll
3: GetByEmployeeID
分析DataRepository.EmployeesProvider.GetAll()的操作：实例化的顺序是
DataRespository 类里面维护了一个全局的变量Current，这个Current实际上是
SqlDataProvider 的实例，而Current是DataProviderBase 类型，关系为：
DataProviderBase
SqlDataProvider
(from sqlclient)
在DataRepository 中获取EmployeesProvider的时候，实际上是调用了
SqlDataProvider 里面的方法EmployeesProvider()，new 了一个SqlEmployeesProvider 实
例，而这个实例中所有的方法的实现在SqlEmployeesProviderBase类中实现的，因为
SqlEmployeesProvider继承了SqlEmployeesProviderBase类，这个类相当于是dao 层，直接进行
数据库操作。
SqlEmployeesProviderBase
EmployeesProviderBase
(from base)
SqlEmployeesProvider
在生成各个sqlprovider 实例的时候，需要先实例化SqlDataProvider，这个用的是
Activator 类根据配置文件提供的这个类的名字生成的，nettier为了做到对不同数据库的支
持，提供了一个配置文件nettiersconfigdata.config 和读取这个配置文件的dll：
NetTiers.Configuration.dll。
Activator 类可以动态构造对象，有点像Java里面的
Class.forName(ClassName).newInstance()语句，因为用Activator 类构造对象，其类名在
编译时可以不确定，所以可以用来做插件的接口，做出Winamp 那种可以外加DLL 插件的程序
来。
1.3. 调用接口的方法：
1.3.1. 获取所有数据
获取所有的Employee数据，按照LastName字段进行排序：
using Northwind.DataAccessLayer;
// Get all the employee, sort it on the LastName and print them out
TList<Employees> employees = DataRepository.EmployeeProvider.GetAll();
employees.Sort(EmployeeColumns.LastName, ListSortDirection.Ascending);
foreach(Employee employee in employees)
{
Console.WriteLine("{1} {0}", employee.FirstName, employee.LastName);
}
1.3.2. 新增数据
创建一个新的employee 并且保存
using Northwind.DataAccessLayer;
// Create a new record and save
Employee employee = new Employee();
employee.FirstName = "John";employee.LastName = "Doe";
employee.BirthDate = DateTime.Now;employee.Address = "10 , fake street";
employee.City = "Metroplolis";employee.Country = "USA";
employee.HireDate = DateTime.Now;
employee.HomePhone = "0123456789";
employee.Notes = "This is a fake employee";
employee.Title = "M";
employee.TitleOfCourtesy = "Dear";
employee.PostalCode = "5556";
employee.Region = "New-York";
DataRepository.EmployeeProvider.Insert(employee);
//look, new id already populated
Console.WriteLine("New Employee ID" + employee.EmployeeId);
1.3.3. 修改数据
按照下标获取数据并且修改数据；
using Northwind.DataAccessLayer;
// Select by Index and Update
TList<Employees> employees =
DataRepository.EmployeeProvider.GetByLastName("Doe");
if (employees.Count == 1)
{
employees[0].Notes = "This is a modified fake employee";
DataRepository.EmployeeProvider.Save(employees[0]);
Console.Write(employees[0]);
}
1.3.4. 删除数据
通过主键查询数据并且删除
using Northwind.DataAccessLayer;
// Select by primary key and Delete
// (Demonstrate that insert, update, delete methods can also take collection
as parameter)
Employee employee = SqlDataRepository.EmployeeProvider.GetByEmployeeID(13);
DataRepository.EmployeeProvider.Delete(employees);
1.3.5. 事务控制
事务控制实例，可以用事务控制插入、修改、删除的操作，保证全部成功或者失败回滚；
using Northwind.DataAccessLayer;
// The SqlClient can work with transactions.
// Also show the Save method, wich encapsulate the use of Insert, Update and
Delete methods.
TransactionManager transaction = DataRepository.CreateTransaction();
transaction.BeginTransaction(/*IsolationLevel.ReadUncommited*/);
try
{
// Insert
Employee employee = new Employee();
employee.FirstName = "John";
employee.LastName = "Doe";
employee.BirthDate = DateTime.Now;
employee.Address = "10 , fake street";
employee.City = "Metroplolis";
employee.Country = "USA";
employee.HireDate = DateTime.Now;
employee.HomePhone = "0123456789";
mployee.Notes = "This is a fake employee";
employee.Title = "M";
employee.TitleOfCourtesy = "Doctor";
employee.PostalCode = "5556";
employee.Region = "New-York";
DataRepository.EmployeeProvider.Save(transaction, employee);
// modify the employee instance
employee.Notes = "This is a modified fake employee";
// Update
DataRepository.EmployeeProvider.Save(transaction, employee);
transaction.Commit();
Console.WriteLine("ok");
}
catch(Exception ex)
{
try { transaction.Rollback();} catch(){}
Console.WriteLine("nok : {0}", ex);
}
1.3.6. 关联保存
深度保存，可以同时保存父对象和子集
/*
DeepSave helper method can help you to save an object and its children in
one call.
*/
using Northwind.DataAccessLayer;
Order order = Order.CreateOrder("ALFKI", 1, DateTime.Now, DateTime.Now,
DateTime.Now, 1, 0.1m, "ship name", "ship address" , "paris", "idf", "75000",
"france");
order.OrderDetailCollection.Add(order.OrderID, 1, 15.6m, 10, 0.02f);
order.OrderDetailCollection.Add(order.OrderID, 2, 122.6m, 43, 0.03f);
DataRepository.OrderProvider.DeepSave(order);
Console.WriteLine("new order saved: orderId is: " + order.OrderID.ToString());
1.3.7. 多数据库支持
同时支持多个不同的数据库进行操作，在el 配置文件中配置不同的数据库连接或者在代
码中动态生成不同的数据库连接，达到同时使用不同类型数据库的目的。
/*
You can configure multiple data provider in the configuration console, and
write code to acces a specific one, instead of the default.
*/
using Northwind.DataAccessLayer;
SqlDataProvider myRepository = DataRepository.Providers["my second data
provider"] as Northwind.DataAccessLayer.SqlClient.SqlDataProvider;
this.listBox1.DataSource = myRepository.ProductProvider.GetAll();
this.listBox1.DisplayMember = "ProductName";
this.listBox1.ValueMember = "ProductID";
//Or if you can't have it pre-configured, you can change the connection
string at runtime.
using Northwind.DataAccessLayer;
//New syntax using a declared connection string:
TList<Products> list =
DataRepository.Connections["NorthwindConnectionString2"].Provider.CustomersProvide
r.GetAll();
//New syntax using a dynamic connection string:
DataRepository.AddConnection("DynamicConnectionString", "Data
Source=(local);Initial Catalog=Northwind;Integrated Security=true;");
TList<Products< list =
DataRepository.Connections["DynamicConnectionString"].Provider.ProductsProvider.Ge
tAll();
this.listBox1.DataSource = list;
this.listBox1.DisplayMember = "ProductName";
this.listBox1.ValueMember = "ProductID";
1.4. 配置nettiers模板
1.4.1. Datasource目录：
SourceDatabase 数据库名字和连接参数，在codesmith explore中有配置界面弹出
SourceTables 在数据表里面需要实体化的表
EntireDatabase 明确在数据库中需要实体化的表，这个设置将取代SourceTables 的设置
1.4.2. General 目录
OuputDirectory 输出目录，在codesmith explore里面有配置界面弹出
BusinessLogicLayerFolderName 逻辑层子目录名，推荐置空
DataAccessLayerFolderName 数据层子目录名，推荐值：DataAccessLayer
SqlFolderName 存储过程脚本目录名，推荐：SQL
NameSpace 项目的命名空间，名称和目录同。
GenerateUnitTest 声明生成nunit测试项目名
VsNetIntegration 声明是整个的生成一个工程还是按层分开生成工程
VsNetVersion Vs.net的版本
1.4.3. Webservice参数
GenerateWebService 声明是否生成webservice服务
WebServiceOutputPath Webservice的生成文件路径
WebServiceUrl 数据层子目录名，推荐值：DataAccessLayer
SqlFolderName 指向WebServiceOutputPath 的url
配置完成后可以保存为配置文件，下次只需要载入即可。
新增了web层的模板，叫weblayer，实现单表的增删改查；
给一个配置好的例子，对sqlserver2000的数据库northwind的配置例子，见netier目录下面
property.xml文件，可以直接载入然后生成对应的代码，生成的是完整的工程，可以直接编译
运行。
使用NetTier模板生成的.net代码，包括完整的数据层，使用的技术是微软的
EnterpriseLibrary1.1版本，对应每张表都生成相对应的增删改查函数和存储过程，在查询中支
持多字段查询和翻页。数据层为工厂模型，只要调用DataRepository 类即可获取相应表的接
口实例，然后可以对改表进行操作了。对于多表关联操作，在父表中可以获取子集的查询记
录，保存在IList 容器里面，对于子表，提供父表的对象实例。对于数据库的操作提供事务功
能。对于更加复杂的操作，直接提供EnterpriseLibrary的数据库操作实例，直接进行操作。
特征：
1、 生成vs.net工程和解决方案；
2、 集成EnterpriseLibrary1.1版本，对于数据库链接可以直接使用EnterpriseLibrary的配置文
件；
3、 数据表和实体的映射关系是1：1的，每张表都有一个实体生成，在实体里面对应了每个
字段，实体类是序列化的，有trigger事件，支持枚举类型的字段；
4、 对于表和视图生成的实体的操作包括：基本的CRUD操作：UPDATE, DELETE, INSERT,
SELECT ALL, PAGED SELECT, FIND；支持主键、外键、多表关联、排序、分页、sql
语句、视图查询；
5、 获取强类型的数据集存储在Ilist或者Vlist里面，可以绑定到DataGrid、GridView或
者其他的页面控件中，支持表格排序；
6、 生成webservice 服务进行数据分发；
7、 创建存储过程脚本，而且自动安装到数据库服务器上面；
8、 生成nant的完整的build.xml 文件，可以自动编译、测试代码，生成chm 格式的api
文档；
9、 根据数据库生成完整的数据验证规则，包括一个管理规则的框架；
10、 每个表都有一个实体类，你可以在你的客户代码里面继承，然后增加自己的处理方
法；
11、 生成数据源可以让你你无需再去处理数据源的问题了；
12、 创建全套的web admin用户控件，你可以对数据库进行web管理；
13、 完整的nunit测试；
14、 完整的注释，符合微软的命名规则；
15、 nettiers 模板是免费开源的。
1.2. 框架结构：
数据逻辑包括客户业务逻辑组件、数据接口逻辑组件（持久层逻辑），整个设计建筑在el
上面。
下面以northwind数据库的单表employee为例进行讲解。
Employee数据表结构：
生成的OO 结构：
接口统一的调用DataRepository 获取各功能块的provider，然后进行单表的增删改查操
作，如果需要更加复杂的业务逻辑，比如要用到事务来同时处理几个表，那么需要另外写业务
逻辑代码了，这些逻辑层代码可以放在bl 层里面。值得一提的是，现在在bl 层里面生成的代
码，只有最基本和通用的业务逻辑，只生成了单表数据的实体类VO、单表数据各字段的处理
和数据集合的排序、检索等处理。
EmployeesCollection
EmployeesCollectionBase
Employees
EmployeesBase EmployeesVO
在DataRepository 里面获取各功能模块的provider的方法是static 方法，得到的是各
个sqlprovider 的实例，而提供给外界使用的是其对应的抽象类定义的方法。
实例的调用顺序是：
:
DataRepository
:
SqlDataProvider
:
SqlEmployeesProviderBase
1: EmployeesProvider
2: GetAll
3: GetByEmployeeID
分析DataRepository.EmployeesProvider.GetAll()的操作：实例化的顺序是
DataRespository 类里面维护了一个全局的变量Current，这个Current实际上是
SqlDataProvider 的实例，而Current是DataProviderBase 类型，关系为：
DataProviderBase
SqlDataProvider
(from sqlclient)
在DataRepository 中获取EmployeesProvider的时候，实际上是调用了
SqlDataProvider 里面的方法EmployeesProvider()，new 了一个SqlEmployeesProvider 实
例，而这个实例中所有的方法的实现在SqlEmployeesProviderBase类中实现的，因为
SqlEmployeesProvider继承了SqlEmployeesProviderBase类，这个类相当于是dao 层，直接进行
数据库操作。
SqlEmployeesProviderBase
EmployeesProviderBase
(from base)
SqlEmployeesProvider
在生成各个sqlprovider 实例的时候，需要先实例化SqlDataProvider，这个用的是
Activator 类根据配置文件提供的这个类的名字生成的，nettier为了做到对不同数据库的支
持，提供了一个配置文件nettiersconfigdata.config 和读取这个配置文件的dll：
NetTiers.Configuration.dll。
Activator 类可以动态构造对象，有点像Java里面的
Class.forName(ClassName).newInstance()语句，因为用Activator 类构造对象，其类名在
编译时可以不确定，所以可以用来做插件的接口，做出Winamp 那种可以外加DLL 插件的程序
来。
1.3. 调用接口的方法：
1.3.1. 获取所有数据
获取所有的Employee数据，按照LastName字段进行排序：
using Northwind.DataAccessLayer;
// Get all the employee, sort it on the LastName and print them out
TList<Employees> employees = DataRepository.EmployeeProvider.GetAll();
employees.Sort(EmployeeColumns.LastName, ListSortDirection.Ascending);
foreach(Employee employee in employees)
{
Console.WriteLine("{1} {0}", employee.FirstName, employee.LastName);
}
1.3.2. 新增数据
创建一个新的employee 并且保存
using Northwind.DataAccessLayer;
// Create a new record and save
Employee employee = new Employee();
employee.FirstName = "John";employee.LastName = "Doe";
employee.BirthDate = DateTime.Now;employee.Address = "10 , fake street";
employee.City = "Metroplolis";employee.Country = "USA";
employee.HireDate = DateTime.Now;
employee.HomePhone = "0123456789";
employee.Notes = "This is a fake employee";
employee.Title = "M";
employee.TitleOfCourtesy = "Dear";
employee.PostalCode = "5556";
employee.Region = "New-York";
DataRepository.EmployeeProvider.Insert(employee);
//look, new id already populated
Console.WriteLine("New Employee ID" + employee.EmployeeId);
1.3.3. 修改数据
按照下标获取数据并且修改数据；
using Northwind.DataAccessLayer;
// Select by Index and Update
TList<Employees> employees =
DataRepository.EmployeeProvider.GetByLastName("Doe");
if (employees.Count == 1)
{
employees[0].Notes = "This is a modified fake employee";
DataRepository.EmployeeProvider.Save(employees[0]);
Console.Write(employees[0]);
}
1.3.4. 删除数据
通过主键查询数据并且删除
using Northwind.DataAccessLayer;
// Select by primary key and Delete
// (Demonstrate that insert, update, delete methods can also take collection
as parameter)
Employee employee = SqlDataRepository.EmployeeProvider.GetByEmployeeID(13);
DataRepository.EmployeeProvider.Delete(employees);
1.3.5. 事务控制
事务控制实例，可以用事务控制插入、修改、删除的操作，保证全部成功或者失败回滚；
using Northwind.DataAccessLayer;
// The SqlClient can work with transactions.
// Also show the Save method, wich encapsulate the use of Insert, Update and
Delete methods.
TransactionManager transaction = DataRepository.CreateTransaction();
transaction.BeginTransaction(/*IsolationLevel.ReadUncommited*/);
try
{
// Insert
Employee employee = new Employee();
employee.FirstName = "John";
employee.LastName = "Doe";
employee.BirthDate = DateTime.Now;
employee.Address = "10 , fake street";
employee.City = "Metroplolis";
employee.Country = "USA";
employee.HireDate = DateTime.Now;
employee.HomePhone = "0123456789";
mployee.Notes = "This is a fake employee";
employee.Title = "M";
employee.TitleOfCourtesy = "Doctor";
employee.PostalCode = "5556";
employee.Region = "New-York";
DataRepository.EmployeeProvider.Save(transaction, employee);
// modify the employee instance
employee.Notes = "This is a modified fake employee";
// Update
DataRepository.EmployeeProvider.Save(transaction, employee);
transaction.Commit();
Console.WriteLine("ok");
}
catch(Exception ex)
{
try { transaction.Rollback();} catch(){}
Console.WriteLine("nok : {0}", ex);
}
1.3.6. 关联保存
深度保存，可以同时保存父对象和子集
/*
DeepSave helper method can help you to save an object and its children in
one call.
*/
using Northwind.DataAccessLayer;
Order order = Order.CreateOrder("ALFKI", 1, DateTime.Now, DateTime.Now,
DateTime.Now, 1, 0.1m, "ship name", "ship address" , "paris", "idf", "75000",
"france");
order.OrderDetailCollection.Add(order.OrderID, 1, 15.6m, 10, 0.02f);
order.OrderDetailCollection.Add(order.OrderID, 2, 122.6m, 43, 0.03f);
DataRepository.OrderProvider.DeepSave(order);
Console.WriteLine("new order saved: orderId is: " + order.OrderID.ToString());
1.3.7. 多数据库支持
同时支持多个不同的数据库进行操作，在el 配置文件中配置不同的数据库连接或者在代
码中动态生成不同的数据库连接，达到同时使用不同类型数据库的目的。
/*
You can configure multiple data provider in the configuration console, and
write code to acces a specific one, instead of the default.
*/
using Northwind.DataAccessLayer;
SqlDataProvider myRepository = DataRepository.Providers["my second data
provider"] as Northwind.DataAccessLayer.SqlClient.SqlDataProvider;
this.listBox1.DataSource = myRepository.ProductProvider.GetAll();
this.listBox1.DisplayMember = "ProductName";
this.listBox1.ValueMember = "ProductID";
//Or if you can't have it pre-configured, you can change the connection
string at runtime.
using Northwind.DataAccessLayer;
//New syntax using a declared connection string:
TList<Products> list =
DataRepository.Connections["NorthwindConnectionString2"].Provider.CustomersProvide
r.GetAll();
//New syntax using a dynamic connection string:
DataRepository.AddConnection("DynamicConnectionString", "Data
Source=(local);Initial Catalog=Northwind;Integrated Security=true;");
TList<Products< list =
DataRepository.Connections["DynamicConnectionString"].Provider.ProductsProvider.Ge
tAll();
this.listBox1.DataSource = list;
this.listBox1.DisplayMember = "ProductName";
this.listBox1.ValueMember = "ProductID";
1.4. 配置nettiers模板
1.4.1. Datasource目录：
SourceDatabase 数据库名字和连接参数，在codesmith explore中有配置界面弹出
SourceTables 在数据表里面需要实体化的表
EntireDatabase 明确在数据库中需要实体化的表，这个设置将取代SourceTables 的设置
1.4.2. General 目录
OuputDirectory 输出目录，在codesmith explore里面有配置界面弹出
BusinessLogicLayerFolderName 逻辑层子目录名，推荐置空
DataAccessLayerFolderName 数据层子目录名，推荐值：DataAccessLayer
SqlFolderName 存储过程脚本目录名，推荐：SQL
NameSpace 项目的命名空间，名称和目录同。
GenerateUnitTest 声明生成nunit测试项目名
VsNetIntegration 声明是整个的生成一个工程还是按层分开生成工程
VsNetVersion Vs.net的版本
1.4.3. Webservice参数
GenerateWebService 声明是否生成webservice服务
WebServiceOutputPath Webservice的生成文件路径
WebServiceUrl 数据层子目录名，推荐值：DataAccessLayer
SqlFolderName 指向WebServiceOutputPath 的url
配置完成后可以保存为配置文件，下次只需要载入即可。
新增了web层的模板，叫weblayer，实现单表的增删改查；
给一个配置好的例子，对sqlserver2000的数据库northwind的配置例子，见netier目录下面
property.xml文件，可以直接载入然后生成对应的代码，生成的是完整的工程，可以直接编译
运行。
