Spring.NET 1.3.1 中提供了一个使用 AdoTemplate 的完整示例，包括使用泛型和使用非泛型技术进行数据访问，这个示例位于下载的压缩包中Spring.NET-1.3.1Spring.NETexamplesSpringSpring.DataQuickStart。Spring.NET 的下载地址：http://www.springframework.net/download.html。示例中的数据来源于微软的示例数据库 Northwind，这个数据库可以从微软的网站下载，下载地址：http://www.microsoft.com/downloads/en/details.aspx?FamilyId=06616212-0356-46A0-8DA2-EEBC53A68034&displaylang=en
Spring.NET 提供了两种风格的 ADO.NET 访问，第一种 template 风格，通过一个单例的 AdoTemplate 应用在所有的数据访问实现中，AdoTemplate 提供了通过一个方法调用来完成数据访问的机制，这个机制类似于微软的 DAAB。这个类位于命名空间 Spring.Data.Core，在程序集Spring.Data 中。另外一种方式更加面向对象一些，比如通过 AdoQuery 来完成查询任务，而 AdoNonQuery 完成创建、更新、删除任务，存储过程则通过 StoredProcedure 来完成。这几个类都定义在命名空间 Spring.Data.Objects 中，位于程序集 Spring.Data。
在 Spring.NET 中，为了方便使用 AdoTemplate，使用 AdoDaoSupport 封装了 AdoTemplate。AdoDaoSupport 定义在命名空间Spring.Data.Core 下，具体的定义如下：
public class AdoDaoSupport : DaoSupport{ private AdoTemplate adoTemplate; public IDbProvider DbProvider { set { adoTemplate = CreateAdoTemplate(value); } get { if (adoTemplate != null) { return adoTemplate.DbProvider; } else { return null; } } } public AdoTemplate AdoTemplate { set { adoTemplate = value; } get { return adoTemplate; } } protected override void CheckDaoConfig() { if (adoTemplate == null) { throw new ArgumentException("DbProvider or AdoTemplate is required"); } } protected IDbConnection Connection { get { return ConnectionUtils.GetConnection(DbProvider); } } protected IAdoExceptionTranslator ExceptionTranslator { get { return null; //Investigate AdoExceptionTranslator on AdoAccessor } } protected void DisposeConnection(IDbConnection conn, IDbProvider dbProvider) { ConnectionUtils.DisposeConnection(conn, dbProvider); } protected virtual AdoTemplate CreateAdoTemplate(IDbProvider dbProvider) { return new AdoTemplate(dbProvider); } protected virtual IDbParametersBuilder CreateDbParametersBuilder() { return new DbParametersBuilder(DbProvider); } protected virtual IDbParameters CreateDbParameters() { return AdoTemplate.CreateDbParameters(); } } |
通常情况下，我们从 AdoDaoSupport 派生一个用于数据访问的类，这样就可以直接通过 AdoDaoSupport 来使用 AdoTemplate 了。例如，示例中的 QueryForObjectDao 的代码。
publicclass QueryForObjectDao : AdoDaoSupport
{
privatestring cmdText =@"select Address, City, CompanyName, ContactName, "+
"ContactTitle, Country, Fax, CustomerID, Phone, PostalCode, "+
"Region from Customers where ContactName = @ContactName";
public Customer GetCustomer(string contactName)
{
return (Customer)AdoTemplate.QueryForObject(CommandType.Text, cmdText, new CustomerRowMapper(),
"ContactName", DbType.String, 30, contactName);
}
}
在配置文件中使用依赖注入分别定义 dbProvider, adoTemplate 和 AdoDaoSupport 的派生类。
<!-- 连接串定义 -->
<db:provider id="dbProvider"
provider="System.Data.SqlClient"
connectionString="Data Source=.SQL2005;Initial Catalog=Northwind;Persist Security Info=True;User ID=springqa;Password=springqa;Trusted_Connection=False"/>
<!-- AdoTemplate 定义 -->
<object id="adoTemplate" type="Spring.Data.Core.AdoTemplate, Spring.Data">
<!-- 注入连接 -->
<property name="DbProvider" ref="dbProvider"/>
<property name="DataReaderWrapperType" value="Spring.Data.Support.NullMappingDataReader, Spring.Data"/>
</object>
<!-- 查询定义 -->
<object id="queryForObjectDao" type="Spring.DataQuickStart.Dao.Template.QueryforObjectDao, Spring.DataQuickStart">
<!-- 注入 AdoTemplate -->
<property name="AdoTemplate" ref="adoTemplate"/>
</object>
测试程序中，首先初始化 Spring 容器。这里的配置文件是嵌入在程序集中的。
[SetUp]
publicvoid InitContext()
{
// Configure Spring programmatically
NamespaceParserRegistry.RegisterParser(typeof(DatabaseNamespaceParser));
ctx =new XmlApplicationContext(
"assembly://Spring.DataQuickStart.Tests/Spring.DataQuickStart.Template/ExampleTests.xml");
adoTemplate = ctx["adoTemplate"] as AdoTemplate;
}
在代码中，就可以通过容器直接取得 QueryForObjectDao 对象使用了。
[Test]
publicvoid QueryForObjectDaoTest()
{
QueryForObjectDao dao = ctx["queryForObjectDao"] as QueryForObjectDao;
Customer customer = dao.GetCustomer("Hanna Moos");
Assert.AreEqual(customer.ContactName, "Hanna Moos");
}