Hikari 2.9.4

There is a newer version of this package available.
See the version list below for details.
dotnet add package Hikari --version 2.9.4                
NuGet\Install-Package Hikari -Version 2.9.4                
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Hikari" Version="2.9.4" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Hikari --version 2.9.4                
#r "nuget: Hikari, 2.9.4"                
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install Hikari as a Cake Addin
#addin nuget:?package=Hikari&version=2.9.4

// Install Hikari as a Cake Tool
#tool nuget:?package=Hikari&version=2.9.4                

HiKari使用说明

郑重说明:本库HiKari定位于数据库连接池,源码GitHub开源公开,欢迎大家修改提交

程序初始化

使用配置类

      HikariConfig hikariConfig = new HikariConfig();
                   hikariConfig.DBType = "PostgreSQL";
                   hikariConfig.ConnectString = "Server = 127.0.0.1; Port = 5432; User Id = postgres; Password = 1234; Database = postgres;Pooling=true; ";
                   hikariConfig.DriverDir = "DBDrivers";
                   hikariConfig.DriverDLL = "XXXX.dll";
                   hikariConfig.DBTypeXml = "DBType.xml";
      HikariDataSource hikariDataSource = new HikariDataSource(hikariConfig);

配置文件(推荐方式,配置字段就是HikariConfig的属性):

HikariConfig hikariConfig = new HikariConfig();
hikariConfig.LoadConfig("Hikari.txt");
HikariDataSource hikariDataSource = new HikariDataSource(hikariConfig);

使用连接 hikariDataSource.GetConnection();
使用批量处理接口 var bulk= hikariDataSource.GetBulkCopy();
说明:数据库提供的专门用于批量插入的类需要底层客户端驱动提供,所以增加了接口,满足调用这些类处理批量插入

使用多库管理类
例如:配置文件MySql_HiKari.cfg
ManagerPool.Singleton.GetDbConnection(MySql);
ManagerPool.Singleton.GetBulkCopy(MySql);

操作数据库

            string sql = "select * from  person where id=@ID";  
            Dictionary<string, object> dic = new Dictionary<string, object>();  
            dic["ID"] = 1;  
            HikariConfig hikariConfig = new HikariConfig();  
            hikariConfig.DBType = "PostgreSQL";  
            hikariConfig.ConnectString = "Server = 127.0.0.1; Port = 5432; User Id = postgres; Password = 1234; Database = postgres;Pooling=true; ";  
            HikariDataSource hikariDataSource = new HikariDataSource(hikariConfig);  
            var ds = hikariDataSource.ExecuteQuery(sql, dic);  

               Dictionary<string, SqlValue> map = new Dictionary<string, SqlValue>();    
                uint[] tmp = new uint[3] {1,2, 3};
                IPAddress pAddress =  IPAddress.Parse("127.0.0.1");
                map.Add("p", new SqlValue() { Type= "IPAddress", Value= pAddress });
                map.Add("m", new SqlValue() { Type="uint[]", Value=tmp});
                hikariDataSource.ExecuteUpdate("insert into test(temp,kk)values(@p,@m)", map);

            string sql = "select * from  person";  
            var ds = ManagerPool.Singleton.ExecuteQuery(sql);  
            var dt = ds.Tables[0];  
            sql = "insert into person(id,name)values(1,'jinyu')";  
            int r = ManagerPool.Singleton.ExecuteUpdate(sql);   

详细使用可以查看例子

配置文件说明

1.连接字符串必须要
2.驱动目录DriverDir项不配置则使用默认drivers目录
3.关于驱动dll有2种:
(1)直接在配置文件中配置DriverDLL项,这个时候不需要DBType配置项
(2)DBType项和DBType.xml结合使用,这时不需要单独在每个连接配置中配置DriverDLL。
这个时候连接池查找dll的方式:
1>DBType配置是默认的4类,则无需DBType.xml来查找dll文件名称。
2>DBType配置不是默认的4类,则需要BType.xml中的配置来获取DLL文件名称。因为程序不知道dll.
其实这2种就是分散与汇总的区别。有的习惯每个配置文件配置dll,方便监测;有的习惯写在一起,方便管理。看自己情况。
DBType程序中写死了4种,见附录。
DBType.xml我称为全局配置文件,读取时的配置路径和名称可以设置HikariConfig或者HikariDataSource的DBTypeXml属性进行修改;默认就是DBType.xml
4.增加驱动特殊类型配置:
(1)使用ParameterType配置文件路径,ParameterType.xml默认文件。 (2)文件按照数据库配置,节点下面是字段转换说明。例如:npgl驱动中,uint数组对应数据库中oidvector类型。 <Npgsql> <oidvector>uint[]</oidvector> </Npgsql>


源码简说

基本内容

HikariDataSource 对外提供连接
HikariConfig 对外配置
HikariPool 管理操作集合,连接来源
PoolBase 操作驱动连接,是HikariPool父类


附录

数据库 Dll名称 说明
Oracle Oracle.ManagedDataAccess 以前不是这个dll
MySql MySql.Data
SqlServer System
PostgreSQL Npgsql
Product Compatible and additional computed target framework versions.
.NET net7.0 is compatible.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (1)

Showing the top 1 NuGet packages that depend on Hikari:

Package Downloads
HikariAPI

提供Hikari实现ORM;完善配置文件方式,各类参数执行,支持匿名类使用;扩展字符串类实现直接SQL参数化语句使用方法调用,SQLParameterExtension类

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
3.0.2 274 1/14/2024
3.0.1 110 1/14/2024
3.0.0 115 1/14/2024
2.9.9 177 9/25/2023
2.9.8 152 9/24/2023
2.9.7 151 9/23/2023
2.9.6 144 9/20/2023
2.9.5 183 6/23/2023
2.9.4 186 6/22/2023
2.9.3 166 6/20/2023
2.9.2 190 5/15/2023
2.9.1 171 5/13/2023
2.9.0 212 4/22/2023
2.8.7 481 10/2/2021
2.8.6 372 10/2/2021
2.8.5 1,334 5/12/2019
2.8.4 673 5/12/2019
2.8.3 731 4/11/2019
2.8.2 707 4/5/2019
2.8.1 718 4/1/2019
2.8.0 766 3/31/2019
2.7.5 738 3/30/2019
2.7.4 740 3/30/2019
2.7.3 782 2/24/2019
2.7.2 744 2/21/2019
2.7.1 821 2/15/2019
2.7.0 837 2/15/2019
2.6.3 1,043 1/27/2019
2.6.2 1,062 1/26/2019
2.6.1 1,034 1/26/2019
2.6.0 1,073 1/26/2019
2.5.0 834 1/26/2019
2.3.0 1,044 1/26/2019
2.2.0 857 1/24/2019
2.1.0 826 1/23/2019
2.0.0 862 1/4/2019
1.3.0 916 1/4/2019

增加存储过程调用,修改日志框架Microsoft.Extensions.Logging