Spring.NET 1.3.1 中提供了一个使用 AdoTemplate 的完整示例,包括使用泛型和使用非泛型技术进行数据访问,这个示例位于下载的压缩包中 \Spring.NET-1.3.1\Spring.NET\examples\Spring\Spring.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 的代码。
public class QueryForObjectDao : AdoDaoSupport
{
private string 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]
public void 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]
public void QueryForObjectDaoTest()
{
QueryForObjectDao dao = ctx[ " queryForObjectDao " ] as QueryForObjectDao;
Customer customer = dao.GetCustomer( " Hanna Moos " );
Assert.AreEqual(customer.ContactName, " Hanna Moos " );
}