Enterprise Library v5.0 -- Data Access Application Block 开发向导（3）

 

微软企业库 Enterprise Library 5.0 正式发布！！！
Enterprise Library 5.0 开发向导- 简介（1）
Enterprise Library v5.0 -- Data Access Application Block 开发向导（2）

检索数据对象

现代程序开发都关注“数据对象”，使用数据传输对象（DTO）在应用程序层间传递数据，使用ORM（Object/Relations Mapping）实现数据访问层，或者充分利用客户端数据访问技术，如LINQ等等。

DAAB提供了使用SQL语句或存储过程检索数据的功能，返回的数据实现了IEnumerable接口的对象序列。

关于Accessors

DAAB数据访问块提供了2个核心类来执行这一查询：SprocAccessor和SqlStringAccessor。你可以使用Database 类的ExecuteSprocAccessor和ExecuteSqlStringAccessor方法，在一个方法中创建和执行这些Accessors。

Accessors使用2个其他的对象来管理你想传递给accessor的参数，并将从数据库返回的数据行映射为对象属性，然后返回给客户端代码。下图演示了整个流程。

如果你不指定参数mapper，accessor将自动使用默认的mapper来解析参数，但是这一特性仅仅适用于SQL Server或Oracle数据库的存储过程。当你使用SQL语句或者其他数据库时，你必须知道定制的参数mapper，负责解析参数。

如果你只指定输出的mapper，DAAB将使用默认的映射构造类，映射返回的数据列到创建的对象属性。此外，你也可以创建定制的映射，匹配数据列和对象属性。

创建并执行Accessor

下面的代码演示如何使用accessor执行一个存储过程，并操作返回的对象序列。你必须指定返回数据的对象类型。在本示例中是一个简单的Product类，有三个属性：ID、Name和Description。

// Create an object array and populate it with the required parameter values

object[] params = new object[] { "%bike%" };

// Create and execute a sproc accessor that uses the default

// parameter and output mappings.

var productData = defaultDB.ExecuteSprocAccessor<Product>("GetProductList",

params);

// Perform a client‐side query on the returned data. Be aware that

// the orderby and filtering is happening on the client, not in the database.

var results = from productItem in productData

where productItem.Description != null

orderby productItem.Name

select new { productItem.Name, productItem.Description };

// Display the results

foreach (var item in results)

{

Console.WriteLine("Product Name: {0}", item.Name);

Console.WriteLine("Description: {0}", item.Description);

Console.WriteLine();

}

使用LINQ访问Accessor返回的数据序列，删除description为空的数据，并按name排序，接着创建一个新的对象序列，包括Name和Description属性。

检索XML数据

几年前，XML是非常酷的新技术，将掌管未来世界和改变我们思考数据的方法。在很多情况下，从关系型数据库中检索XML数据是非常有用的，DAAB支持这一功能。

DAAB提供了检索XML数据的ExecuteXmlReader方法，接收包含FOR XML的SQL语句，向数据库执行SQL语句，返回结果为XmlReader。你可遍历返回的XML元素或使用.NET 框架支持的XML类。然而，SQLXML仅限于Microsoft SQL Server数据库。

static SqlDatabase sqlServerDB = null;

// Resolve a SqlDatabase object from the container using the default database.

sqlServerDB = EnterpriseLibraryContainer.Current.GetInstance<Database>() as SqlDatabase;

// Specify a SQL query that returns XML data

string xmlQuery = "SELECT * FROM OrderList WHERE State = @state FOR XML AUTO";

// Create a suitable command type and add the required parameter

// NB: ExecuteXmlReader is only available for SQL Server databases

using (DbCommand xmlCmd = sqlServerDB.GetSqlStringCommand(xmlQuery))

{

xmlCmd.Parameters.Add(new SqlParameter("state", "Colorado"));

using (XmlReader reader = sqlServerDB.ExecuteXmlReader(xmlCmd))

{

while (!reader.EOF) // Iterate through the elements in the XmlReader

{

if (reader.IsStartElement())

{

Console.WriteLine(reader.ReadOuterXml());

}

}

}

}

上述代码演示了使用ExecuteXmlReader方法，从XmlReader检索返回的XML数据。需要注意的是，默认情况下，返回结果为XML数据块，并不是一个有效的XML文档。

使用上述代码查询SQL Server数据库，按FOR XML AUTO查询，返回默认格式的XML数据，数据集中每一列表示为XML属性，如下所示。

<OrderList Id="1" Status="DRAFT" CreatedOn="2009‐02‐01T11:12:06" Name="Adjustable

Race" LastName="Abbas" FirstName="Syed" ShipStreet="123 Elm Street" ShipCity="Denver"

ShipZipCode="12345" ShippingOption="Two‐day shipping" State="Colorado" />

<OrderList Id="2" Status="DRAFT" CreatedOn="2009‐02‐03T01:12:06" Name="All‐Purpose

Bike Stand" LastName="Abel" FirstName="Catherine" ShipStreet="321 Cedar Court"

ShipCity="Denver" ShipZipCode="12345" ShippingOption="One‐day shipping"

State="Colorado" />

检索单一结果

访问数据的一个常见需求是检索一个单一数据值。DAAB提供了ExecuteScalar方法实现这一需求。它执行了指定的查询，并以Object类型返回第一行/第一列的数值。这意味着，它比ExecuteReader方法提供更好的性能，因为不必创建DataReader对象和构造结果集返回给客户端。为了最大化效率，你应该使用查询返回一个单一值，或者单一行。

// Create a suitable command type for a SQL statement

// NB: For efficiency, aim to return only a single value or a single row.

using (DbCommand sqlCmd

= defaultDB.GetSqlStringCommand("SELECT [Name] FROM States"))

{

// Call the ExecuteScalar method of the command

Console.WriteLine("Result using a SQL statement: {0}",

defaultDB.ExecuteScalar(sqlCmd).ToString());

}

// Create a suitable command type for a stored procedure

// NB: For efficiency, aim to return only a single value or a single row.

using (DbCommand sprocCmd = defaultDB.GetStoredProcCommand("GetStatesList"))

{

// Call the ExecuteScalar method of the command

Console.WriteLine("Result using a stored procedure: {0}",

defaultDB.ExecuteScalar(sprocCmd).ToString());

}

更新数据

当使用UPDATE、DELETE、或者INSERT 语句时，可调用Database类的ExecuteNonQuery方法，执行数据更新操作。

和前面介绍的ExecuteReader方法一样，ExecuteNonQuery方法有一系列重载。你可以指定CommandType（默认为StoredProcedure）和SQL语句、存储过程的名称等等。你可传递对象实例数组，表示查询参数。此外，你也可传递Command对象，包含了你需要的任何参数，同时也提供了Begin和End版本的方法，用来异步执行更新操作。

string oldDescription = "Carries 4 bikes securely; steel construction, fits 2\" receiver hitch.";

string newDescription = "Bikes tend to fall off after a few miles.";

// Create command to execute the stored procedure and add the parameters.

DbCommand cmd = defaultDB.GetStoredProcCommand("UpdateProductsTable");

defaultDB.AddInParameter(cmd, "productID", DbType.Int32, 84);

defaultDB.AddInParameter(cmd, "description", DbType.String, newDescription);

// Execute the query and check if one row was updated.

if (defaultDB.ExecuteNonQuery(cmd) == 1)

{

// Update succeeded.

}

else

{

Console.WriteLine("ERROR: Could not update just one row.");

}

// Change the value of the second parameter

defaultDB.SetParameterValue(cmd, "description", oldDescription);

// Execute query and check if one row was updated

if (defaultDB.ExecuteNonQuery(cmd) == 1)

{

// Update succeeded.

}

else

{

Console.WriteLine("ERROR: Could not update just one row.");

}

操作DataSet数据集

DAAB支持检索DataSet数据集，同时也支持从DataSet更新原始的数据库记录。

你可以是ExecuteDataSet方法，获取一个新的DataSet对象实例，该DataSet对象包含有查询返回的数据表。DataSet中的数据表有默认的表名称，如Table、Table1和Table2等等。

如果你想将数据装载进一个现存的DataSet对象，你可以使用LoadDataSet方法，这样允许你指定名称或DataSet中的目标数据表，还可让你添加额外的数据表到一个现有的DataSet，或者更新DataSet中的特定表的内容。

DataSet productDataSet;

// Using a SQL statement and a parameter array.

productDataSet = db.ExecuteDataSet(CommandType.Text, "GetProductsByCategory",

new Object[] { "%bike%" });

// Using a stored procedure and a parameter array.

productDataSet = db.ExecuteDataSet("GetProductsByCategory",

new Object[] { "%bike%" });

// Using a stored procedure and a named parameter.

DbCommand cmd = db.GetStoredProcCommand("GetProductsByCategory");

db.AddInParameter(cmd, "CategoryID", DbType.Int32, 7);

productDataSet = db.ExecuteDataSet(cmd);