ORM框架之NHibernate

什么是NHibernate

NHibernate是一个开源的对象关系映射（ORM）框架，它允许开发人员使用面向对象的方式来访问关系型数据库。它是Hibernate框架的C#版本，Hibernate框架是Java平台上的ORM框架。

使用NHibernate，您可以将.NET对象映射到数据库表，并使用面向对象的方式来查询和操作数据库。NHibernate支持多个数据库，包括Oracle、SQL Server和MySQL等。

要使用NHibernate，您需要做以下几个步骤：

1. 安装NHibernate NuGet包。
2. 配置NHibernate，包括数据库连接字符串、映射文件等。
3. 编写C#类，这些类将映射到数据库表。
4. 使用NHibernate的API来查询和操作数据库。

学习NHibernate需要一定的时间和精力，但是一旦您掌握了它，就可以轻松地将.NET应用程序与关系型数据库集成起来。

安装NHibernate

安装NHibernate NuGet包，您需要按照以下步骤操作：

1. 打开Visual Studio，创建一个新的C#项目。
2. 在“解决方案资源管理器”中，右键单击项目名称，然后选择“管理NuGet程序包”。
3. 在“NuGet程序包管理器”中，选择“浏览”选项卡。
4. 在搜索框中输入“NHibernate”，然后按Enter键搜索。
5. 选择“NHibernate”程序包，然后单击“安装”按钮。
6. 等待安装完成后，您就可以开始使用NHibernate了。

配置NHibernate详细步骤

如果您想使用NHibernate框架来访问关系型数据库，那么正确的配置是非常必要的。在本文中，我们将详细介绍如何配置NHibernate框架。

步骤1：添加NHibernate NuGet包

在开始配置NHibernate之前，您需要确保已经安装了NHibernate NuGet包。如果您还没有安装，可以按照以下步骤进行安装：

1. 打开Visual Studio，创建一个新的C#项目。
2. 在“解决方案资源管理器”中，右键单击项目名称，然后选择“管理NuGet程序包”。
3. 在“NuGet程序包管理器”中，选择“浏览”选项卡。
4. 在搜索框中输入“NHibernate”，然后按Enter键搜索。
5. 选择“NHibernate”程序包，然后单击“安装”按钮。
6. 等待安装完成后，您就可以开始使用NHibernate了。

步骤2：配置数据库连接字符串

在使用NHibernate框架之前，您需要配置数据库连接字符串。您可以在app.config或web.config文件中添加以下代码：

<connectionStrings><add name="MyConnectionString" connectionString="Data Source=myServerAddress;Initial Catalog=myDataBase;User Id=myUsername;Password=myPassword;" providerName="System.Data.SqlClient" />
</connectionStrings>

其中，您需要将“myServerAddress”替换为您的服务器地址，“myDataBase”替换为您要连接的数据库名称，“myUsername”和“myPassword”替换为您的数据库用户名和密码。

步骤3：创建映射文件

NHibernate需要一个映射文件将.NET类映射到数据库表。您可以使用XML或Fluent API来创建映射文件。以下是一个使用XML创建映射文件的示例：

<?xml version="1.0" encoding="utf-8"?>
<hibernate-mapping xmlns="urn:nhibernate-mapping-2.2" assembly="MyAssembly" namespace="MyNamespace"><class name="MyClass" table="MyTable"><id name="Id" column="Id"><generator class="native" /></id><property name="Name" column="Name" /><property name="Age" column="Age" /></class>
</hibernate-mapping>

其中，“MyAssembly”和“MyNamespace”分别替换为您的程序集和命名空间，“MyClass”和“MyTable”分别替换为您的类和表名。

步骤4：配置NHibernate

在开始使用NHibernate框架之前，您需要在app.config或web.config文件中配置以下代码：

<configSections><section name="hibernate-configuration" type="NHibernate.Cfg.ConfigurationSectionHandler,NHibernate" />
</configSections><hibernate-configuration xmlns="urn:nhibernate-configuration-2.2"><session-factory><property name="connection.provider">NHibernate.Connection.DriverConnectionProvider</property><property name="dialect">NHibernate.Dialect.MsSql2008Dialect</property><property name="connection.driver_class">NHibernate.Driver.SqlClientDriver</property><property name="connection.connection_string_name">MyConnectionString</property><mapping assembly="MyAssembly" /></session-factory>
</hibernate-configuration>

其中，“MyConnectionString”替换为您在步骤2中定义的连接字符串，“MyAssembly”替换为您的程序集名称。

如何编写C#类映射到数据库表

当我们使用NHibernate框架时，我们需要将.NET对象映射到数据库表。这可以通过使用映射文件或Fluent API来完成。

使用XML创建映射文件

XML文件是映射文件的传统格式。以下是一个使用XML创建映射文件的示例：

<?xml version="1.0" encoding="utf-8" ?>
<hibernate-mapping xmlns="urn:nhibernate-mapping-2.2"assembly="MyAssembly"namespace="MyNamespace"><class name="MyClass" table="MyTable"><id name="Id" column="Id"><generator class="native" /></id><property name="Name" column="Name" /><property name="Age" column="Age" /></class>
</hibernate-mapping>

其中，MyAssembly和MyNamespace分别替换为您的程序集和命名空间，MyClass和MyTable分别替换为您的类和表名。在上面的示例中，Id是主键，Name和Age是属性。

使用Fluent API创建映射文件

Fluent API是一种更简洁的方式来编写映射文件。以下是一个使用Fluent API创建映射文件的示例：

public class MyClassMap : ClassMap<MyClass>
{public MyClassMap(){Table("MyTable");Id(x => x.Id);Map(x => x.Name);Map(x => x.Age);}
}

在上面的示例中，我们使用ClassMap类来定义映射文件。Table方法指定表名，Id和Map方法分别指定主键和属性。

如何使用NHibernate的API来查询和操作数据库

使用ISession接口

ISession接口是NHibernate中最重要的接口之一。它代表着一个与数据库的会话，可以用来执行各种数据库操作。以下是一些常见的操作：

插入数据

要向数据库中插入数据，您可以创建一个实体对象，然后使用ISession接口的Save方法将其保存到数据库中。例如：

MyClass obj = new MyClass();
obj.Name = "John";
obj.Age = 30;using (ISession session = sessionFactory.OpenSession())
{using (ITransaction transaction = session.BeginTransaction()){session.Save(obj);transaction.Commit();}
}

在上面的示例中，我们创建了一个MyClass对象，并将其保存到数据库中。使用using语句块可以确保ISession和ITransaction对象在使用后被正确地关闭和释放。

更新数据

要更新数据库中的数据，您可以查询要更新的实体对象，然后修改其属性并将其保存回数据库。例如：

using (ISession session = sessionFactory.OpenSession())
{using (ITransaction transaction = session.BeginTransaction()){MyClass obj = session.Get<MyClass>(1);obj.Name = "Tom";obj.Age = 35;session.SaveOrUpdate(obj);transaction.Commit();}
}

在上面的示例中，我们查询了一个id为1的MyClass对象，并将其属性修改为Tom和35。然后，我们将其保存回数据库中，使用SaveOrUpdate方法可以自动判断是插入还是更新数据。

删除数据

要从数据库中删除数据，您可以查询要删除的实体对象，然后使用ISession接口的Delete方法将其从数据库中删除。例如：

using (ISession session = sessionFactory.OpenSession())
{using (ITransaction transaction = session.BeginTransaction()){MyClass obj = session.Get<MyClass>(1);session.Delete(obj);transaction.Commit();}
}

在上面的示例中，我们查询了一个id为1的MyClass对象，并将其从数据库中删除。

查询数据

要从数据库中查询数据，您可以使用ISession接口的CreateQuery方法创建一个查询对象，然后使用该对象进行查询。例如：

using (ISession session = sessionFactory.OpenSession())
{using (ITransaction transaction = session.BeginTransaction()){IQuery query = session.CreateQuery("from MyClass where Age > :age");query.SetInt32("age", 30);IList<MyClass> list = query.List<MyClass>();foreach (MyClass obj in list){Console.WriteLine("Name: " + obj.Name + ", Age: " + obj.Age);}transaction.Commit();}
}

在上面的示例中，我们创建了一个查询对象，查询年龄大于30的所有MyClass对象，并将其打印出来。

总结

使用NHibernate的API来查询和操作数据库非常简单。ISession接口提供了各种方法来执行各种数据库操作，包括插入、更新、删除和查询数据。使用NHibernate的API，您可以轻松地将.NET应用程序与关系型数据库集成起来。