在 .NET Core 应用中使用 NHibernate
在 .NET Core 应用中使用 NHibernate
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 name="GpsPosition" schema="public" table="gps_position">
<id name="Id" column="id" type="long">
<generator class="sequence">
<param name="sequence">public.gps_position_id_seq</param>
</generator>
</id>
<property name="UserAgent" column="user_agent" type="string" />
<property name="Timestamp" column="timestamp" type="long" />
<property name="Latitude" column="latitude" type="float" />
<property name="Longitude" column="longitude" type="float" />
<property name="Accuracy" column="accuracy" type="float" />
<property name="Altitude" column="altitude" type="float" />
<property name="AltitudeAccuracy" column="altitude_accuracy" type="float" />
<property name="Heading" column="heading" type="float" />
<property name="Speed" column="speed" type="float" />
<property name="Tag" 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 name="connection.connection_string">server=localhost;database=test_db;user id=postgres;password=postgres;</property>
<property name="dialect">NHibernate.Dialect.PostgreSQL83Dialect</property>
<property name="connection.driver_class">NHibernate.Driver.NpgsqlDriver</property>
<property name="show_sql">true</property>
<property name="format_sql">true</property>
<property name="adonet.batch_size">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 相关的服务:
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<IEnumerable<GpsPosition>> Get() {
using (var session = factory.OpenSession()) {
var query = session.Query<GpsPosition>();
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 了。
- nyoj-----127星际之门(一)
- nyoj------20吝啬的国度
- HDUOJ-------2493Timer(数学 2008北京现场赛H题)
- go sync.Mutex 设计思想与演化过程 (一)
- HDUOJ--------A simple stone game(尼姆博弈扩展)(2008北京现场赛A题)
- HDUOJ----2485 Destroying the bus stations(2008北京现场赛A题)
- Go语言实践:从新手入门到上线真实的小型服务所遇到的那些坑
- Node.js真的无所不能?那些不适用的应用领域分析
- hdu-----2491Priest John's Busiest Day(2008 北京现场赛G)
- nyoj------79拦截导弹
- HDUOJ-------2719The Seven Percent Solution
- Golang记录、计算函数执行耗时、运行时间的一个简单方法
- uva----11729 Commando war (突击战争)
- uva-----11292 The Dragon of Loowater
- JavaScript 教程
- JavaScript 编辑工具
- JavaScript 与HTML
- JavaScript 与Java
- JavaScript 数据结构
- JavaScript 基本数据类型
- JavaScript 特殊数据类型
- JavaScript 运算符
- JavaScript typeof 运算符
- JavaScript 表达式
- JavaScript 类型转换
- JavaScript 基本语法
- JavaScript 注释
- Javascript 基本处理流程
- Javascript 选择结构
- Javascript if 语句
- Javascript if 语句的嵌套
- Javascript switch 语句
- Javascript 循环结构
- Javascript 循环结构实例
- Javascript 跳转语句
- Javascript 控制语句总结
- Javascript 函数介绍
- Javascript 函数的定义
- Javascript 函数调用
- Javascript 几种特殊的函数
- JavaScript 内置函数简介
- Javascript eval() 函数
- Javascript isFinite() 函数
- Javascript isNaN() 函数
- parseInt() 与 parseFloat()
- escape() 与 unescape()
- Javascript 字符串介绍
- Javascript length属性
- javascript 字符串函数
- Javascript 日期对象简介
- Javascript 日期对象用途
- Date 对象属性和方法
- Javascript 数组是什么
- Javascript 创建数组
- Javascript 数组赋值与取值
- Javascript 数组属性和方法
- android原生JSON解析实例
- iOS新闻类App内容页技术探索
- Android仿iphone自定义滚动选择器
- Android仿iPhone日期时间选择器详解
- Android 仿余额宝数字跳动动画效果完整代码
- Android中判断listview是否滑动到顶部和底部的实现方法
- Android开发实现的简单媒体播放器功能示例
- Android中的颜色表示的详解
- android使用SoundPool播放音效的方法
- android中Context深入详解
- Android中Notification通知用法详解
- Android build文件的删除的方法
- Android自定义Notification添加点击事件
- 深入理解Android Bitmap
- Android基于AlarmManager实现用户在线心跳功能示例