NHibernate - 入门


在本章中,我们将了解如何使用 NHibernate 启动一个简单的示例。我们将构建一个简单的控制台应用程序。为了创建控制台应用程序,我们将使用 Visual Studio 2015,它包含创建、使用 NHibernate 包测试您的应用程序所需的所有功能。

以下是使用 Visual Studio 中提供的项目模板创建项目的步骤。

步骤 1 - 打开 Visual Studio 并单击“文件”→“新建”→“项目”菜单选项。

步骤 2 - 将打开一个新的项目对话框。

项目对话

步骤 3 - 从左侧窗格中,选择模板 → Visual C# → Windows。

步骤 4 - 在中间窗格中,选择控制台应用程序。

步骤 5 - 在“名称”字段中输入项目名称“NHibernateDemoApp”,然后单击“确定”继续。

步骤 6 - Visual Studio 创建项目后,您将看到解决方案资源管理器窗口中显示许多文件。

项目对话

如您所知,我们已经创建了一个简单的控制台应用程序项目,现在我们需要将 NHibernate 包包含到我们的控制台项目中。

转到“工具”菜单并选择“NuGet 包管理器”→“包管理器控制台”,它将打开“包管理器控制台”窗口。

管理器控制台窗口

指定上面的包管理器控制台窗口中显示的命令并按 Enter 键,它将下载所有 NHibernate 依赖项并创建对所有必需程序集的引用。安装完成后,您将看到如下图所示的消息。

NHibernate 演示应用程序

现在我们已经添加了NHibernate,我们现在可以开始实施了。因此,我们首先映射一个名为Student的非常简单的,该表只有一个名为 ID 的整数主键以及一个 FirstName 和 LastName 列。

添加新项目

我们需要一个类来代表该学生,因此让我们创建一个名为 Student 的新类,方法是右键单击解决方案资源管理器中的项目,然后选择“添加”→“类”,这将打开“添加新项”对话框。

添加新项目 NHibernate

在名称字段中输入Student.cs,单击“添加”按钮。在这个 Student 类中,我们需要有一个名为 ID 的整数主键,并且需要创建这个字符串、FirstNameLastName字段,如以下 Student 类的完整实现所示。

using System; 
using System.Collections.Generic; 
using System.Linq; 
using System.Text; 
using System.Threading.Tasks;

namespace NHibernateDemoApp { 
   
   class Student { 
      public virtual int ID { get; set; } 
      public virtual string LastName { get; set; } 
      public virtual string FirstMidName { get; set; } 
   } 
}

当处理 NHibernate 应用程序中的模型时,最简单的方法是将所有字段虚拟化。这是我们将使用的简单 NHibernate 模型,并将其映射到后端数据库。

现在让我们转到 Program 类中的 Main 方法并创建一个新的 NHibernate 配置对象。

我们需要提供的第一件事是连接字符串这是数据库特定的连接字符串,查找连接字符串的最简单方法是在SQL Server 对象资源管理器中右键单击数据库并选择“属性”。

SQL Server 对象资源管理器

它将打开“属性”窗口,现在向下滚动,您将在“属性”窗口中看到“连接字符串”字段。

属性窗口

复制连接字符串并在代码中指定。以下是 Main 方法的实现,其中我们需要配置 NHibernate。

using NHibernate.Cfg;
using NHibernate.Dialect;
using NHibernate.Driver;

using System;
using System.Linq;
using System.Reflection;

namespace NHibernateDemoApp {

   class Program {
   
      static void Main(string[] args) {
         var cfg = new Configuration();
			
         String Data Source = asia13797\\sqlexpress;
         String Initial Catalog = NHibernateDemoDB;
         String Integrated Security = True;
         String Connect Timeout = 15;
         String Encrypt = False;
         String TrustServerCertificate = False;
         String ApplicationIntent = ReadWrite;
         String MultiSubnetFailover = False;
			
         cfg.DataBaseIntegration(x = > { x.ConnectionString = "Data Source + 
            Initial Catalog + Integrated Security + Connect Timeout + Encrypt +
            TrustServerCertificate + ApplicationIntent + MultiSubnetFailover";
         
                     
            x.Driver<SqlClientDriver>(); 
            x.Dialect<MsSql2008Dialect>();
         });
         
         cfg.AddAssembly(Assembly.GetExecutingAssembly());
         
         var sefact = cfg.BuildSessionFactory(); 
         
         using (var session = sefact.OpenSession()) {
         
            using (var tx = session.BeginTransaction()) {
               //perform database logic 
               tx.Commit();
            }
            
            Console.ReadLine(); 
         } 
      } 
   } 
}

在连接字符串之后,我们需要提供一个驱动程序,即 SQLClientDriver 然后我们还需要为其提供一个方言,即 SQL Server 的版本,我们将使用 MS SQL 2008。

NHibernate 现在知道如何连接到数据库。我们需要做的另一件事是为其提供我们将映射的模型列表。

我们可以通过添加程序集来做到这一点,因此通过指定 Assembly.GetExecutingAssembly 这就是程序将找到映射文件的位置。映射文件告诉 NHibernate 如何从 C# 类进入数据库表。

SessionFactory 编译初始化 NHibernate 所需的所有元数据。SessionFactory可用于构建会话,大致类似于数据库连接。所以合适的方法是在using块中使用它。我可以说var session等于sessionFactory.OpenSession并且我想在其事务内部执行此操作。

一旦会话打开,我们就可以告诉会话开始一个新事务,然后我们可以在这里执行一些逻辑。因此,执行一些数据库逻辑并最终提交该事务。