NHibernate configuration 标签

  • 一句话的事儿:与数据库的数据交互

0. 前言

在上一篇基本讲完了EF Core的入门级教程。从这一篇开始,我们试着去探索一下 .net core平台上更多的ORM框架。那么,这一篇开始我们就来试试NHibernate。

1. NHibernate 介绍

NHibernate是Hibernate的C#版,众所周知Hibernate是Java 里ORM的顶梁柱(至少曾经)。Hibernate可以说开拓了Java的世界,当年SSH三驾马车风靡世界,至今Hibernate都发挥着举足轻重的作用。
不过,与EntityFramework不同的地方是,Hibernate以配置文件为主,通过配置文件规范使用,Object/Relation 映射。而NHibernate这继承了这一点,也是以配置文件优先。下图是 NHibernate的工作原理:
C# 数据操作系列 - 10 NHibernate初试 - 图1
通过读取App.config或者Web.config文件去读NHibernate的基本配置,然后加载映射文件,建立映射关系。在后续使用中,通过映射关系生成SQL语句(这一步跟EF是一致的),进而操作数据或者查询数据。

2. 初探 NHibernate

2.1 准备

先来个控制台项目,我起名为dataprovider。然后安装NHibernate:

  1. NuGet:

    1. Install-Package NHibernate
  2. dotnet core 命令行:

    1. dotnet add package NHibernate

    这个文章中使用的NHibernate版本是 5.2.7

    2.2 配置

    需要创建一个项目用的配置文件:App.config.
    C# 项目中,除了Web类型的项目,每个项目的主配置文件的名称都是App.config,这是一个固定名称。
    文件内容如下:

    1. <?xml version="1.0" encoding="utf-8" ?>
    2. <configuration>
    3. </configuration>

    在 configuration节点之间添加以下内容:

    1. <configSections>
    2. <section name="hibernate-configuration" type="NHibernate.Cfg.ConfigurationSectionHandler, NHibernate"/>
    3. </configSections>

    这段代码的含义是,在config文件中添加一个 hibernate-configuration结点,结点的解析由类:NHibernate.Cfg.ConfigurationSectionHandler,所在包是NHibernate。
    在App.config文件configuration结点中添加以下代码:

    1. <hibernate-configuration xmlns="urn:nhibernate-configuration-2.2">
    2. <session-factory>
    3. <property name="dialect">NHibernate.Dialect.MsSql2012Dialect</property>
    4. <property name="connection.connection_string">
    5. Data Source=.;Initial Catalog=Demo;Integrated Security=True
    6. </property>
    7. <property name="hbm2ddl.auto">create-drop</property>
    8. <mapping assembly="dataprovider" />
    9. </session-factory>
    10. </hibernate-configuration>

    这是固定格式,其中dialect表示使用的数据库类型,connection.connection_string 表示连接字符串。mapping表示映射关系文件所在项目。

    2.3 获取ISessionFactory

    然后获取一个ISessionFactory:

    1. Configuration cfg = new Configuration();
    2. var sessionFactory = cfg.BuildSessionFactory();

    当然,如果直接运行代码的话,会在 BuildSessionFactory这里报错。因为没有为SQL Server安装数据访问驱动:

    1. System.Data.SqlClient

    将数据访问驱动安装成功后,运行可以获得sessionFactory。

    sessionFactory用来创建一个访问数据库的Session

2.4 增删改查

先来个简单的示例类:

  1. public class Cat
  2. {
  3. public virtual string Id { get; set; }
  4. public virtual string Name { get; set; }
  5. public virtual char Sex { get; set; }
  6. public virtual float Weight { get; set; }
  7. }

NHibernate的映射关系文件:Cat.hbm.xml

  1. <?xml version="1.0" encoding="utf-8" ?>
  2. <hibernate-mapping xmlns="urn:nhibernate-mapping-2.2" namespace="dataprovider" assembly="dataprovider">
  3. <class name="Cat" table="Cat">
  4. <!-- A 32 hex character is our surrogate key. It's automatically
  5. generated by NHibernate with the UUID pattern. -->
  6. <id name="Id">
  7. <column name="CatId" sql-type="char(32)" not-null="true"/>
  8. <generator class="uuid.hex" />
  9. </id>
  10. <!-- A cat has to have a name, but it shouldn't be too long. -->
  11. <property name="Name">
  12. <column name="Name" length="16" not-null="true" />
  13. </property>
  14. <property name="Sex" />
  15. <property name="Weight" />
  16. </class>
  17. </hibernate-mapping>

创建完成后,右键选中文件,修改文件生成操作为嵌套的资源
C# 数据操作系列 - 10 NHibernate初试 - 图2
然后编写实例代码:

  1. Configuration cfg = new Configuration().Configure();
  2. using (var sessionFactory = cfg.BuildSessionFactory())
  3. using (var session = sessionFactory.OpenSession())
  4. {
  5. // 通过session操作
  6. session.Close();
  7. }

新增一个Cat:

  1. var princess = new Cat
  2. {
  3. Name = "Princess",
  4. Sex = 'F',
  5. Weight = 7.4f
  6. };
  7. session.Save(princess);
  8. session.Flush();//推送修改给数据库,不调用的话数据库里将没有数据

查询并修改:

  1. var cats = session.Query<Cat>().ToList();
  2. var cat = cats.First();
  3. cat.Name = "xiao li";
  4. session.Update(cat);
  5. session.Flush();

查询并删除:

  1. var cats = session.Query<Cat>().ToList();
  2. var cat = cats.First();
  3. session.Delete(cat);
  4. session.Flush();

这是NHibernate的入门级的入门教程。嗯,给大家一个NHibernate的图:
C# 数据操作系列 - 10 NHibernate初试 - 图3

3. 总结

NHibernate延续了Hibernate的优点,如果之前了解过Hibernate的人上手不难。轻量简单,不过得需要配置文件。下一期将带领大家继续深入研究NHibernate。


  • 本文作者:GeekPower - Felix Sun
  • 版权声明: 本博客所有文章除特别声明外,均采用 MIT 许可协议。转载请注明出处!