SubSonic：一个数据层构建器(BLL)
导言
一 个易维护的应用程序，不同的类之间有不同的分工，通常分为界面层、业务层和数据访问层。虽然这一技术有利于更好地组织应用，一些开发人员不愿这么做。创建 一个可靠的和快速的数据访问层需要一些规划，一旦你创建了一个，他们看起来都是相似的。SubSonic帮助你基于数据库自动创建数据库访问层。
SubSonic是什么？
SubSonic是一个数据访问构建器。他还是一个auto-magic 的对象关系映射（ORM）工具，帮助你快速建立一个网站。
像吹嘘的那样，SubSonic能做什么工作，怎么能帮助你更快的建立应用程序？SubSonic通过读取你的数据库的结构，并为你构建快速，灵活的数据 访问层类。他只需要很少的配置，为你提供了不同的方法查询和保存数据，并提供方法给你定制以适应你的开发风格。SubSonic受到Rub on Rails的ActiveRecord的启发，不过SubSonic是一个纯粹的.NET组件。
SubSonic配置
和其它的ORM比较，SubSonic需要的配置很少，最小要求是将下列配置添加到web.config(app.config)文件：
一个或者多个数据库连接串
一个SubSonic配置节
连接适当的数据库连接到SubSonic
就是这么简单-没有必要关心要那些表或配置表和对象的映射关系。在实践中，配置看起来如下：
在Web.config的<configuration>中添加下表内容，注意< configSections >元素必须是 configuration 元素的第一个子元素。其中<connectionStrings>节就是通用的连接字符串
<configuration>
<!–1-配置SubSonic –>
<configSections>
<section
name=”SubSonicService” type=”SubSonic.SubSonicSection, SubSonic”
allowDefinition=”MachineToApplication” restartOnExternalChanges=”true”
requirePermission=”false”/>
</configSections>
<!–2-数据库字符串连接 –>
<connectionStrings>
<add name=”数据库连接” connectionString=”Data Source=192.168.0.2;Initial Catalog= Northwind;userid=aspuser;password=000000″ providerName=”System.Data.SqlClient” />
</connectionStrings>
<!–3-SubSonic与数据库连接 –>
<SubSonicService defaultProvider=”SubsonicProvider”>
<providers>
<clear/>
<add name=”SubsonicProvider” type=”SubSonic.SqlDataProvider, SubSonic” connectionStringName=”数据库连接” generatedNamespace=”Northwind” excludeTableList=”^aspnet_Applications$,^aspnet_Membership$,^aspnet_Paths$” generateODSControllers=”false”
removeUnderscores=”false” stripTableText=”Global_,Account_,_tb,Form_”
stripViewText=”Global_,Account_,_vw,Form_” fixPluralClassNames=”false”
/>
</providers>
</SubSonicService>
</configuration>
<providers>里的参数说明：
generatedNamespace=”Northwind” 设定生成代码命名空间，修改为你希望的命名空间；
connectionStringName=”数据库连接” 使用数据库的连接字符串，修改为你要使用的数据库连接字符串；
excludeTableList=”^aspnet_Applications$,^aspnet_Membership$,^aspnet_Paths$”
不生成aspnet_Applications, aspnet_Membership, aspnet_Paths这三个表相关代码；
generateODSControllers=”false” 不生成Controllers类；
removeUnderscores=”false” 不移除生成对象名称下划线；
stripTableText=”Global_,Account_,_tb,Form_” 生成表相关对象名称开头如果与设定值匹配则去掉；
stripViewText=”Global_,Account_,_vw,Form_” 视图名处理与与上面表处理相同；
fixPluralClassNames=”false” 不去除类名的复数s
当有多个<providers>节点时，可以用下面的方法再添加一个，注意加上<clear/>这个节点
获取数据
一旦你用SubSonic创建了数据访问层(DAL),无论是使用代码生成器还是BuilderProvider，你随时可以查询你的数据库，目前SubSonic支持下列数据库
微软SQL SERVER 2000或2005，包括Express版本
Oracle
MySQL
SQLite
SubSonic为你的数据库里的每个表生成三个类：
表名奇数形式的类：例如有一个表Products，类名就是Product，这是一个强类型的类代表数据库表中的一行数据，表中的每一列对应类中的强类型的属性名，允许null的字段定义为nullable
集合类：例如一个表Products，你将得到ProductCollection 类，这个类提供了好多方法处理数据库的数据
一 个控制器（如ProductController）：这提供了基本功能（创建，检索，更新和删除）。 而Product和ProductCollection 能装载自己，是ProductController是专为这些任务而设计的。此外，你可以把控制器作为数据源，为您的网页使用 ObjectDataSource控件。
Subsonic2.1使用
1.引用命名空间
如果生成代码文件是Northwind（web.config中generatedNamespace=”Northwind”，如上面配置）在使用文件中引用
using Northwind;
2.插入记录
如下代码可在表Region中插入一条记录
Region.Insert(10, “TestSubsonic2.1”);
3.修改记录
a.单个记录修改，下面代码可修改上面刚插入的记录
Region region = new Region(10);
region.RegionDescription = “TestSubsonic_Update”;
region.Save();
b.批量更新
Query q = Region.Query();
q.AddWhere(Region.Columns.RegionDescription, “test”);
q.AddUpdateSetting(Region.Columns.RegionDescription, “TestSubsonic”);
q.QueryType = QueryType.Update;
q.Execute();
上面代码把所有RegionDescription值为test 的记录修改为TestSubsonic
4.删除记录
a.删除单个记录
Region.Delete(10);
删除主键值 RegionID 为10的记录
b.批量删除
Query q = Region.Query();
q.AddWhere(Region.Columns.RegionDescription, “test”);
q.QueryType = QueryType.Delete;
q.Execute();
以上代码删除所有RegionDescription值等于test的记录
5.查询数据
Query q = Region.Query();
q.AddWhere(Region.Columns.RegionID, Comparison.GreaterOrEquals, 2);
DataTable dt = q.ExecuteDataSet().Tables[0];
以上代码获取Region表中RegionID >= 2 的数据表
Query q = Region.Query();
q.AddWhere(Region.Columns.RegionDescription, Comparison.Like, “te” + “%”);
DataTable dt = q.ExecuteDataSet().Tables[0];
以上Like查询，返回所有RegionDescription列值以te开头的记录表
6.获取对象集合
RegionCollection coll = DB.Select().From(“Region”).Where(“RegionId”)
.IsGreaterThan(2).ExecuteAsCollection<RegionCollection>();
int id = coll[0].RegionID;
string description = coll[0].RegionDescription;
以上代码获取RegionId > 2 的Region对象集合coll后，就可以操作对象数据值
SubSonic基本操作
查询
SubSonic2.1版本 – 列出3种查询。
Product product = new Select().From<Product>().Where(Product.ProductIDColumn).IsEqualTo(4)
.ExecuteSingle<Product>();
Product product = DB.Select().From<Product>().Where(“ProductID”).IsEqualTo(4)
.ExecuteSingle<Product>();
Query query = new Query(Product.Schema);
query.WHERE(“ProductID=4”).ORDER_BY(“ProductID asc”);
IDataReader dr = Product.FetchByQuery(query);
DataSet product = new Query(Product.Schema).WHERE(“ProductID=4”).ORDER_BY(“Prod uctID asc”)
.ExecuteDataSet();
关联查询
DataSet product = new Select(Product.ProductNameColumn,Category.CategoryNameColumn).From<Product>()
.InnerJoin(Category.CategoryIDColumn, Product.CategoryIDColumn)
.Where(Category.CategoryIDColumn).IsGreaterThan(4).ExecuteDataSet();
注意. InnerJoin(f2, f1) 的使用方法。
分页查询
List<Product> products = new Select().From<Product>()
.Where(Product.ProductIDColumn).IsEqualTo(4).Paged(1, 30).ExecuteTypedList<Product>();
查询—返回对象
ExecuteReader(); 返回DataReader
ExecuteScalar(); 返回对象
ExecuteScalar<string>(); 返回泛型对象
ExecuteSingle<Product>(); 返回表实体对象
ExecuteTypedList<Product>(); 返回泛型表实休数据集
ExecuteDataSet(); 返回DataSet
ExecuteJoinedDataSet<强数型数据集>(); 返回关联查询 DataSet
Execute(); 返回执行后，数据更新条数
SQL关键词
IsEqualTo(obj) // 等于 value
IsBetweenAnd(obj1, obj2) // [字段1] BETWEEN 值1 AND 值2
StartsWith // LIEK ‘1%‘
EndsWith // LIEK ‘%1‘
IsGreaterThan // [字段1] > 值1
IsGreaterThanOrEqualToIsGreaterThan // [字段1] >= 值1
IsLessThan // [字段1] < 值1
IsLessThanOrEqualToIsLessThan // [字段1] <= 值1
WhereExpression / AndExpression // Expression 表示括号
C#：
.Where(“1”).IsGreaterThan(1)
.And(“2”).IsGreaterThanOrEqualTo(2)
.AndExpression(“3”).IsLessThan(3)
.AndExpression(“4”).IsLessThanOrEqualTo(4).And(“5”).StartsWith(“5”)
.AndExpression(“6”).EndsWith(“6”)
.ExecuteSingle<Product>();
SQL：WHERE 1 > @1AND 2 >= @2 AND (3 < @3) AND (4 <= @4 AND 5 LIKE @5) AND (6 LIKE @6)
修改
Product product = new Product(4);
product.ProductName = “amo”;
product.Save();
int i = new Update(Product.Schema)
.Set(Product.ProductNameColumn).EqualTo(“Chai — Amo”)
.Where(Product.ProductIdColumn).IsEqualTo(1)
.Execute();
添加
Product product = new Product();
product.ProductName = “my xiaoli”;
product.SupplierID = 1;
product.CategoryID = 1;
product.Discontinued = true;
//…………
product.Save();
int i = new Insert().Into(Product.Schema,
“ProductName”,
“SupplierID”,
“CategoryID”,
“Discontinued“
)
.Values(“my amo”, 1, 1, 1).Execute();
删除
int i = new Delete ().From<Product>()
.Where(Product.ProductIDColumn). IsEqualTo(1)
.Execute();
事务1
List<Insert> queries = new List<Insert>();
queries.Add(new Insert().Into(Product.Schema).Values(“product1”));
queries.Add(new Insert().Into(Product.Schema).Values(“product2”));
queries.Add(new Insert().Into(Product.Schema).Values(“product3”));
queries.Add(new Insert().Into(Product.Schema).Values(“product4”));
queries.Add(new Insert().Into(Product.Schema).Values(“product5”));
queries.Add(new Insert().Into(Product.Schema).Values(“product6”));
queries.Add(new Insert().Into(Product.Schema).Values(“product7”));
//execute in a transaction
SqlQuery.ExecuteTransaction(queries);
事务2
using (SharedDbConnectionScope sp = new SharedDbConnectionScope())
{
using (TransactionScope scope = new TransactionScope())
{
// coding….
scope.Complete();
}
}
减少对ActiveRecord的依赖
MyProduct product = new Select(
Product.ProductNameColumn,
Category.CategoryNameColumn
).From<Product>()
.InnerJoin(Category.CategoryIDColumn, Product.CategoryIDColumn)
.Where(Category.CategoryIDColumn).IsGreaterThan(4)
.ExecuteSingle<MyProduct>();
string cname = product.CategoryName;
string pname = product.ProductName;
自定义MyProduct实体类
public class MyProduct : ActiveRecord<MyProduct> {
public string CategoryName {
get { return GetColumnValue<string>(Category.Columns.CategoryName); }
set { SetColumnValue(Category.Columns.CategoryName, value); }
}
public string ProductName {
get { return GetColumnValue<string>(Product.Columns.ProductName); }
set { SetColumnValue(Product.Columns.ProductName, value); }
}
}
它同时还具有牛排刀…
用SubSonic,你可能忽视了名字空间SubSonic.Sugar ，但如果你这样做，你错过了一些有用的特性。SubSonic.Sugar 没有迷人的功能，而是它提供的”杂项”的功能包括特性为：
文件操作，如在一个请求打开和阅读文件。
日期操作，如确定两个日期之间有多少工作日。
字符串操作，例如转换，以适当的情况下，或剥HTML格式。
数字操作，如确定如果一个数字是不是整数。
Web操作，如打开和阅读一个网页，或执行DNS查找。
验证操作，其中包括通用签证，万事达卡和其他常见的信用卡验证。
扩展SubSonic
没有应用能够提供满足所有需求的解决方案，因此，使用SubSonic所生成的类是不够的。您可能要像生成的类中添加方法，或者你可能要改变生成的类。 SubSonic满足这两方面的需要。
所有的SubSonic生成的类都是局部类。这意味着你可以增加功能到另一个文件，而类的名字时一样的。 如果你不喜欢SubSonic所生成的类，你可以重写模板，模板是asp.net页面。
总结
你 知道你有一个数据库，你需要连接到一个应用。你知不知道在页面中直接发送SQL的请求是一个坏的架构。 你知道你应该为你的应用写一数据层管理CRUD。 你真的想要得到这一切，现在做的，那你可以回家享受天伦之乐。 帮您解决所有这些在优点于一体，而不牺牲性能，可维护性和灵活性。 现在就去下载它并给它一个尝试。 你的应用会谢谢你的。
其他资源
infoq 关于SubSonic的问答
SubSonic介绍_Wind 来源：http://ctfysj.blog.hexun.com/32587843_d.html
