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 的说明
<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 节点的配置:
<id
name="PropertyName"
type="typename"
column="column_name">
<generator class="generatorClass"/>
</id>
name : 对应的属性名
type:对应的NHibernate类型
column:列名
generator:主键生成器,如果不需要参数可以直接在 id节点处添加,最常用的是native。
1.2.2 property
映射一个普通属性就简单多了,只需要进行以下配置即可:
<property
name="propertyName"
column="column_name"
type="typename"
/>
name :类里的属性名
column:对应数据表的列名
type:数据库中的类型
1.2.3 many-to-one
在Nhibernate中,多对一的配置是在一的一端,表示该类有一个外键导航。
<many-to-one
name="PropertyInOne"
class="ManyClass"
column="Column"
></many-to-one>
1.2.4 one-to-one
一对一的关系与多对一的关系比较相似,不同的地方在于一对一需要在双方的映射关系里均要维护,在有外键的表/实体中 添加 constrained=“true”。
示例如下:
<one-to-one name="Person" class="Person"/>
<one-to-one name="Employee" class="Employee" constrained="true"/>
2. 增删改查
Nhibernate的每次操作都基于一个Session,所以我们在操作数据库的时候最好先持有一个可用的Session。接下来,我们就一个通用数据库操作类为基础,向大家分享一下我的想法。
首先,创建一个泛型模板类,并约束泛型为类:
public class Repository<T> 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<T> IqQueryable()
{
return Session.Query<T>();
}
其中 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 |