Hikari 1.3.0
See the version list below for details.
dotnet add package Hikari --version 1.3.0
NuGet\Install-Package Hikari -Version 1.3.0
<PackageReference Include="Hikari" Version="1.3.0" />
paket add Hikari --version 1.3.0
#r "nuget: Hikari, 1.3.0"
// Install Hikari as a Cake Addin #addin nuget:?package=Hikari&version=1.3.0 // Install Hikari as a Cake Tool #tool nuget:?package=Hikari&version=1.3.0
HiKari使用说明
程序初始化
使用配置类
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);
直接使用:
HikariDataSource hikariDataSource = new HikariDataSource();
hikariDataSource.DBType = "PostgreSQL";
hikariDataSource.ConnectString = "Server = 127.0.0.1; Port = 5432; User Id = postgres; Password = 1234; Database = postgres;Pooling=true; ";
hikariDataSource.DriverDir = "DBDrivers";
hikariDataSource.DriverDLL = "XXXX.dll";
hikariDataSource.DBTypeXml = "DBType.xml";
配置文件(推荐方式):
HikariConfig hikariConfig = new HikariConfig();
hikariConfig.LoadConfig("Hikari.txt");
HikariDataSource hikariDataSource = new HikariDataSource(hikariConfig);
使用连接 hikariDataSource.GetConnection();
配置文件说明
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
升级内容
2018-12-13
1.优化加载,对全局配置文件DBType.xml和默认项进行检查,已经加载过的就不加载了。
2.新增连接池管理。可以同时启用多个连接池。连接池使用和以前一样。但是可以同时使用多个。根据配置文件名称来获取不同的连接池连接。只是这个时候只能能够使用配置文件,而不能在使用配置类了。
连接池管理类:ManagerPool
ManagerPool获取连接时传入一个名称(配置文件名称)来获取连接,这时不同的配置名称就意味着不同的连接池。
另外该类提供了驱动目录和全局配置设置。方便把多个连接池使用到的所以DLL放在一起方便管理。连接池管理类不会覆盖已经在各个连接池配置文件配置的DriverDir目录,但是DBTypeXml属性会覆盖,只能有个,并且在连接池管理类中设置。
同时提供了使用的连接管理,该管理根据获取连接的线程保存连接对象。如果设置了线程关闭,同一个线程获取新连接,则以前的连接将会关闭。你也可以在获取的连接的线程中再次获取该对象。
2018-12-31
增加SqlServer连接从运行时环境中加载。因为sqlserver的驱动连接包含在.NET类库中(System.Data.dll),所以加载了一次运行时环境。
如果你没有提供该dll在驱动目录中,根据DBType或者dll名称判断是SqlServer连接,则会去查找一次.NET按照目录获取客户端驱动。
连接池管理类:连接池管理中的配置文件名称进行了修改。除非是默认枚举名称Hikari没有变,如果你使用了名称,则会自动添加_Hikari。文件类型变成了cfg。例如:使用MySql,那么配置文件应该是MySql_Hikari.cfg.添加后缀的主要原因是其它一些数据库配置组件也使用配置文件,能够全部放在一个目录下。毕竟使用连接池管理,配置文件需要一定规律查找。如果不愿意只需改变管理类中的文件名称查找,很简单。
连接池管理管理类使用:
例如:配置文件MySql_HiKari.cfg
ManagerPool.Instance.GetDbConnection(MySql);
源码简说
基本内容
HikariDataSource 对外提供连接
HikariConfig 对外配置
HikariPool 管理操作集合,连接来源
PoolBase 操作驱动连接,是HikariPool父类
新增扩展内容
2018-12-13
ManagerPool 线程池管理类,根据名称提供多线程连接
2018-12-32
增加SqlServer连接从运行时环境中加载。因为sqlserver的驱动连接包含在.NET类库中,所以加载了一次运行时环境。
如果你使用没有提供。根据DBType或者dll名称判断是SqlServer连接,则会去查找一次.NET按照目录获取客户端驱动。
附录
数据库 | Dll名称 | 说明 |
---|---|---|
Oracle | Oracle.ManagedDataAccess | 以前不是这个dll |
MySql | MySql.Data | |
SqlServer | System | |
PostgreSQL | Npgsql |
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net5.0 was computed. net5.0-windows was computed. net6.0 was computed. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. 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. |
.NET Core | netcoreapp2.0 was computed. netcoreapp2.1 was computed. netcoreapp2.2 was computed. netcoreapp3.0 was computed. netcoreapp3.1 was computed. |
.NET Standard | netstandard2.0 is compatible. netstandard2.1 was computed. |
.NET Framework | net461 was computed. net462 was computed. net463 was computed. net47 was computed. net471 was computed. net472 was computed. net48 was computed. net481 was computed. |
MonoAndroid | monoandroid was computed. |
MonoMac | monomac was computed. |
MonoTouch | monotouch was computed. |
Tizen | tizen40 was computed. tizen60 was computed. |
Xamarin.iOS | xamarinios was computed. |
Xamarin.Mac | xamarinmac was computed. |
Xamarin.TVOS | xamarintvos was computed. |
Xamarin.WatchOS | xamarinwatchos was computed. |
-
.NETStandard 2.0
- log4net (>= 2.0.8)
- MySql.Data (>= 8.0.13)
- Npgsql (>= 4.0.4)
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 |