ORM框架之NHibernate

最新推荐文章于 2024-08-07 14:34:47 发布

Documentlv

最新推荐文章于 2024-08-07 14:34:47 发布

阅读量1k

点赞数 1

分类专栏： C# 文章标签：数据库 hibernate c# 后端学习

本文链接：https://blog.csdn.net/documentlv/article/details/129999750

版权

C# 专栏收录该内容

36 篇文章 6 订阅

订阅专栏

什么是NHibernate

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

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

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

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

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

安装NHibernate

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

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

配置NHibernate详细步骤

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

步骤1：添加NHibernate NuGet包

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

打开Visual Studio，创建一个新的C#项目。
在“解决方案资源管理器”中，右键单击项目名称，然后选择“管理NuGet程序包”。
在“NuGet程序包管理器”中，选择“浏览”选项卡。
在搜索框中输入“NHibernate”，然后按Enter键搜索。
选择“NHibernate”程序包，然后单击“安装”按钮。
等待安装完成后，您就可以开始使用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对象，并将其打印出来。