NHibernate快速起步
来源:互联网 发布:手机淘宝怎么举报商品 编辑:程序博客网 时间:2024/05/19 13:57
NHibernate快速起步
注:本文中使用的是NH1.0.2版本,其他版本配置可能略有不同。
示例代码下载。
数据库脚本下载
一、体系结构
首先我们来看看NHibernate的体系结构:
NHibernate是数据库和应用程序之间的持久化层,应用程序和NHibernate通过持久化(Persistent)对象联系在一起。NHibernate使用app.config或者web.config和映射文件进行设置。
下面来看看怎么使用NHibernate API的一个最小子集。
下面是图中一些对象的定义:
Configuration(NHibernate.Cfg.Configuration)
- 配置对象,用来指定用来出创建ISessionFactory的属性和映射文件。(图中没有此对象)
- SessionFactory (NHibernate.ISessionFactory)
Session的工厂。
- 会话,Session (NHibernate.ISession)
代表应用程序和持久化层之间的一次对话。封装了一个ADO.NET连接。也是Transaction的工厂。保存有必需的(第一级)持久化对象的缓存,用于遍历对象图,或者通过标识符查找对象。
- 事务Transaction (NHibernate.ITransaction)
(可选) 单线程,生命期短促的对象,应用程序用它来表示一批工作的原子操作。是底层的ADO.NET事务的抽象。一个Session某些情况下可能跨越多个Transaction 事务。
二、示例代码
我们看看他们是如何协同工作的,请看下面的代码。
代码示例(未改变数据库中的数据,查询操作):
//配置ConfigurationConfiguration cfg = new Configuration().Configure();//创建ISessionFactoryISessionFactory factory = cfg.BuildSessionFactory();//打开ISessionISession session = factory.OpenSession();try{ 在这里添加操作}finally{ session.Close();}
Configuration的Configure方法,将使用应用程序的配置文件或者hibernate.cfg.xml文件的<hibernate-configuration>节点进行配置,返回值是一个配置好了的Configuration对象的实例。
然后这个Configuration通过BuildSessionFactory方法创建ISessionFactory的实例。
ISessionFactory的实例通过OpenSession打开一个ISession的实例,用这个实例完成数据库的操作,然后关闭它。
如果你的代码中需要事务,只需要把代码稍微修改一下。
代码示例(改变了数据库中的数据,数据的增删改):
//配置ConfigurationConfiguration cfg = new Configuration().Configure();//创建ISessionFactoryISessionFactory factory = cfg.BuildSessionFactory();//定义事务ITransaction tx = null;//打开ISessionISession session = factory.OpenSession();try{ //开始事务 tx = session.BeginTransaction(); 在这里添加操作 tx.Commit();}catch(HibernateException ex){ if (tx!=null) tx.Rollback(); throw ex;}finally{ //关闭ISession session.Close();}
我一般在不影响数据的方法(例如:查询)中不包含事务,而影响数据的方法(例如:增删改)使用事务。
三、配置文件
前面提到Configuration的Configure方法需要用到应用程序的配置文件或者hibernate.cfg.xml文件,这里我使用hibernate.cfg.xml配置文件,在下一章我们再探讨使用应用程序的配置文件和其他的配置方法。
这是一个典型的配置文件:
<?xml version="1.0" encoding="utf-8" ?><hibernate-configuration xmlns="urn:nhibernate-configuration-2.0"> <session-factory name="DDLLY.MyDoc.NHibernateTest.QuickStart"> <!-- 属性 --> <property name="connection.provider">NHibernate.Connection.DriverConnectionProvider</property> <property name="connection.driver_class">NHibernate.Driver.SqlClientDriver</property> <property name="connection.connection_string">server=.;database=user;uid=sa;pwd=App1234;</property> <property name="show_sql">false</property> <property name="dialect">NHibernate.Dialect.MsSql2000Dialect</property> <property name="use_outer_join">true</property> <property name="query.substitutions">true 1, false 0, yes 'Y', no 'N'</property> <!-- 映射文件 --> <mapping assembly="DDLLY.MyDoc.NHibernateTest.QuickStart" /> </session-factory></hibernate-configuration>
属性connection.provider设置了数据库连接提供者(一般不需要更改,除非你决定自己实现提供者)。
connection.driver_class设置了数据库的的驱动类(这里设置了SqlServer的驱动类)。
connection.connection_string是数据库的连接字符串。
show_sql设置是否在运行时是否在控制台显示正在执行的SQL语句(这个属性在调试程序时很有用)。
dialect是NHibernate方言, 可以让NHibernate使用某些特定的数据库平台的特性。
use_outer_join在后面的章节会有介绍。
query.substitutions,把NHibernate查询中的一些短语替换为SQL短语(比如说短语可能是函数或者字符)。
mapping节点设置了将使用到的映射文件,现在的设置方法是使用"DDLLY.MyDoc.NHibernate.QuickStart“中所有的映射文件。
四、映射文件
ISession怎么知道和数据库的哪张表哪个字段打交道,以及怎么把表和实体对象联系起来呢?靠的就是映射文件。
假设我们有个很简单的例子,我们有如下的一张表需要进行数据操作(字段和表含义一看就知道,我就不罗嗦了):
CREATE TABLE [dbo].[users] ([Id] [int] IDENTITY (1, 1) NOT NULL ,[UserName] [nvarchar] (64) NOT NULL ,[Password] [varchar] (32) NOT NULL ,[Email] [varchar] (64) NULL)
我们设置它的映射文件和相应的代码文件:
<?xml version="1.0" encoding="utf-8" ?> <hibernate-mapping xmlns="urn:nhibernate-mapping-2.0"> <class name="DDLLY.MyDoc.NHibernateTest.QuickStart.User, DDLLY.MyDoc.NHibernateTest.QuickStart" table="users"> <id name="Id" type="Int32"> <generator class="identity" /> </id> <property name="UserName" type="String"/> <property name="Password" type="String"/> <property name="Email" type="String"/> </class> </hibernate-mapping>
namespace DDLLY.MyDoc.NHibernateTest.QuickStart{ /**//// <summary> /// User实体 /// </summary> public class User { public User() { } private int m_Id; private string m_UserName; private string m_Password; private string m_Email; public int Id { get { return m_Id; } set { m_Id = value; } } public string UserName { get { return m_UserName; } set { m_UserName = value; } } public string Password { get { return m_Password; } set { m_Password = value; } } public string Email { get { return m_Email; } set { m_Email = value; } } }}
<class name="DDLLY.MyDoc.NHibernate.QuickStart.User, DDLLY.MyDoc.NHibernate.QuickStart" table="users"> 表示映射文件对应的类文件是DDLLY.MyDoc.NHibernate.QuickStart程序集中的DDLLY.MyDoc.NHibernate.QuickStart.User类,逗号后面是表示程序集。对应的数据库表为users。
<id name="Id" type="Int32">
<generator class="identity" />
</id>
表示Id是主键字段,generator是生成器,这里是使用SqlServer中内置标识字段来生成。
property定义了其他的字段。
五、完成代码
好了,下面我们可以开始对数据进行操作了。
我们来看看ISession为我们提供的常用方法。
Load:读取实体对象
Find:通过HQL查找实体对象
Save:保存实体对象
Delete:删除实体对象
用这些方法我们便可以完成对数据库的增删改查的操作了。下面是我完成的代码(使用NUnit进行测试)。
using System.Collections;using System.Data.SqlClient;using NHibernate;using NHibernate.Cfg;using NUnit.Framework;namespace DDLLY.MyDoc.NHibernateTest.QuickStart{ /**//// <summary> /// User测试类 /// </summary> [TestFixture] public class UserFixture { 常量#region 常量 /**//// <summary> /// 连接字符串 /// </summary> private const string CONNECTIONSTRING = "server=.;database=user;uid=sa;pwd=App1234;"; #endregion SetUp和TearDown#region SetUp和TearDown [SetUp] public void SetUp() { //添加名为LLY,密码为123456的用户,因为这是数据库的第一条记录,所以数据库标识为1 string SetUpSql = "INSERT INTO users([UserName],[Password]) VALUES('LLY','123456')"; SqlExecuteNonQuery(SetUpSql); } [TearDown] public void TearDown() { //清空users表,并把标识(identity)清零 string TearDownSql = "TRUNCATE TABLE users"; SqlExecuteNonQuery(TearDownSql); } #endregion 私有方法#region 私有方法 /**//// <summary> /// 执行SQL语句 /// </summary> /// <param name="sql">SQL语句</param> private void SqlExecuteNonQuery(string sql) { SqlConnection con = new SqlConnection(CONNECTIONSTRING); con.Open(); SqlCommand cmd = new SqlCommand(); cmd.Connection = con; cmd.CommandText = sql; cmd.ExecuteNonQuery(); con.Close(); } #endregion 测试方法#region 测试方法 /**//// <summary> /// 测试读取用户 /// </summary> [Test] public void TestLoadUser() { User user; //配置Configuration Configuration cfg = new Configuration().Configure(); //创建ISessionFactory ISessionFactory factory = cfg.BuildSessionFactory(); //打开ISession ISession session = factory.OpenSession(); try { user = session.Load(typeof (User), 1) as User; } finally { session.Close(); } //************************数据检查***************************** //检查 Assert.IsNotNull(user, "没有找到ID为1的用户!"); Assert.AreEqual("LLY", user.UserName, "没有找到名字为LLY的用户!"); } /**//// <summary> /// 测试查找用户 /// </summary> [Test] public void TestFindUser() { IList userlist; //配置Configuration Configuration cfg = new Configuration().Configure(); //创建ISessionFactory ISessionFactory factory = cfg.BuildSessionFactory(); //打开ISession string hql = "from User as u where u.UserName='LLY'"; ISession session = factory.OpenSession(); try { userlist = session.Find(hql); } finally { session.Close(); } //************************数据检查***************************** //检查 Assert.AreEqual(1, userlist.Count, "名字为LLY的用户个数不为1!"); } /**//// <summary> /// 测试添加用户 /// </summary> [Test] public void TestAddUser() { User newUser = new User(); //配置Configuration Configuration cfg = new Configuration().Configure(); //创建ISessionFactory ISessionFactory factory = cfg.BuildSessionFactory(); //定义事务 ITransaction tx = null; //打开ISession ISession session = factory.OpenSession(); try { //开始事务 tx = session.BeginTransaction(); newUser.UserName = "DDL"; newUser.Password = "123456"; newUser.Email = "DDLLY@tom.com"; // 保存新用户 session.Save(newUser); tx.Commit(); } catch (HibernateException ex) { if (tx != null) tx.Rollback(); throw ex; } finally { //关闭ISession session.Close(); } //************************数据检查***************************** IList userlist; string hql = "from User as u where u.UserName='DDL'"; session = factory.OpenSession(); try { userlist = session.Find(hql); } finally { session.Close(); } //检查是否有且仅有一个名称为DDL的用户 Assert.AreEqual(1, userlist.Count, "名字为DDL的用户个数不为1!"); } /**//// <summary> /// 测试删除用户 /// </summary> [Test] public void TestDeleteUser() { IList userlist; User user; //配置Configuration Configuration cfg = new Configuration().Configure(); //创建ISessionFactory ISessionFactory factory = cfg.BuildSessionFactory(); //定义事务 ITransaction tx = null; //打开ISession ISession session = factory.OpenSession(); try { //开始事务 tx = session.BeginTransaction(); user = session.Load(typeof (User), 1) as User; session.Delete(user); tx.Commit(); } catch (HibernateException ex) { if (tx != null) tx.Rollback(); throw ex; } finally { session.Close(); } //************************数据检查***************************** string hql = "from User as u where u.UserName='LLY'"; session = factory.OpenSession(); try { userlist = session.Find(hql); } finally { session.Close(); } //检查 Assert.AreEqual(0, userlist.Count, "名字为LLY的用户没有被删除!"); } /**//// <summary> /// 测试更新用户 /// </summary> [Test] public void TestUpdateUser() { User user; //配置Configuration Configuration cfg = new Configuration().Configure(); //创建ISessionFactory ISessionFactory factory = cfg.BuildSessionFactory(); //定义事务 ITransaction tx = null; //打开ISession ISession session = factory.OpenSession(); try { //开始事务 tx = session.BeginTransaction(); user = session.Load(typeof (User), 1) as User; user.Password = "123"; session.Update(user); tx.Commit(); } catch (HibernateException ex) { if (tx != null) tx.Rollback(); throw ex; } finally { session.Close(); } //************************数据检查***************************** session = factory.OpenSession(); try { user = session.Load(typeof (User), 1) as User; } finally { session.Close(); } //检查 Assert.IsNotNull(user, "没有找到名字为LLY的用户!"); Assert.AreEqual("123", user.Password, "没有找到名字为LLY的用户!"); } #endregion }}
- NHibernate快速起步
- NHibernate快速起步
- NHibernate文档翻译 第1章----快速起步
- Nhibernate起步走
- Nhibernate学习之起步篇
- Nhibernate学习之起步篇
- Nhibernate学习之起步篇-1
- Nhibernate学习之起步篇-1
- Nhibernate学习之起步篇-1
- Nhibernate学习之起步篇-1
- NHibernate快速指南(翻译)
- NHibernate快速指南
- NHibernate快速指南(翻译)
- NHibernate快速指南(翻译)
- NHibernate快速指南(翻译)
- NHibernate快速指南 [转摘]
- NHibernate快速指南(翻译)
- NHibernate快速指南
- MySQL单表到底可以多大
- 第一篇博文
- ARM 中断
- NHibernate入门hello world
- C语言之父走了
- NHibernate快速起步
- firefox添加侧边栏工具
- java nio 模式原理学习
- 如何求素数
- 我为什么选择 iBatis 而不是 Hibernate(对于正在选型的人的建议)
- 快速排序的那些事
- IIS一些错误
- 关于键盘输入
- kde4 + compiz只有两个桌面的问题