C# 数据操作系列 - 12 NHibernate的增删改查（重生之门）-FinClip官网

C# 数据操作系列 - 12 NHibernate的增删改查（重生之门）

网友投稿 1223 2022-09-17

C# 数据操作系列 - 12 NHibernate的增删改查（重生之门）

0. 前言

上一篇《C# 数据操作系列 - 11 NHibernate 配置和结构介绍》介绍了Nhibernate里的配置内容。这一篇将带领大家了解一下如何使用NHIbernate。之前提到NHibernate继承了Hibernate的一些传统：使用XML文件进行配置，这一点也是备受争议。不过，有社区爱好者开发了一个名为《Fluent NHibernate》的项目，用来支持NHibernate的流式配置。当然，NHibernate本身也提供了NHibernate.Mapping.ByCode模式。不过这一篇暂且略过，留待下文。

1. NHibernate映射文件

对于NHibernate的映射文件有个约定的名字：

<类名>.hbm.xml

这里先为大家介绍一下映射文件的格式：

1.1 hibernate-mapping 的说明

schema="schemaName" (1)

default-cascade="none|save-update" (2)

auto-import="true|false" (3)

assembly="Eg" (4)

namespace="Eg" (5)

default-access="field|property|field.camecase..." (6)

default-lazy="true|false" (7)

schema: 数据库schema的名称

default-cascade：可选项，默认是none，一种默认的级联风格

auto-import：明确是否可以在查询中使用非限定类名。

assembly：指定映射对象所在的assembly，一般情况指的是项目名称

namespace：所在命名空间

default-access：可选的，默认是property，表示NHibernate的读取数据列的策略，默认情况从Property 中读取

default-lazy：可选的，默认是true，是否启动延迟加载

1.2 class的配置

一般情况下，class节点只需要指定name和table就可以了。接下来，让我们探索class如何映射成的。

1.2.1 id

任何一个映射都必须声明一个数据表的主键，大多数类也必须有一个唯一标示字段用来区分不同的实例。

这里介绍一下 id 节点的配置：

name="PropertyName"

type="typename"

column="column_name">

name : 对应的属性名

type：对应的NHibernate类型

column：列名

generator：主键生成器，如果不需要参数可以直接在 id节点处添加，最常用的是native。

1.2.2 property

映射一个普通属性就简单多了，只需要进行以下配置即可：

name="propertyName"

column="column_name"

type="typename"

name ：类里的属性名

column：对应数据表的列名

type：数据库中的类型

1.2.3 many-to-one

在Nhibernate中，多对一的配置是在一的一端，表示该类有一个外键导航。

name="PropertyInOne"

class="ManyClass"

column="Column"

1.2.4 one-to-one

一对一的关系与多对一的关系比较相似，不同的地方在于一对一需要在双方的映射关系里均要维护，在有外键的表/实体中添加 constrained=“true”。

示例如下：

2. 增删改查

Nhibernate的每次操作都基于一个Session，所以我们在操作数据库的时候最好先持有一个可用的Session。接下来，我们就一个通用数据库操作类为基础，向大家分享一下我的想法。

首先，创建一个泛型模板类，并约束泛型为类：

public class Repository where T: class

{

}

添加一个ISession属性，用来后续访问操作，并由构造方法赋值：

public Repository(ISession session)

{

Session = session;

}

public ISession Session { get; }

2.1 新增

现在我们写一下新增方法：

public object Add(T entity)

{

var key= Session.Save(entity);

return key;

}

public void Add(params T[] entities)

{

foreach (var entity in entities)

{

Session.Save(entity);

}

查了下，Save会返回当前持久化对象插入时生成的主键。

2.2 修改

NHibernate的修改与EF类似，也是由ISession监控了修改，不用做过多的操作。

2.3 删除

NHibernate的删除也十分简单，直接通知ISession删除某个持久化对象。

public void Delete(T entity)

{

Session.Delete(entity);

}

public void Delete(params T[] entities)

{

foreach (var entity in entities)

{

Session.Delete(entity);

}

2.4 查询

通常情况下，查询需要结合实际业务来进行开发，当然为了通用，我在这里选择给调用方开放一个查询对象：

public IQueryable IqQueryable()

{

return Session.Query();

}

其中 IQueryable是一个接口，表示这是一个可查询对象，通过Linq可以快捷的查询。

3. 总结

嗯，NHibernate基础使用篇到这里可以暂告一段落了。后续的内容有机会再深挖，当然并不代表EF Core就没有了。嗯嗯，没毛病。下一篇就让我来先替大伙看看SugarSQL是什么情况吧。

不过在本篇内容完结之前，先补充一个NHibernate的SqlDialect选值：

数据库

Dialect

备注

DB2

NHibernate.Dialect.DB2Dialect

DB2 for iSeries(OS/400)

NHibernate.Dialect.DB2400Dialect

Firebird

NHibernate.Dialect.FirebirdDialect

需要设置driver_class为NHibernate.Driver.FirebirdClientDriver

Informix

NHibernate.Dialect.InformixDialect

Informix 9.40

NHibernate.Dialect.InformixDialect0940

Informix 10.00

NHibernate.Dialect.InformixDialect1000

Ingres

NHibernate.Dialect.IngresDialect

Ingres 9

NHibernate.Dialect.Ingres9Dialect

Microsoft SQL Server 7

NHibernate.Dialect.MsSql7Dialect

Microsoft SQL Server 2000

NHibernate.Dialect.MsSql2000Dialect

Microsoft SQL Server 2005

NHibernate.Dialect.MsSql2005Dialect

Microsoft SQL Server 2008

NHibernate.Dialect.MsSql2008Dialect

Microsoft SQL Azure Server 2008

NHibernate.Dialect.MsSqlAzure2008Dialect

Microsoft SQL Server 2012

Hibernate.Dialect.MsSql2012Dialect

Microsoft SQL Server Compact Edition

NHibernate.Dialect.MsSqlCeDialect

Microsoft SQL Server Compact Edition 4.0

NHibernate.Dialect.MsSqlCe40Dialect

MySQL 3 or 4

NHibernate.Dialect.MySQLDialect

MySQL 5

NHibernate.Dialect.MySQL5Dialect

MySQL 5 InnoDB

NHibernate.Dialect.MySQL5InnoDBDialect

MySQL 5.5

NHibernate.Dialect.MySQL55Dialect

MySQL 5.5 Inno DB

NHibernate.Dialect.MySQL55InnoDBDialect

Oracle

NHibernate.Dialect.Oracle8iDialect

Oracle 9i

NHibernate.Dialect.Oracle9iDialect

Oracle 10g, Oracle 11g

NHibernate.Dialect.Oracle10gDialect

Oracle 12c

NHibernate.Dialect.Oracle12cDialect

PostgreSQL

NHibernate.Dialect.PostgreSQLDialect

PostgreSQL 8.1

NHibernate.Dialect.PostgreSQL81Dialect

支持8.1 的 FOR UPDATE NOWAIT

PostgreSQL 8.2

NHibernate.Dialect.PostgreSQL82Dialect

在DROP TABLE和DROP SEQUENCE 语句中支持 IF EXISTS关键字

PostgreSQL 8.3

NHibernate.Dialect.PostgreSQL83Dialect

支持XML类型

SQLite

NHibernate.Dialect.SQLiteDialect

设置driver_class为NHibernate.Driver.SQLite20Driver

Sybase Adaptive Server Anywhere 9

NHibernate.Dialect.SybaseASA9Dialect

Sybase Adaptive Server Enterprise 15

NHibernate.Dialect.SybaseASE15Dialect

Sybase SQL Anywhere 10

NHibernate.Dialect.SybaseSQLAnywhere10Dialect

Sybase SQL Anywhere 11

NHibernate.Dialect.SybaseSQLAnywhere11Dialect

Sybase SQL Anywhere 12

NHibernate.Dialect.SybaseSQLAnywhere12Dialect

schema="schemaName" (1)

default-cascade="none|save-update" (2)

auto-import="true|false" (3)

assembly="Eg" (4)

namespace="Eg" (5)

default-access="field|property|field.camecase..." (6)

default-lazy="true|false" (7)

schema: 数据库schema的名称

default-cascade：可选项，默认是none，一种默认的级联风格

auto-import：明确是否可以在查询中使用非限定类名。

assembly：指定映射对象所在的assembly，一般情况指的是项目名称

namespace：所在命名空间

default-access：可选的，默认是property，表示NHibernate的读取数据列的策略，默认情况从Property 中读取

default-lazy：可选的，默认是true，是否启动延迟加载

1.2 class的配置

一般情况下，class节点只需要指定name和table就可以了。接下来，让我们探索class如何映射成的。

1.2.1 id

任何一个映射都必须声明一个数据表的主键，大多数类也必须有一个唯一标示字段用来区分不同的实例。

这里介绍一下 id 节点的配置：

name="PropertyName"

type="typename"

column="column_name">

name="PropertyName"

type="typename"

column="column_name">

name : 对应的属性名

type：对应的NHibernate类型

column：列名

generator：主键生成器，如果不需要参数可以直接在 id节点处添加，最常用的是native。

1.2.2 property

映射一个普通属性就简单多了，只需要进行以下配置即可：

name="propertyName"

column="column_name"

type="typename"

name ：类里的属性名

column：对应数据表的列名

type：数据库中的类型

1.2.3 many-to-one

在Nhibernate中，多对一的配置是在一的一端，表示该类有一个外键导航。

name="PropertyInOne"

class="ManyClass"

column="Column"

1.2.4 one-to-one

一对一的关系与多对一的关系比较相似，不同的地方在于一对一需要在双方的映射关系里均要维护，在有外键的表/实体中添加 constrained=“true”。

示例如下：

2. 增删改查

首先，创建一个泛型模板类，并约束泛型为类：

public class Repository where T: class

{

}

添加一个ISession属性，用来后续访问操作，并由构造方法赋值：

public Repository(ISession session)

{

Session = session;

}

public ISession Session { get; }

2.1 新增

现在我们写一下新增方法：

public object Add(T entity)

{

var key= Session.Save(entity);

return key;

}

public void Add(params T[] entities)

{

foreach (var entity in entities)

{

Session.Save(entity);

}

查了下，Save会返回当前持久化对象插入时生成的主键。

2.2 修改

NHibernate的修改与EF类似，也是由ISession监控了修改，不用做过多的操作。

2.3 删除

NHibernate的删除也十分简单，直接通知ISession删除某个持久化对象。

public void Delete(T entity)

{

Session.Delete(entity);

}

public void Delete(params T[] entities)

{

foreach (var entity in entities)

{

Session.Delete(entity);

}

2.4 查询

通常情况下，查询需要结合实际业务来进行开发，当然为了通用，我在这里选择给调用方开放一个查询对象：

public IQueryable IqQueryable()

{

return Session.Query();

}

其中 IQueryable是一个接口，表示这是一个可查询对象，通过Linq可以快捷的查询。

3. 总结

不过在本篇内容完结之前，先补充一个NHibernate的SqlDialect选值：

数据库

Dialect

备注

DB2

NHibernate.Dialect.DB2Dialect

DB2 for iSeries(OS/400)

NHibernate.Dialect.DB2400Dialect

Firebird

NHibernate.Dialect.FirebirdDialect

需要设置driver_class为NHibernate.Driver.FirebirdClientDriver

Informix

NHibernate.Dialect.InformixDialect

Informix 9.40

NHibernate.Dialect.InformixDialect0940

Informix 10.00

NHibernate.Dialect.InformixDialect1000

Ingres

NHibernate.Dialect.IngresDialect

Ingres 9

NHibernate.Dialect.Ingres9Dialect

Microsoft SQL Server 7

NHibernate.Dialect.MsSql7Dialect

Microsoft SQL Server 2000

NHibernate.Dialect.MsSql2000Dialect

Microsoft SQL Server 2005

NHibernate.Dialect.MsSql2005Dialect

Microsoft SQL Server 2008

NHibernate.Dialect.MsSql2008Dialect

Microsoft SQL Azure Server 2008

NHibernate.Dialect.MsSqlAzure2008Dialect

Microsoft SQL Server 2012

Hibernate.Dialect.MsSql2012Dialect

Microsoft SQL Server Compact Edition

NHibernate.Dialect.MsSqlCeDialect

Microsoft SQL Server Compact Edition 4.0

NHibernate.Dialect.MsSqlCe40Dialect

MySQL 3 or 4

NHibernate.Dialect.MySQLDialect

MySQL 5

NHibernate.Dialect.MySQL5Dialect

MySQL 5 InnoDB

NHibernate.Dialect.MySQL5InnoDBDialect

MySQL 5.5

NHibernate.Dialect.MySQL55Dialect

MySQL 5.5 Inno DB

NHibernate.Dialect.MySQL55InnoDBDialect

Oracle

NHibernate.Dialect.Oracle8iDialect

Oracle 9i

NHibernate.Dialect.Oracle9iDialect

Oracle 10g, Oracle 11g

NHibernate.Dialect.Oracle10gDialect

Oracle 12c

NHibernate.Dialect.Oracle12cDialect

PostgreSQL

NHibernate.Dialect.PostgreSQLDialect

PostgreSQL 8.1

NHibernate.Dialect.PostgreSQL81Dialect

支持8.1 的 FOR UPDATE NOWAIT

PostgreSQL 8.2

NHibernate.Dialect.PostgreSQL82Dialect

在DROP TABLE和DROP SEQUENCE 语句中支持 IF EXISTS关键字

PostgreSQL 8.3

NHibernate.Dialect.PostgreSQL83Dialect

支持XML类型

SQLite

NHibernate.Dialect.SQLiteDialect

设置driver_class为NHibernate.Driver.SQLite20Driver

Sybase Adaptive Server Anywhere 9

NHibernate.Dialect.SybaseASA9Dialect

Sybase Adaptive Server Enterprise 15

NHibernate.Dialect.SybaseASE15Dialect

Sybase SQL Anywhere 10

NHibernate.Dialect.SybaseSQLAnywhere10Dialect

Sybase SQL Anywhere 11

NHibernate.Dialect.SybaseSQLAnywhere11Dialect

Sybase SQL Anywhere 12

NHibernate.Dialect.SybaseSQLAnywhere12Dialect

name="propertyName"

column="column_name"

type="typename"

name ：类里的属性名

column：对应数据表的列名

type：数据库中的类型

1.2.3 many-to-one

在Nhibernate中，多对一的配置是在一的一端，表示该类有一个外键导航。

name="PropertyInOne"

class="ManyClass"

column="Column"

name="PropertyInOne"

class="ManyClass"

column="Column"

1.2.4 one-to-one

一对一的关系与多对一的关系比较相似，不同的地方在于一对一需要在双方的映射关系里均要维护，在有外键的表/实体中添加 constrained=“true”。

示例如下：

2. 增删改查

首先，创建一个泛型模板类，并约束泛型为类：

public class Repository where T: class

{

}

添加一个ISession属性，用来后续访问操作，并由构造方法赋值：

public Repository(ISession session)

{

Session = session;

}

public ISession Session { get; }

2.1 新增

现在我们写一下新增方法：

public object Add(T entity)

{

var key= Session.Save(entity);

return key;

}

public void Add(params T[] entities)

{

foreach (var entity in entities)

{

Session.Save(entity);

}

查了下，Save会返回当前持久化对象插入时生成的主键。

2.2 修改

NHibernate的修改与EF类似，也是由ISession监控了修改，不用做过多的操作。

2.3 删除

NHibernate的删除也十分简单，直接通知ISession删除某个持久化对象。

public void Delete(T entity)

{

Session.Delete(entity);

}

public void Delete(params T[] entities)

{

foreach (var entity in entities)

{

Session.Delete(entity);

}

2.4 查询

通常情况下，查询需要结合实际业务来进行开发，当然为了通用，我在这里选择给调用方开放一个查询对象：

public IQueryable IqQueryable()

{

return Session.Query();

}

其中 IQueryable是一个接口，表示这是一个可查询对象，通过Linq可以快捷的查询。

3. 总结

不过在本篇内容完结之前，先补充一个NHibernate的SqlDialect选值：

数据库

Dialect

备注

DB2

NHibernate.Dialect.DB2Dialect

DB2 for iSeries(OS/400)

NHibernate.Dialect.DB2400Dialect

Firebird

NHibernate.Dialect.FirebirdDialect

需要设置driver_class为NHibernate.Driver.FirebirdClientDriver

Informix

NHibernate.Dialect.InformixDialect

Informix 9.40

NHibernate.Dialect.InformixDialect0940

Informix 10.00

NHibernate.Dialect.InformixDialect1000

Ingres

NHibernate.Dialect.IngresDialect

Ingres 9

NHibernate.Dialect.Ingres9Dialect

Microsoft SQL Server 7

NHibernate.Dialect.MsSql7Dialect

Microsoft SQL Server 2000

NHibernate.Dialect.MsSql2000Dialect

Microsoft SQL Server 2005

NHibernate.Dialect.MsSql2005Dialect

Microsoft SQL Server 2008

NHibernate.Dialect.MsSql2008Dialect

Microsoft SQL Azure Server 2008

NHibernate.Dialect.MsSqlAzure2008Dialect

Microsoft SQL Server 2012

Hibernate.Dialect.MsSql2012Dialect

Microsoft SQL Server Compact Edition

NHibernate.Dialect.MsSqlCeDialect

Microsoft SQL Server Compact Edition 4.0

NHibernate.Dialect.MsSqlCe40Dialect

MySQL 3 or 4

NHibernate.Dialect.MySQLDialect

MySQL 5

NHibernate.Dialect.MySQL5Dialect

MySQL 5 InnoDB

NHibernate.Dialect.MySQL5InnoDBDialect

MySQL 5.5

NHibernate.Dialect.MySQL55Dialect

MySQL 5.5 Inno DB

NHibernate.Dialect.MySQL55InnoDBDialect

Oracle

NHibernate.Dialect.Oracle8iDialect

Oracle 9i

NHibernate.Dialect.Oracle9iDialect

Oracle 10g, Oracle 11g

NHibernate.Dialect.Oracle10gDialect

Oracle 12c

NHibernate.Dialect.Oracle12cDialect

PostgreSQL

NHibernate.Dialect.PostgreSQLDialect

PostgreSQL 8.1

NHibernate.Dialect.PostgreSQL81Dialect

支持8.1 的 FOR UPDATE NOWAIT

PostgreSQL 8.2

NHibernate.Dialect.PostgreSQL82Dialect

在DROP TABLE和DROP SEQUENCE 语句中支持 IF EXISTS关键字

PostgreSQL 8.3

NHibernate.Dialect.PostgreSQL83Dialect

支持XML类型

SQLite

NHibernate.Dialect.SQLiteDialect

设置driver_class为NHibernate.Driver.SQLite20Driver

Sybase Adaptive Server Anywhere 9

NHibernate.Dialect.SybaseASA9Dialect

Sybase Adaptive Server Enterprise 15

NHibernate.Dialect.SybaseASE15Dialect

Sybase SQL Anywhere 10

NHibernate.Dialect.SybaseSQLAnywhere10Dialect

Sybase SQL Anywhere 11

NHibernate.Dialect.SybaseSQLAnywhere11Dialect

Sybase SQL Anywhere 12

NHibernate.Dialect.SybaseSQLAnywhere12Dialect

在数字化转型中，选择合适的跨平台开发框架不仅能提高效率，还有助于确保数据安全与合规性。

1223 2022-09-17

C# 数据操作系列 - 12 NHibernate的增删改查（重生之门）

洞察掌握android电视app开发中的安全与合规策略，提升企业运营效率

在数字化转型中，选择合适的跨平台开发框架不仅能提高效率，还有助于确保数据安全与合规性。

在数字化转型浪潮中，企业如何通过跨端开发框架提升运营效率，兼顾合规性与数据安全？

最近发表

更多内容

小程序SDK

Finclip技术文档

小程序开发

小程序容器

小程序框架

Finclip小程序平台

Finclip用户投稿

车联网

推荐文章

小程序SDK是什么意思？小程序sdk和插件有什么区别？

小程序支付功能怎么实现？

企业app开发流程是什么？

app运营模式有哪些？

小程序多端引流怎么做？

小程序生态分析的机会和威胁

Flutter入门这一篇效率文章就够了

原生与跨平台解决方案分析,跨平台软件开发技术方案

热更新技术：让软件更新变得更加轻松快速

解决方案

银行解决方案

证券解决方案

互联网解决方案

政企OA解决方案

科技解决方案

loT解决方案

信任解决方案

热评文章

AppCan:基于混合模式的移动应用开发,移动混合模

Hybrid App混合模式开发的了解

小程序容器技术助力券商数字营销突围，小程序容器化的意

用mpvue开发微信小程序基础知识（vue.js开发

小程序多端框架全面测评对比，强烈推荐！

券商app架构 - 解析券商应用程序的构建与设计