为什么要写
为什么要写,大概就是沉没成本吧
只是从Source Generators出来开始,就打算以其研究是否能做 aop (现在已经有内置功能了),本来当年就想尝试能否在 orm 做一些尝试,可惜种种原因,自己都忘了这个打算了
直到今年7月份,才又想起了这个打算,现在精力不行了,本来研究一下原理和功能限制也算完了,
可是都写了蛮久了,不写完整点,感觉有点浪费,又花了不少时间才把 类似 DapperAOT 功能做的差不多
写完了又觉得光复制复制功能 没意思, 所以又把以前为了在公司内少写一些比较重复性代码做的 查询定制功能 在 sv.db 基础上搞一把, 反正成本已经花了那么多了
虽然这也不算多大创新, 类似想法老早就不少人搞了,比如最夸张的 graphql 这一套甚至让大家的基础设施都得搭一套,
不过越搞越多,都到国庆了,目前还只能算主体完成了,细节还有很多没搞
很多转换 解析都是手写的,不是因为写的nb,只是引入其他库兼容可能有点麻烦,场景不多,递归遍历就够了
nuget 什么的也没空搞了,bug 估计不少,等后面再完整点再搞,反正都是自娱自乐
真是年纪大了,做什么都越来越慢了
sv.db 能做什么
1. db映射到实体
像 DapperAOT 一样,使用 Source Generators 在构建期间生成必要的代码,以帮助您更轻松地使用 sql。
理论上,您还可以进行 Native AOT 部署
其实没什么,举个栗子吧
public async Task<object> OldWay() { var a = factory.GetConnection(StaticInfo.Demo); using var dd = await a.ExecuteReaderAsync(""" SELECT count(1) FROM Weather; SELECT * FROM Weather; """); var t = await dd.QueryFirstOrDefaultAsync<int>(); var r = await dd.QueryAsync<string>().ToListAsync(); return new { TotalCount = t, Rows = r }; }
2. 让查询编码简单,并支持更复杂的条件
通过定义一些简单的查询规则,我们可以将 查询转换为 db / api / es 查询语句 ....
目前只搞了 db 转换,并且还没空完整适配测试, es 、mongodb 什么等后面有空把
不过理论上,我们可以这样做:
http query string / body |------> select statement |------> db (sqlite / mysql/ sqlserver / PostgreSQL) Expression code |------> |------> es |------> mongodb |------> more .....
中间 select statement
这一层已经定义好了,前面的转换也有了, 后面的理论加上适配,什么都可以做,
2.1 举个 api 的栗子
Code exmples:
首先定义一个 实体配置, 列明哪些字段可以查,可以排序,可以筛选
[Db("Demo")] [Table(nameof(Weather))] public class Weather { [Select, Where, OrderBy] public string Name { get; set; } [Select(Field = "Value as v"), Where, OrderBy] public string V { get; set; } [Select(NotAllow = true)] public string Test { get; set; } }
然后定义 查询接口
[HttpGet] public async Task<object> Selects() // 你可以自己做一些字段,授权检查 [FromQuery, Required] string name) { return await this.QueryByParamsAsync<Weather>(); }
接着你就可以让用户自己拼写各种条件,让她们自己满足自己的场景,这样自己可以多摸一会鱼了
curl --location 'http://localhost:5259/weather?where=not (name like '%e%')&TotalCount=true'
Response
{ "totalCount": 1, "rows": [ { "name": "H", "v": "mery!" } ] }
2.2 同样可以让查询代码更简单
Code exmples:
其实很多 orm 都提供用Expression 达到类似或更复杂效果的
这里考虑工作量,restful api 和其他数据查询实现 支持度不一,目前只做基础filter 支持, join 什么都不搞了,就算搞了多半又会被骂,直接写sql 不更好吗?
比如下面 query Weather which name no Contains 'e'
public async Task<object> DoSelects() { return await factory.ExecuteQueryAsync(From.Of<Weather>().Where(i => !i.Name.Like("e")).WithTotalCount()); }
这里就非常简单介绍一下,复杂的,怎么实现的不写,累了,写不动了,要有感兴趣的 可以在 gayhub 看源码 https://github.com/fs7744/sv.db
下面再列举一下过滤操作符支持情况
Query in api
Both has func support use query string or body to query
body or query string will map to Dictionary<string, string>
to handle
operater
such filter operater just make api more restful (Where=urlencode(complex condition)
will be more better)
{{nl}}
is null- query string
?name={{nl}}
- body
{"name":"{{nl}}"}
- query string
{{eq}}
Equal =- query string
?name=xxx
- body
{"name":"xxx"}
- query string
{{lt}}
LessThan or Equal <=- query string
?age={{lt}}30
- body
{"age":"{{lt}}30"}
- query string
{{le}}
LessThan <- query string
?age={{le}}30
- body
{"age":"{{le}}30"}
- query string
{{gt}}
GreaterThan or Equal >=- query string
?age={{gt}}30
- body
{"age":"{{gt}}30"}
- query string
{{gr}}
GreaterThan >- query string
?age={{gr}}30
- body
{"age":"{{gr}}30"}
- query string
{{nq}}
Not Equal !=- query string
?age={{nq}}30
- body
{"age":"{{nq}}30"}
- query string
{{lk}}
Prefix Like 'e%'- query string
?name={{lk}}e
- body
{"name":"{{lk}}e"}
- query string
{{rk}}
Suffix Like '%e'- query string
?name={{rk}}e
- body
{"name":"{{rk}}e"}
- query string
{{kk}}
Like '%e%'- query string
?name={{kk}}e
- body
{"name":"{{kk}}e"}
- query string
{{in}}
in array (bool/number/string)- query string
?name={{in}}[true,false]
- body
{"name":"{{in}}["s","sky"]"}
- query string
{{no}}
not- query string
?age={{no}}{{lt}}30
- body
{"age":"{{no}}{{lt}}30"}
- query string
Func Fields:
Fields
return some Fields , no Fields orFields=*
is return all- query string
?Fields=name,age
- body
{"Fields":"name,age"}
- query string
TotalCount
return total count- query string
?TotalCount=true
- body
{"TotalCount":"true"}
- query string
NoRows
no return rows- query string
?NoRows=true
- body
{"NoRows":"true"}
- query string
Offset
Offset Rows index- query string
?Offset=10
- body
{"Offset":10}
- query string
Rows
Take Rows count, default is 10- query string
?Rows=100
- body
{"Rows":100}
- query string
OrderBy
sort result- query string
?OrderBy=name:asc,age:desc
- body
{"OrderBy":"name:asc,age:desc"}
- query string
Where
complex condition filter- query string
?Where=urlencode( not(name like 'H%') or name like '%v%' )
- body
{"Where":"not(name like 'H%') or name like '%v%'"}
- operaters
- bool
- example
true
orfalse
- example
- number
- example
12323
or1.324
or-44.4
- example
- string
- example
'sdsdfa'
or'sds'dfa'
or"dsdsdsd"
or"fs"dsf"
- example
= null
is null- example
name = null
- example
=
Equal- example
name = 'sky'
- example
<=
LessThan or Equal- example
age <= 30
- example
<
LessThan- example
age < 30
- example
>=
GreaterThan or Equal- example
age >= 30
- example
>
GreaterThan- example
age > 30
- example
!=
Not Equal- example
age != 30
- example
like 'e%'
Prefix Like- example
name like 'xx%'
- example
like '%e'
Suffix Like- example
name like '%xx'
- example
like '%e%'
Like- example
name like '%xx%'
- example
in ()
in array (bool/number/string)- example
in (1,2,3)
orin ('sdsdfa','sdfa')
orin (true,false)
- example
not
- example
not( age <= 30 )
- example
and
- example
age <= 30 and age > 60
- example
or
- example
age <= 30 or age > 60
- example
()
- example
(age <= 30 or age > 60) and name = 'killer'
- example
- bool
- query string