如何在.NET Core应用中使用NHibernate详解

前言

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 , 可以看到已经添加了这些包:

 
 
 
 
 
 

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 映射文件如下:



 
 
 
 public.gps_position_id_seq
 
 
 
 
 
 
 
 
 
 
 
 
 

这些都是 NHibernate 的常规做法, 因此不做过多介绍, 不熟悉的可以查阅 NHIbernate 的相关文档。

4、 将 xml 文件编译为嵌入的资源, 打开项目文件 WebApiTest.csproj , 添加一个 ItemGroup 节点:


 
 

5、 创建 NHibernate 的配置文件, 并设置为复制到输出目录:



 
 server=localhost;database=test_db;user id=postgres;password=postgres;
 NHibernate.Dialect.PostgreSQL83Dialect
 NHibernate.Driver.NpgsqlDriver
 true
 true
 10
 
 

打开项目文件, 添加 ItemGroup 节点, 内容如下:


 
 Always
 

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 相关的服务:

public void ConfigureServices(IServiceCollection services) {
 // nhibernate 配置文件的路径
 var path = System.IO.Path.Combine(
  AppDomain.CurrentDomain.BaseDirectory,
  "hibernate.config"
 );
 // 添加 NHibernate 相关的服务
 services.AddHibernate(path);
 services.AddMvc()
  .SetCompatibilityVersion(CompatibilityVersion.Version_2_1);
}

7、 修改默认的 ValuesController.cs , 注入并使用 NHibernate:

7.1、 修改构造函数, 注入 ISessionFactory :

public ValuesController(ISessionFactory factory) {
 this.factory = factory;
}

7.2、 修改 Get 方法, 使用 NHibernate 进行查询:

// GET api/values
[HttpGet]
public ActionResult> Get() {
 using (var session = factory.OpenSession()) {
  var query = session.Query();
  return query.ToList();
 }
}

8、 编译并运行:

dotnet run

之后可以看到类似这样的 NHibernate 初始化信息:

Using launch settings from ~/Projects/WebApiTest/Properties/launchSettings.json...
info: NHibernate.Cfg.Environment[0]
  NHibernate 5.1.3 (assembly 5.1.0.0)
info: NHibernate.Cfg.Environment[0]
  hibernate-configuration section not found in application configuration file
info: NHibernate.Cfg.Environment[0]
  Bytecode provider name : lcg
info: NHibernate.Cfg.Environment[0]
  Using reflection optimizer
dbug: NHibernate.Cfg.Configuration[0]
......
Hosting environment: Development
Content root path: ~/Projects/WebApiTest
Now listening on: https://localhost:5001
Now listening on: http://localhost:5000
Application started. Press Ctrl+C to shut down.

看到这些信息, 就表示已经可以正常的使用 NHibernate 了。

总结

以上就是这篇文章的全部内容了,希望本文的内容对大家的学习或者工作具有一定的参考学习价值,如果有疑问大家可以留言交流,谢谢大家对脚本之家的支持。

你可能感兴趣的:(如何在.NET Core应用中使用NHibernate详解)