Nhibernate 来源于非常优秀的基于Java的Hibernate 关系型持久化工具。NHibernate 最近发布了 5.1.3 版本， 支持 .NET Standard 2.0 ， 这意味着可以在 .NET Core 2.0 应用中使用， 本文就已 WebAPI 应用为例， 介绍一下如何在 .NET Core 应用中如何使用 NHibernate 。下面话不多说了，来一起看看详细的介绍的吧
使用方法如下：
1、 新建一个基于 .NET Core 的 Web API应用， 命令如下：
mkir WebApiTest cd WebApiTest/ dotnet new webapi
2、 添加 NHibernate 包以及对应的数据库驱动程序（以 Npgsql 为例）：
dotnet add pakcage NHibernate dotnet add package NHibernate.NetCore dotnet add package Npgsql
现在打开项目文件 WebApiTest.csproj ， 可以看到已经添加了这些包：
<ItemGroup> <PackageReference Include="Microsoft.AspNetCore.App" /> <PackageReference Include="NHibernate" Version="5.1.3" /> <PackageReference Include="NHibernate.NetCore" Version="1.0.1" /> <PackageReference Include="NpgSql" Version="4.0.2" /> </ItemGroup>
3、 在项目中新建一个 Models 目录， 并创建实体类以及对应的 xml 映射文件， 代码如下：
namespace WebApiTest.Models { public class GpsPosition { public virtual long Id { get; set; } public virtual string UserAgent { get; set;} public virtual long? Timestamp { get; set; } public virtual float? Latitude { get; set; } public virtual float? Longitude { get; set; } public virtual float? Accuracy { get; set; } public virtual float? Altitude { get; set; } public virtual float? AltitudeAccuracy { get; set; } public virtual float? Heading { get; set; } public virtual float? Speed { get; set; } public virtual string Tag { get; set; } } }
对应的 xml 映射文件如下：
<?xml version="1.0" encoding="utf-8"?> <hibernate-mapping xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="urn:nhibernate-mapping-2.2" namespace="WebApiTest.Models" assembly="WebApiTest"> <class schema="public" table="gps_position"> <id column="id" type="long"> <generator> <param>public.gps_position_id_seq</param> </generator> </id> <property column="user_agent" type="string" /> <property column="timestamp" type="long" /> <property column="latitude" type="float" /> <property column="longitude" type="float" /> <property column="accuracy" type="float" /> <property column="altitude" type="float" /> <property column="altitude_accuracy" type="float" /> <property column="heading" type="float" /> <property column="speed" type="float" /> <property column="tag" type="string" /> </class> </hibernate-mapping>
这些都是 NHibernate 的常规做法， 因此不做过多介绍， 不熟悉的可以查阅 NHIbernate 的相关文档。
4、 将 xml 文件编译为嵌入的资源， 打开项目文件 WebApiTest.csproj ， 添加一个 ItemGroup 节点：
<ItemGroup> <None Remove="Models/*.hbm.xml" /> <EmbeddedResource Include="Models/*.hbm.xml" /> </ItemGroup>
5、 创建 NHibernate 的配置文件， 并设置为复制到输出目录：
<?xml version="1.0" encoding="UTF-8"?> <hibernate-configuration xmlns="urn:nhibernate-configuration-2.2"> <session-factory> <property>server=localhost;database=test_db;user id=postgres;password=postgres;</property> <property>NHibernate.Dialect.PostgreSQL83Dialect</property> <property>NHibernate.Driver.NpgsqlDriver</property> <property>true</property> <property>true</property> <property>10</property> <mapping assembly="NaturalReserveApi" /> </session-factory> </hibernate-configuration>
打开项目文件， 添加 ItemGroup 节点， 内容如下：
<ItemGroup> <Content Update="hibernate.config"> <CopyToOutputDirectory>Always</CopyToOutputDirectory> </Content> </ItemGroup>
6、 修改 Startup.cs 文件， 将 NHibernate 集成到 .NET Core 内置的依赖注入框架中：
6.1、 修改 Startup.cs 的 using 部分， 添加下面的语句：
using Microsoft.Extensions.Logging; using NHibernate.NetCore;
6.2、 修改 Startup.cs 的构造函数， 代码如下：
public Startup( IConfiguration configuration, ILoggerFactory factory ) { Configuration = configuration; // 将内置的日志组件设置为 NHibernate 的日志组件 factory.UseAsHibernateLoggerFactory(); }
6.3、 修改 ConfigureServices 方法， 添加 NHibernate 相关的服务：