乐趣区

C-数据操作系列-11-NHibernate-配置和结构介绍

0. 前言

今天是 NHibernate 的第二篇内容,通过上一篇的内容,我们初步了解了 NHibernate 的创建和使用。这一篇,我继续探索 NHibernate 背后的秘密。嗯,就是这样。

1. NHibernate 结构

先给小伙伴们放个图:

这是 NHibernate 的整体结构图。NHibernate 通过 ADO.NET 建立访问数据库的连接,然后封装了一个 Transaction(事务)工厂和一个 Session 工厂。每次操作的时候,通过两个工厂获取对应的 Session/Transaction 示例操作数据对象。

ISessionFactory – NHibernate.ISessionFactory:

一个基于单数据库的已编译的映射缓存,它是持久不变的且线程安全(额,这句话是从它的文档翻译过来的)。是一个提供 ISession 的工厂类,同时也是一个 IConnectionProvider 的客户端。可以设置一个在事务之间的进程级或集群级的二级缓存。

ISession – NHibernate.ISession:

一个单线程、短生命周期的对象,表示从应用程序和数据持久化之间一个连接。一个 ADO.NET 连接的封装,用来提供 ITransaction 的工厂。提供了一个通过主键检索对象和导航链接查询对象时的一级缓存。也就是 EF Core 中的导航属性。

Persistent Objects and Collections(持久化对象和集合):

一些单线程、短生命周期对象其中包含持久化状态和业务方法。它们可能只是一些普通的 POCO,仅仅是与 ISession 中关联起来了。只要 ISession 关闭了,这些对象就可以被分离出来然后可以在应用层的任意地方使用。

Transient Objects and Collections(临时对象和集合):

表示临时的未被 ISession 托管的持久化对象,它们被应用层临时创建但直到 ISession 关闭都不会被持久化。

ITransaction – NHibernate.ITransaction:

这个是可选的。表示一个单线程、短生命周期的对象,被应用程序用来限制一个原子的工作单元,基于 ADO.NET 的 Transaction 的抽象。一个 ISession 可能会开启多个事务,Transaction scopes may be used instead(原话是这个,大意是可以改用事务作用域)。

IConnectionProvider – NHibernate.Connection.IConnectionProvider:

也是可选的,是一个用来创建 ADO.NET Connection 和 Command 的工厂。基于 DbConnection 和 DbCommand 实现,并非直接暴露给应用程序,但是可以由开发者对其进行扩展或实现。

IDriver -NHibernate.Driver.IDriver:

可选的,驱动接口,用来封装隐藏不同 ADO.NET 数据提供程序之间的不同。例如:参数化等。

ITransactionFactory – NHibernate.Transaction.ITransactionFactory:

可选的,事务实现工厂,不对应用程序公开,但开发者可以对其进行扩展或实现。

2. 实例状态

在 NHibernate 中,一个可持久化的对象有三种不同的状态,依据与持久化上下文之间的关系不同,其中 ISession 就是一个持久化上下文。状态分为以下三种:

  • transient 暂存的、临时的 该状态的对象并没有被持久化上下文捕获到,简单来讲就是刚被创建,还没有从数据库 / 持久化上下文中获取到主键信息。
  • persistent 持久化的 该状态的对象表示已经被上下文正确获取到了,持久化上下文能够监控到对象的变化。持久化上下文中持有一个指向该对象的引用。这种状态通常是从数据库中获取到数据或者新建的数据附加到了上下文中。
  • detached 游离态 该状态的对象是从上下文中分离出来的,有了数据库主键,曾经或现在仍然有一条数据库记录与之对应。造成的原因可能有,上下文关闭了;该对象是在另一个上下文中持久化的,它对于当前上下文是游离态的。

3. 配置项介绍

在上一篇文章中,我们介绍了一下如何设置 NHibernate 的基本配置项,但是并未对配置项进行深入。这一节,将带领大家看一下 NHibernate 中我们常用的配置,因为配置项有很多,但一大部分通常情况都遇不到使用它的时候。

  • dialect

    数据库方言,表示 NHibernate 连接的数据库是什么,该用哪种格式解析关系映射到数据库 SQL 语句

  • default_schema

    默认的 schema,用来设置连接字符串连接的数据库默认的 schema。

  • connection.provider

    数据库连接的提供程序,默认是 NHibernate.Connection.DriverConnectionProvider. 填继承自 IConnectionProvider 的实现类

  • connection.connection_string

    数据库连接字符串

  • connection.connection_string_name

    数据库连接字符串的名称,指的是配置在程序的配置文件中 connectionStrings 节点的数据连接字符串。

  • max_fetch_depth

    最大递归深度,表示一次查询中直接加载的导航属性深度。默认是不直接加载导航属性,基于延迟加载的逻辑,由实际使用时才从数据库中加载数据。

  • show_sql

    是否在控制台中打印转换的 SQL 语句,一般在调试的过程中会设置为 true,用来确认生成的 SQL 是否正确等。

  • hbm2ddl.auto

    该值表示每次 ISessionFactory 创建的时候,是否自动生成 DDL 语句并提交数据库执行。默认是空,表示不会强制更新数据库。有几个候选值:create 或 create-drop、update 等。其中 create 表示每次只创建新增的;create-drop 表示每次 ISessionFactory 创建时创建表,ISessionFactory 关闭时,删除表;其中 update 表示每次都会将 DDL SQL 更新到数据库中。(我记得有 update,但文档中没有这个选项)

以上是我们常用的一些配置内容,当然还有更多的配置,我并没有在这里一一讲明,留待以后吧。

4. 总结

这是一篇枯燥乏味的说明文,主要介绍了 Nhibernate 的基本内容。下一章我们来试试,如何创建 Nhibernate 的映射配置。

更多内容烦请关注我的博客《高先生小屋》

退出移动版