前言
Nhibernate 來(lái)源于非常優(yōu)秀的基于Java的Hibernate 關(guān)系型持久化工具。NHibernate 最近發(fā)布了 5.1.3 版本， 支持 .NET Standard 2.0 ， 這意味著可以在 .NET Core 2.0 應(yīng)用中使用， 本文就已 WebAPI 應(yīng)用為例， 介紹一下如何在 .NET Core 應(yīng)用中如何使用 NHibernate 。下面話不多說(shuō)了，來(lái)一起看看詳細(xì)的介紹的吧
使用方法如下：
1、 新建一個(gè)基于 .NET Core 的 Web API應(yīng)用， 命令如下：
mkir WebApiTest cd WebApiTest/ dotnet new webapi
2、 添加 NHibernate 包以及對(duì)應(yīng)的數(shù)據(jù)庫(kù)驅(qū)動(dòng)程序（以 Npgsql 為例）：
dotnet add pakcage NHibernate dotnet add package NHibernate.NetCore dotnet add package Npgsql
現(xiàn)在打開(kāi)項(xiàng)目文件 WebApiTest.csproj ， 可以看到已經(jīng)添加了這些包：
<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、 在項(xiàng)目中新建一個(gè) Models 目錄， 并創(chuàng)建實(shí)體類(lèi)以及對(duì)應(yīng)的 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; }
}
}對(duì)應(yīng)的 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 的常規(guī)做法， 因此不做過(guò)多介紹， 不熟悉的可以查閱 NHIbernate 的相關(guān)文檔。
4、 將 xml 文件編譯為嵌入的資源， 打開(kāi)項(xiàng)目文件 WebApiTest.csproj ， 添加一個(gè) ItemGroup 節(jié)點(diǎn)：
<ItemGroup> <None Remove="Models/*.hbm.xml" /> <EmbeddedResource Include="Models/*.hbm.xml" /> </ItemGroup>
5、 創(chuàng)建 NHibernate 的配置文件， 并設(shè)置為復(fù)制到輸出目錄：
<?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>
打開(kāi)項(xiàng)目文件， 添加 ItemGroup 節(jié)點(diǎn)， 內(nèi)容如下：
<ItemGroup> <Content Update="hibernate.config"> <CopyToOutputDirectory>Always</CopyToOutputDirectory> </Content> </ItemGroup>
6、 修改 Startup.cs 文件， 將 NHibernate 集成到 .NET Core 內(nèi)置的依賴(lài)注入框架中：
6.1、 修改 Startup.cs 的 using 部分， 添加下面的語(yǔ)句：
using Microsoft.Extensions.Logging; using NHibernate.NetCore;
6.2、 修改 Startup.cs 的構(gòu)造函數(shù)， 代碼如下：
public Startup(
IConfiguration configuration,
ILoggerFactory factory
) {
Configuration = configuration;
// 將內(nèi)置的日志組件設(shè)置為 NHibernate 的日志組件
factory.UseAsHibernateLoggerFactory();
}6.3、 修改 ConfigureServices 方法， 添加 NHibernate 相關(guān)的服務(wù)：
public void ConfigureServices(IServiceCollection services) {
// nhibernate 配置文件的路徑
var path = System.IO.Path.Combine(
AppDomain.CurrentDomain.BaseDirectory,
"hibernate.config"
);
// 添加 NHibernate 相關(guān)的服務(wù)
services.AddHibernate(path);
services.AddMvc()
.SetCompatibilityVersion(CompatibilityVersion.Version_2_1);
}7、 修改默認(rèn)的 ValuesController.cs ， 注入并使用 NHibernate：
7.1、 修改構(gòu)造函數(shù)， 注入 ISessionFactory ：
public ValuesController(ISessionFactory factory) {
this.factory = factory;
}7.2、 修改 Get 方法， 使用 NHibernate 進(jìn)行查詢(xún)：
// GET api/values
[HttpGet]
public ActionResult<IEnumerable<GpsPosition>> Get() {
using (var session = factory.OpenSession()) {
var query = session.Query<GpsPosition>();
return query.ToList();
}
}8、 編譯并運(yùn)行：
dotnet run
之后可以看到類(lèi)似這樣的 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.
看到這些信息， 就表示已經(jīng)可以正常的使用 NHibernate 了。
總結(jié)
聲明：本網(wǎng)頁(yè)內(nèi)容旨在傳播知識(shí)，若有侵權(quán)等問(wèn)題請(qǐng)及時(shí)與本網(wǎng)聯(lián)系，我們將在第一時(shí)間刪除處理。TEL:177 7030 7066 E-MAIL:11247931@qq.com
Copyright ? 2019-2024 51dongshi.com 版權(quán)所有
違法及侵權(quán)請(qǐng)聯(lián)系：TEL:177 7030 7066 E-MAIL:11247931@qq.com 本站由北京市萬(wàn)商天勤律師事務(wù)所王興未律師提供法律服務(wù)
