EntLib-DAAB操作指南(转)
企业库EntLib-- Data Access Application Block (DAAB)Web开发操作指南
数据访问应用程序块(Data Access Application Block)顾名思义是负责与数据打交道的应用程序块。DAAB并不是整个企业库的最低层,它依赖于企业库的最低层——配置管理程序块。现在简单使用企业库自带的配置工具(Enterprise Library Configuration)来完成DAAB的配置工作。
说到这里想再说些题外话,我们知道企业库是由相对独立Application Block演变而成的,在以前的DAAB我们可能会构建工厂方法模式通过静态方法创建数据库链接。但现在既然企业库已经出炉了,我们也遵循通过配置管理来得到数据库连接这种方法。
概括来说,使用DAAB可以抽象为三个步骤,分别是:
- 配置DAAB;
- 实例化数据库;
- 具体数据操作;
第一部,创建配置信息。如前所述,企业库架构通过配置来创建数据库连接。我们可以使用企业库自带的配置工具(Enterprise Library Configuration)快捷、安全地完成配置工作。具体步骤如下:
准备工作:这步很重要,我们新建了一个Web工程,这个工程得先增加一个项(应用程序配置文件)。这样做是为了直接使用配置工具打开配置文件进行编辑,省去不并要的麻烦。
1.打开配置工具。(我的是XP系统,企业库版本为Enterprise Library - June 2005)开始菜单->所有程序->Microsoft patterns & practices->Enterprise Library - June 2005->Enterprise Library Configuration
2.打开应用程序。File->Open Application 选择工程所在目录下的App.config或web.config文件。
3.新建DAAB。右键点击刚建的Application->New->Data Access Application Block。
4.配置DAAB参数。这里内容太多,只说说其中几个常用的配置项。
4.1首先是数据库实例名称,在“Database Instances”节点下,默认为我们建立了名叫“Database Instance1”的实例名,这个名将用于在程序中创建数据库实例,请改成具有标识性的名字。
4.2其次是连接字符串,在“Connection Strings ”节点下,默认也会创造一个,同样,我们也可以改一下名。连接字符串中“Integrated Security”的值默认为True,代表用Windows集成认证(不需要用户名和密码属性),如果我们要用混合认证方式,就要先把值设为False,然后再在所在Connection String中增加用户名和密码两个属性并填充正确的属性值(方法:在具体Connection String节点上右键->New …)。一切就绪便可以确认保存了。
第二部,便是创造数据库实例了。
准备工作:需要把企业库引用到工程中。因为企业库是开源的,所以我们可以直接引用工程或者引用编译好的DLL。为了说明怎样使用,这里只引用两个关键程序集,分别是Microsoft.Practices.EnterpriseLibrary.Configuration.dl和Microsoft.Practices.EnterpriseLibrary.Data.dll。另外为了简化代码的编写,我们再在需要用到DAAB的地方using一下Microsoft.Practices.EnterpriseLibrary.Data这个命名空间。
当我们需要执行数据库操作前,需要创建数据库实例。使用以下语句:
Database db = DatabaseFactory.CreateDatabase("Northwind");
就这一条语句便完成了数据库的连接操作!不过要注意,这里的Northwind是上一部配置工作中所述的数据库实例名称,而不是要连接的数据库名。数据库名是在数据库实例里的ConnectionStringNode属性所指向的ConnectionString中,和服务器名,用户名,及密码一起定义的。请把这个关系理清。
另外,Database 的实例,在生命周期内维护着数据库的连接。即当从工厂生产一个数据库实例时,其内部即封闭了ADO.NET Connection的open方法;而当其生命周期结束后(假定在一对花括号内),它将自动调用close方法关闭连接。
第三部,具体数据库操作。
我们以一具体实例来介绍一下数据库操作:
1.增加对Microsoft.Practices.EnterpriseLibrary.Data.dll和Microsoft.Practices.EnterpriseLibrary.Configuration.dll的引用,并在代码在添加:
using Microsoft.Practices.EnterpriseLibrary.Data;
2.编写存储过程,第二部完成之后在我们工程所要用到的数据库里建立存储过程;
CREATE PROCEDURE GetProductDetails
@ProductID int, //默认为INPUT
@ProductName nvarchar(40) OUTPUT,
@UnitPrice money OUTPUT,
@QtyPerUnit nvarchar(20) OUTPUT
AS
SELECT @ProductName = ProductName,
@UnitPrice = UnitPrice,
@QtyPerUnit = QuantityPerUnit
FROM Products
WHERE ProductID = @ProductID.
4.建立DBCommandWrapper来调用用存储过程GetProductDetails :
string sqlCommand = "GetProductsDetails";
DBCommandWrapper dbCommandWrapper = db.GetStoredProcCommandWrapper(sqlCommand);
dbCommandWrapper.AddInParameter("@ProductID", DbType.Int32, productID);
//把productID的value传递给@ProductID
dbCommandWrapper.AddOutParameter("@ProductName", DbType.String, 50);
//输出的参数 50代表参数的大小。
dbCommandWrapper.AddOutParameter("@UnitPrice", DbType.Currency, 8);
5.执行存储过程:
db.ExecuteNonQuery(dbCommandWrapper);
6.得到输出参数的值:
string results = string.Format(
CultureInfo.CurrentCulture, "{0}, {1}, {2:C} ",
dbCommandWrapper.GetParameterValue("@ProductID"),
dbCommandWrapper.GetParameterValue("@ProductName"),
dbCommandWrapper.GetParameterValue("@UnitPrice"));
txtResult.Text = results;
为了执行存储过程,上述代码使用GetStoredProcCommandWrapper方法创建合适的command wrapper对象,然后作为参数传递给ExecuteNonQuery方法。
下面展示一下基类Database的6种方法的代码实现 :
- 1. ExecuteDataSet
- 2. LoadDataSet
- 3. ExecuteReader
- 4. ExecuteScalar
- 5. ExecuteNonQuery
- 6. UpdateDataSet
(1) ExecuteDataSet方法
Database db = DatabaseFactory.CreateDatabase();
DataSet dsCustomers = db.ExecuteDataSet(CommandType.Text, "Select * From Customers" );
customerGrid.DataSource = dsCustomers.Tables[0];
(2) ExecuteReader方法
Database db = DatabaseFactory.CreateDatabase();
string sqlCommand = "Select top 5 * From Customers";
DBCommandWrapper dbCommandWrapper = db.GetSqlStringCommandWrapper(sqlCommand);
StringBuilder readerData = new StringBuilder();
using (IDataReader dataReader = db.ExecuteReader(dbCommandWrapper))
{
while (dataReader.Read())
{
readerData.Append(dataReader["ContactName"]);
readerData.Append(Environment.NewLine);
}
}
txtResult.Text = readerData.ToString();
为了执行SQL语句,上述代码使用GetSqlStringCommandWrapper方法创建合适command wrapper对象,然后作为参数传递给ExecuteReader方法。
(3) ExecuteNonQuery方法前面已经介绍过了(略)
(4) ExecuteScalar方法
Database db = DatabaseFactory.CreateDatabase();
string sqlCommand = "GetProductName";
int productID=1;
DBCommandWrapper dbCommandWrapper db.GetStoredProcCommandWrapper(sqlCommand, productID);
//单值传参productID, dbCommandWrapper.AddInParameter("@ProductID", DbType.String, productID)也可实现 。
// Retrieve ProdcutName. ExecuteScalar returns an object, so
// we cast to the correct type (string).
string productName = (string) db.ExecuteScalar(dbCommandWrapper);
txtResult.Text = productName;
Note : 其他方法实现请参阅MSDN帮助文档。总结了博客园几位高手关于EntLib的资料,在此我要谢谢他们带我入门 。