如何在.NET Core應用中使用NHibernate詳解
前言
Nhibernate 來源于非常優(yōu)秀的基于Java的Hibernate 關系型持久化工具。NHibernate 最近發(fā)布了 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 包以及對應的數(shù)據(jù)庫驅動程序(以 Npgsql 為例):
dotnet add pakcage NHibernate dotnet add package NHibernate.NetCore dotnet add package Npgsql
現(xiàn)在打開項目文件 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、 在項目中新建一個 Models 目錄, 并創(chuà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; } } }
對應的 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ī)做法, 因此不做過多介紹, 不熟悉的可以查閱 NHIbernate 的相關文檔。
4、 將 xml 文件編譯為嵌入的資源, 打開項目文件 WebApiTest.csproj , 添加一個 ItemGroup 節(jié)點:
<ItemGroup> <None Remove="Models/*.hbm.xml" /> <EmbeddedResource Include="Models/*.hbm.xml" /> </ItemGroup>
5、 創(chuàng)建 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 節(jié)點, 內容如下:
<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 的構造函數(shù), 代碼如下:
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、 修改構造函數(shù), 注入 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.
看到這些信息, 就表示已經(jīng)可以正常的使用 NHibernate 了。
總結
以上就是這篇文章的全部內容了,希望本文的內容對大家的學習或者工作具有一定的參考學習價值,如果有疑問大家可以留言交流,謝謝大家對腳本之家的支持。
- Hibernate中Session.get()方法和load()方法的詳細比較
- Hibernate用ThreadLocal模式(線程局部變量模式)管理Session
- hibernate測試時遇到的幾個異常及解決方法匯總
- Hibernate中使用HQLQuery查詢全部數(shù)據(jù)和部分數(shù)據(jù)的方法實例
- Hibernate實現(xiàn)many-to-many的映射關系
- Hibernate一級緩存和二級緩存詳解
- SpringBoot 使用hibernate validator校驗
- Hibernate之CRUD操作實踐
- Springboot+hibernate實現(xiàn)簡單的增刪改查示例
- Hibernate的各種保存方式的區(qū)別詳解
相關文章
asp.net使用ODP即oracle連接方式的的防注入登錄驗證程序
這篇文章主要介紹了asp.net使用ODP即oracle連接方式的的防注入登錄驗證程序,需要的朋友可以參考下2014-05-05ASP.NET在IIS上注冊報0x800702e4錯誤解決方法
報一個0x800702e4 請求的操作需要提升的錯誤。解決的方法和前面大同小異,給這個aspnet_regiis.exe創(chuàng)建一個快捷方式,給它的目標后面加上 一個-i,再右擊這個快捷方式,以管理員身份運行,就行了2012-08-08ASP.NET對路徑"xxxxx"的訪問被拒絕的解決方法小結
異常詳細信息: System.UnauthorizedAccessException: 對路徑“D:/temp1/MyTest.txt”的訪問被拒絕2012-09-09VS2015自帶LocalDB數(shù)據(jù)庫用法詳解
這篇文章主要為大家詳細介紹了VS2015自帶LocalDB數(shù)據(jù)庫的用法,具有一定的參考價值,感興趣的小伙伴們可以參考一下2017-06-06微軟官方SqlHelper類 數(shù)據(jù)庫輔助操作類
本文主要介紹微軟官方的數(shù)據(jù)庫操作類極其使用方法,幫助大家利用已經(jīng)非常成熟的類庫來進行快速開發(fā)。2016-03-03基于.net standard 的動態(tài)編譯實現(xiàn)代碼
這篇文章主要介紹了基于.net standard 的動態(tài)編譯實現(xiàn)代碼,非常不錯,具有一定的參考借鑒價值,需要的朋友可以參考下2018-07-07asp.net讀取excel中的數(shù)據(jù)并綁定在gridview
這篇文章主要介紹了asp.net讀取excel中的數(shù)據(jù)并綁定在gridview上的方法,需要的朋友可以參考下2014-02-02SQL Server數(shù)據(jù)庫連接 Web.config如何配置
以下的文章主要描述的是Web.config正確配置SQL Server數(shù)據(jù)庫連接的實際擦步驟。我們以圖文結合的方式對其有個更好的說明,需要的朋友可以參考下2015-10-10