.NET ORM框架HiSql實戰-第一章-集成HiSql

一、引言

做.Net這麼多年，出現了很多很多ORM框架，比如Dapper,Sqlsugar,Freesql等等。在之前的項目中，用到的ORM框架也大多數是這幾個老牌的框架。
不過最近園子關於.NET ORM HiSql的討論挺多的，本系列將通過不斷學習 HiSql官網教程，嘗試將之前使用SqlSuger ORM的一個項目，使用HiSql框架實現相關功能，看看hisql能帶給我們哪些驚喜。
c# 國內外ORM 框架 dapper efcore sqlsugar freesql hisql sqlserver數據常規插入測試性能對比對比

HiSql GitGub地址
HiSql官網教程
項目介紹：項目是一個通用的後臺管理系統，包含菜單管理、許可權管理、組織架構、用戶管理等等。
資料庫採用SqlServer 2016；前端使用Element-UI;後端採用.Net5 Web Api。

二、集成HiSql到項目

1. 安裝 HiSql 核心包、 HiSql.SqlServer。
   

2、在項目中新建類文件 HiSqlSetupExtension.cs, 用於註入資料庫配置，hisql資料庫訪問對象。

using HiSql;
using Microsoft.Extensions.Configuration;
using Microsoft.Extensions.DependencyInjection;
using System;

namespace H.CRM.Action.API.Helper
{

    public static class HiSqlSetupExtension
    {
        public static IServiceCollection AddHiSqlSetup(this IServiceCollection services)
        {
            //註入HiSqlConfig
            services.AddTransient<HiSqlConfig>();
            //註入HiSqlClient
            services.AddTransient<HiSqlClient>((d) =>
            {
                var config = d.GetService<HiSqlConfig>();
                var hisql = new HiSqlClient(config);
                return hisql;
            });
            return services;
        }
    }

    class HiSqlConfig : ConnectionConfig
    {
        static readonly NLog.Logger logger = NLog.LogManager.GetLogger("HiSqlSetup");
        public HiSqlConfig(IConfiguration configuration)
        {
            DbType = DBType.SqlServer;
            DbServer = "HISQL";
            ConnectionString = configuration.GetSection("ConnectionStrings:Admin").Value;
            Schema = "dbo";
            SqlExecTimeOut = 1000 * 5;
            AppEvents = new AopEvent()
            {
                OnDbDecryptEvent = (connstr) =>
                {
                    //解密連接欄位
                    return connstr;
                },
                OnLogSqlExecuting = (sql, param) =>
                {
                    //sql執行前 日誌記錄 (非同步)
#if DEBUG
                    logger.Trace($"執行前sql:{sql} time:{DateTime.Now.ToString("yyyy-MM-dd HH:mm:ss ffff")}");
#endif
                },
                OnLogSqlExecuted = (sql, param) =>
                {
#if DEBUG
                    //sql執行後 日誌記錄 (非同步)
                    logger.Trace($"執行後sql：{sql} time:{DateTime.Now.ToString("yyyy-MM-dd HH:mm:ss ffff")}");
#endif
                },
                OnSqlError = (sqlEx) =>
                {
                    //sql執行錯誤後 日誌記錄 (非同步)
                    logger.Error($"執行錯誤：{sqlEx.Message} sql:{sqlEx.Sql} time:{DateTime.Now.ToString("yyyy-MM-dd HH:mm:ss ffff")}");
                },
                OnTimeOut = (int timer) =>
                {
                    //logger.Trace($"執行超時：{timer} time:{DateTime.Now.ToString("yyyy-MM-dd HH:mm:ss ffff")}");
                }
            };
        }
    }

}

3、在 Startup 中的ConfigureServices方法中，添加 hisql的使用。

//註入Hisql相關
            services.AddHiSqlSetup();

4、新建 控制器 HiSqlController，添加初始化方法。

  using Microsoft.AspNetCore.Mvc;
using HiSql;
using System.Linq;

namespace HSMB.Admin.WebApi.Controllers
{
    [Route("api/[controller]/[action]")]
    [ApiController]
    public class HiSqlController : ControllerBase
    {
        private readonly HiSqlClient sqlClient;
       
        public HiSqlController(         
             HiSqlClient hiSqlClient
            )
        {
            this.sqlClient = hiSqlClient;
        }
        [HttpGet, HttpPost]
        public IActionResult Install()
        {
            sqlClient.CodeFirst.InstallHisql();
            var tables = sqlClient.DbFirst.GetTables().ToList().Where(t=>t.TabName.StartsWith("H"));
            return new JsonResult(tables);
        }
    }
}

5、啟動項目後，訪問 項目地址 http://localhost:8868/api/hisql/Install 初始化hisql。
如圖表示初始化成功，同時在資料庫也可以看到，系統創建了下圖的4個基礎表：

1.Hi_TabModel #表結構信息主表
2.Hi_FieldModel #表結構信息明細表
3.Hi_Domain #數據域
4.Hi_DataElement #數據元素

到此，項目就完成了HiSql的引入了，後面就可以愉快的使用HiSql各個功能。