Spring.NET 是一个非常优秀的框架,对 DI 和 AOP 提供了强大而又方便的支持。NHibernate 是优秀的 ORM 框架,在开发中,我们希望能够集成使用这两个框架,在 Spring.NET 1.3.2 中对于当前的 NHibernate 3.2 提供了直接的支持。目前 NHibernate 已经发布了 3.3.1 ,但是在 Spring.NET 1.3.2 中没有直接的支持,所以这里还是使用 NHibernate 3.2。如果希望使用最新的 3.3.1,就需要你自己动手了。
由于 Spring.NET 和 NHibernate 都大量依赖配置文件进行管理,使得在配置过程中的各种问题影响了使用,下面我们将逐步介绍配置文件涉及的各个部分,直至完成系统的整个框架。
下载
首先,我们需要下载 Spring.NET 1.3.2 和 NHibernate 3.2
1. Spring.NET
Sprring.NET 1.3.2的下载地址:http://www.springframework.net/download.html
点击 here 地方进行下载,然后,你会看到一个表单需要填写,不过你可以跳过这一步,点击 take me to download page 就可以了。
然后,你就到了下载页面,注意:需要下载的是 1.3.2 的发布版,不是当前的 2.0。
点击之后,页面成为下面的样子。
Spring.NET-1.3.2-API.chm 是说明文档
Spring.NET-1.3.2.zip 是包含源文件的压缩文档,展开之后就会得到你所需要的一切。
Spring.NET-1.3.2.exe 是一个可执行的安装程序。通过安装程序来自动解压。
执行它的话,会首先看到这样一个画面。
确定后,需要指定保存的位置。
然后开始。
完成后,你会看到这样一个画面。
2. NHibernate
NHibernate 3.2 的下载地址:http://sourceforge.net/projects/nhibernate/files/NHibernate/3.2.0GA/
这里有编译完成的程序集,也有代码的源文件。
如果只是使用的话,直接下载 NHibernate-3.2.0.GA-bin.zip 就可以了。
二. 获取文件
1. Spring.NET
在 Spring.NET 文件夹中,会看到一个复杂的文件系统。
上面的 release 文件夹中是我们需要使用的程序集。
schema 中是 Xml 的架构文件,很多同学在编写 Xml 文件的时候,很头痛写错的问题,由于没有编译器的支持,写错了不会有提示。使用架构文件就可以解决这个问题。
将 schema 中的 .xsd 复制到 Visual Studio 的安装目录下的 Xml\Schemas 文件夹中,就可以有提示了。
lib 文件夹中有常用的程序集,其实,其中已经包含了 NHibernate 3.2 的程序集,不过,我们还是自己下载一个完全版的。
2. NHibernate
展开后,得到如下的文件夹。
在 Required_Bins 中是开发需要使用的程序集,主要是两个程序集:
Iesi.Collections.dll 和 NHibernate.dll
Iesi.Collections 中定义了特殊的集合,专门用于 NHibernate。
文件夹中还包含了两个 xsd 文件,这种文件是 XML 中的架构文件,放在这里是用来在编写 NHibernate 的配置文件时,可以在 VS 中提示的。
这两个文件应该保存到你的 VS 程序文件夹中的 Xml\Schemas 中,这样,以后在编写 NHibernate 的配置文件时,就可以直接提示了。
例如:Program Files (x86)\Microsoft Visual Studio 10.0\Xml\Schemas
我们现在 Visual Studio 中创建一个网站应用程序,为了方便检查,在网站中增加一个名为 index.aspx 的页面,并设为起始页。
首先解决 Sping.NET 在网站中的配置问题。
Spring.NET 大量使用配置文件,如果你愿意的话,也可以使用代码进行配置,不过,我们还是使用传统的配置文件方式。
一. 添加程序集引用
首先,我们需要在网站中添加对于 Spring.NET 程序集的引用,最基本的是两个程序集 Spring.Core.dll 和 Spring.Web.dll。
Spring.Core.dll 是整个 Spring.NET 的核心程序集,而 Spring.Web.dll 则对于网站开发提供支持。
二. 配置 Spring.NET
为了在启动网站的时候,能够自动创建 Spring.NET 的应用程序环境,需要在网站的配置文件 web.config 中进行设置。
1. 配置 Spring.NET 的 WebSupportModule,这个 Module 可以重建 Spring.NET 的应用程序环境,配置方式与普通的 Module 相同。
在网站的 web.config 配置文件中,增加 <httpModules> 配置节。
<system.web> <compilation debug="true" targetFramework="4.0" /> <httpModules> <!-- Spring 提供的 Module --> <add name="Spring" type="Spring.Context.Support.WebSupportModule, Spring.Web"/> </httpModules> </system.web>
如果这个时候,运行网站,应该会看到如下的页面。
再刷新一下,又成为下面的样子。
错误的原因是没有在 web.config 中找到需要的 Spring.NET 配置信息。
解决这个问题,需要在 web.config 增加一个新的配置节,这个配置节由 Spring.NET 定义,需要添加在 web.config 的 configuration 的头部。
<configuration> <configSections> <!-- Spring 的配置 --> <sectionGroup name="spring"> <section name="context" type="Spring.Context.Support.WebContextHandler, Spring.Web"/> </sectionGroup> </configSections> <spring> <context> </context> </spring>
现在运行程序,应该可以正常看到页面内容了。
为了能够为页面对象进行注入,需要将创建页面对象的工作从默认的 ASP.NET 网站中替换到 Spring.NET 中,这需要配置一系列处理程序。
<httpHandlers> <!-- Spring 提供的处理程序 --> <add verb="*" path="*.aspx" type="Spring.Web.Support.PageHandlerFactory, Spring.Web"/> <!-- 取消 Spring.NET 对于 Web 服务的处理 --> <!--<add verb="*" path="*.asmx" type="Spring.Web.Services.WebServiceHandlerFactory, Spring.Web"/>--> <add verb="*" path="ContextMonitor.ashx" type="Spring.Web.Support.ContextMonitor, Spring.Web"/> <add verb="*" path="*.ashx" type="Spring.Web.Support.DefaultHandlerFactory, Spring.Web"/> </httpHandlers>
现在,页面应该可以正常浏览了。从此以后的页面将通过 Spring.NET 创建与管理。
三. 定义对象
首先,我们定义一个类,表示框架的信息。
public class Framework { public string Name { set; get; } }
在页面上定义一个 Label ,显示框架的名称。
<div> <h1><asp:Label runat="server" ID="lblFramework"></asp:Label></h1> </div>
然后,在 index.aspx 中定义一个注入点,准备使用这个对象。
public partial class index : System.Web.UI.Page { // 定义一个注入点 public Framework Framework { set; get; } protected void Page_Load(object sender, EventArgs e) { this.lblFramework.Text = this.Framework.Name; } }
下面在 Spring.NET 的配置使用。
定义对象主要有两种方式,直接定义在 web.config 中,或者定义在外部的配置文件中。
1. 直接定义在 web.config 中,使用 Spring.Context.Support.DefaultSectionHandler。这样可以在配置文件中直接定义。
<configSections> <!-- Spring 的配置 --> <sectionGroup name="spring"> <section name="context" type="Spring.Context.Support.WebContextHandler, Spring.Web"/> <!-- 支持在 web.config 中定义对象 --> <section name="objects" type="Spring.Context.Support.DefaultSectionHandler, Spring.Core" /> </sectionGroup> </configSections> <spring> <context> <resource uri="config://spring/objects"/> </context> <!-- 直接定义在 web.config 中的对象 --> <objects> <object id="framework" type="Spring_Web_1.Framework"> <property name="Name" value="Spring.NET"/> </object> <!-- 页面对象 --> <object type="~/index.aspx"> <!-- ref 表示引用的对象 --> <property name="Framework" ref="framework"/> </object> </objects> </spring>
注意上面的 resource 配置元素,说明 Spring.NET 的应用程序上下文中需要使用定义在配置文件的 spring 配置节中的 objects 配置元素来定义对象。
在 objects 配置节中,我们定义了两个对象 corporation 和 一个页面。
对于 corporation 我们对 Name 属性直接使用值进行注入,使用的属性为 value 方式。
而对于页面,我们使用引用方式,使用的配置属性为 ref,值设置为另一个对象的 id。
现在,运行程序,我们应该可以看到这样的页面。
2. 在单独的配置文件中配置对象。
在网站中创建一个名为 Config 的文件夹,以保存独立的配置文件。
在 Config 文件夹中,创建一个名为 objects.xml 的 Xml 配置文件。添加名为 objects 的根元素,添加默认命名空间 xmlns="http://www.springframework.net",还记得在上一篇文件中,将架构文件添加到 Visual Studio 中吗?现在有用了。
<?xml version="1.0" encoding="utf-8" ?> <objects xmlns="http://www.springframework.net"> </objects>
添加原来对象定义到这里。
<?xml version="1.0" encoding="utf-8" ?> <objects xmlns="http://www.springframework.net"> <object id="framework" type="Spring_Web_1.Framework"> <property name="Name" value="Spring.NET"/> </object> <!-- 页面对象 --> <object type="~/index.aspx"> <!-- ref 表示引用的对象 --> <property name="Framework" ref="framework"/> </object> </objects>
将原来在 Web.config 中配置的 objects 配置节删除,将原来 context 配置节中的配置替换为如下的内容。
<context> <resource uri="~/Config/objects.xml"/> <!--<resource uri="config://spring/objects"/>--> </context>
现在的 uri 中是外部配置文件的路径了。
重新运行网站,你会看到网站依然在正常运行了。
四. 完整的配置文件
web.config 文件内容
<?xml version="1.0" encoding="utf-8"?> <!-- 有关如何配置 ASP.NET 应用程序的详细消息,请访问 http://go.microsoft.com/fwlink/?LinkId=169433 --> <configuration> <configSections> <!-- Spring 的配置 --> <sectionGroup name="spring"> <section name="context" type="Spring.Context.Support.WebContextHandler, Spring.Web"/> <!-- 支持在 web.config 中定义对象 --> <section name="objects" type="Spring.Context.Support.DefaultSectionHandler, Spring.Core" /> </sectionGroup> </configSections> <spring> <context> <resource uri="~/Config/objects.xml"/> <!--<resource uri="config://spring/objects"/>--> </context> <!-- 直接定义在 web.config 中的对象 --> <!--<objects> <object id="framework" type="Spring_Web_1.Framework"> <property name="Name" value="Spring.NET"/> </object> --><!-- 页面对象 --><!-- <object type="~/index.aspx"> --><!-- ref 表示引用的对象 --><!-- <property name="Framework" ref="framework"/> </object> </objects>--> </spring> <system.web> <compilation debug="true" targetFramework="4.0" /> <httpModules> <!-- Spring 提供的 Module --> <add name="Spring" type="Spring.Context.Support.WebSupportModule, Spring.Web"/> </httpModules> <httpHandlers> <!-- Spring 提供的处理程序 --> <add verb="*" path="*.aspx" type="Spring.Web.Support.PageHandlerFactory, Spring.Web"/> <!-- 取消 Spring.NET 对于 Web 服务的处理 --> <!--<add verb="*" path="*.asmx" type="Spring.Web.Services.WebServiceHandlerFactory, Spring.Web"/>--> <add verb="*" path="ContextMonitor.ashx" type="Spring.Web.Support.ContextMonitor, Spring.Web"/> <add verb="*" path="*.ashx" type="Spring.Web.Support.DefaultHandlerFactory, Spring.Web"/> </httpHandlers> </system.web> </configuration>
objects.xml 文件的内容
<?xml version="1.0" encoding="utf-8" ?> <objects xmlns="http://www.springframework.net"> <object id="framework" type="Spring_Web_1.Framework"> <property name="Name" value="Spring.NET"/> </object> <!-- 页面对象 --> <object type="~/index.aspx"> <!-- ref 表示引用的对象 --> <property name="Framework" ref="framework"/> </object> </objects>