HiKari使用说明

已经提交nuget(Hikari)
郑重说明：本库HiKari定位于数据库连接池，源码GitHub开源公开，欢迎大家修改提交
其它功能建议以Hikari.Integration.XXXX(名称)库，引用当前库进行扩展

程序初始化

使用配置类

      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 = 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);

配置文件说明

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

源码简说

基本内容

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

扩展项目

Hikari.Integration.Entity
采用emit将DataTable,IDataReader转换成List,同理将List转成DataTable
内部调用EntityMappingDB项目

使用扩展方法ToEntity 转换  
使用扩展方法FromEntity 转换  
如果带特性则使用扩展方法FromEntityAttribute  转换

说明：因为Hikari项目定位连接池，不能随意扩展功能和类，所以转换以扩展项目的方式提供

扩展功能

HikariDataSource,ManagerPool通过扩展方法封装了SQL基本操作

说明：这里只是方便操作，尤其是返回DataSet,按照项目定位是不应该的，所以使用的是扩展方法

扩展API

HikariAPI项目介绍：

SqlMapper类用于SQL语句和参数传递，参数可以是方法一样逐个传递，也可以采用实体（包括匿名）
2.HikariContext类用于配置和参数传递，需要SQL文件，需要配置XML文件名称和节点名称，默认节点是“Sql”
这两个类需要使用者研究下

附录

数据库	Dll名称	说明
Oracle	Oracle.ManagedDataAccess	以前不是这个dll
MySql	MySql.Data
SqlServer	System
PostgreSQL	Npgsql

agausachs / Hikari