前言
上一篇介绍了扩展类库的功能简介,通过json文件配置sql语句 和 sql语句的直接执行,这篇开始说明sql配置的策略模块:策略管理器与各种策略的配置。
类库源码:github:https://github.com/skigs/EFCoreExtend
引用类库:nuget:https://www.nuget.org/packages/EFCoreExtend/
PM> Install-Package EFCoreExtend
策略管理器功能简介
用于管理策略 与 策略执行器和调用(目前分为三种策略执行器),目的为了让配置的sql语句更加简单、自动化等等。
1) 策略类型管理
a) 管理各种策略类型,用于初始化配置文件中的策略配置转换成对象
2) 策略对象配置
a) 通过 sql配置的执行器 的形参传递策略对象
b) 通过 配置文件(分为表和sql) 配置策略对象
c) 配置到 全局策略 中(策略管理器中)
d) 策略对象获取的优先级:通过执行器的形参传递的策略对象 > sql配置的策略对象 > 表配置的策略对象 > 全局策略中配置
3) 策略执行器(一般通过策略对象进行相应的处理)
a) 初始化型的策略执行器:这种类型的会在第一次调用GetExecutor的时候执行,只会执行一次,除非sql配置有改动
-
- 配置策略对象的初始化、替换表名、合并分部sql等的策略执行器
b) sql执行前的策略执行器:一般用于对SqlParameter进行解析到sql中
-
- foreach策略执行器:对SqlParameter或者某些数据类型(list/dictionary/model)进行遍历生成字串替换到sql中
c) sql执行时的策略执行器:一般用于缓存和日志记录
-
- sql与参数的日志记录策略执行器
- 查询缓存与清理策略执行器
表名替换策略
通过特定的标签代替表名在sql配置中呈现(该策略对象默认已经添加到全局策略中,因此并不一定要在配置文件中配置):
{ "policies": { //表配置的策略对象(会包含到表下的所有sql配置中) //表名策略 "tname": { //"tag": "##tname" //默认值为 ##tname } }, "sqls": { "GetList": { "sql": "select * from ##tableName where name=@name", // => select * from [Person] where name=@name "type": "query", "policies": { //sql配置的策略对象 //表名策略 "tname": { "tag": "##tableName", //默认值为 ##tname "prefix": "[", //前缀 "suffix": "]" //后缀 } } } } }
配置初始化:
1 public static void Init() 2 { 3 //加载配置 4 EFHelper.Services.SqlConfigMgr.Config.LoadDirectory(Directory.GetCurrentDirectory() + "/Datas"); 5 6 //设置到全局策略中(一般用于设置 初始化型的策略对象),将策略对象设置到全局之后,会包含到所有配置中的 7 EFHelper.Services.SqlConfigMgr.PolicyMgr.SetGlobalPolicy( 8 //TableNamePolicy对象默认已经添加到全局策略中 9 new TableNamePolicy //表名策略在配置文件中呈现的key:tname(可以通过SqlConfigConst.TableNamePolicyName获取) 10 { 11 Tag = "##tname", 12 }); 13 }
配置执行器调用:
1 public IReadOnlyList<Person> GetList() 2 { 3 tinfo = db.GetConfigTable<Person>(); 4 return tinfo.GetExecutor().QueryUseModel<Person>(new 5 { 6 name = "tom" 7 }, null, null, 8 //通过参数传递策略对象(一般用于设置 sql执行前 或 执行时的策略对象, 9 // 而初始化型的一般在配置文件或全局策略中设置) 10 new[] { new SqlL2QueryCachePolicy() }); 11 }
说明:
策略对象获取的优先级(如果策略对象设置到多个地方了): 执行器形参传递的策略对象 > sql配置的策略对象 > 表配置的策略对象 > 全局策略中配置
分部sql策略
分部sql目的为了将sql分部在不同的配置中,以便sql的可重用:
Person.json配置:
{ "sqls": { "GetListSection": { "sql": "select * from ##tname where #{WhereSec}", //最终生成的sql:select * from Person where name=@name or addrid in (select id from Address where id=@addrid) "type": "query", "policies": { //分部sql策略,以便将sql分部在不同的配置中(注意:分部策略是对sql的分部,可以在分部sql下再进行分部sql(子分部),但是不会继承分部sql中的policies(策略对象)等的配置) "section": { //"tagPrefix": "#{", //策略前缀标记符,默认为 #{ //"tagSuffix": "}", //策略后缀标记符,默认为 } "sqlNames": [ "WhereSec" ] //指定sql的名称(同表下的SqlName) //"tableSqlNames": { //指定其他表的sql名称(key为TableName,value为SqlName) //} } } }, "WhereSec": { "sql": " #{WhereSec1} or addrid in (#{Address.ListSec}) ", "type": "nonexecute", //不用于执行的sql类型 "policies": { "section": { "sqlNames": [ "WhereSec1" ], "tableSqlNames": { //指定其他表的sql名称(key为TableName,value为SqlName) "Address": "ListSec" } } } }, "WhereSec1": { "sql": "name=@name", "type": "nonexecute" } } }
Address.json:
{ "sqls": { "ListSec": { "sql": "select id from ##tname where #{WhereSec}", "type": "nonexecute", "policies": {