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.DB2DialectDB2 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