Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.
Awesome Lists | Featured Topics | Projects
https://github.com/zqlovejyc/SQLBuilder.Core

.NET Standard 2.1、.NET 5、.NET 6、.NET 7 版本SQLBuilder，Expression表达式转换为SQL语句，支持SqlServer、MySql、Oracle、Sqlite、PostgreSql；基于Dapper实现了不同数据库对应的数据仓储Repository；
https://github.com/zqlovejyc/SQLBuilder.Core
dapper expression orm repository sql sqlbuilder
Last synced: 1 day ago
JSON representation
.NET Standard 2.1、.NET 5、.NET 6、.NET 7 版本SQLBuilder，Expression表达式转换为SQL语句，支持SqlServer、MySql、Oracle、Sqlite、PostgreSql；基于Dapper实现了不同数据库对应的数据仓储Repository；
Host: GitHub
URL: https://github.com/zqlovejyc/SQLBuilder.Core
Owner: zqlovejyc
License: apache-2.0
Created: 2018-09-10T06:38:09.000Z (about 6 years ago)
Default Branch: master
Last Pushed: 2024-05-18T01:56:03.000Z (6 months ago)
Last Synced: 2024-05-18T02:38:48.868Z (6 months ago)
Topics: dapper, expression, orm, repository, sql, sqlbuilder
Language: C#
Homepage:
Size: 8.72 MB
Stars: 94
Watchers: 9
Forks: 25
Open Issues: 2
Metadata Files:
- Readme: readme.md
- License: LICENSE
Awesome Lists containing this project

README

        










[![star](https://gitee.com/zqlovejyc/SQLBuilder.Core/badge/star.svg)](https://gitee.com/zqlovejyc/SQLBuilder.Core/stargazers) [![fork](https://gitee.com/zqlovejyc/SQLBuilder.Core/badge/fork.svg)](https://gitee.com/zqlovejyc/SQLBuilder.Core/members) [![GitHub stars](https://img.shields.io/github/stars/zqlovejyc/SQLBuilder.Core?logo=github)](https://github.com/zqlovejyc/SQLBuilder.Core/stargazers) [![GitHub forks](https://img.shields.io/github/forks/zqlovejyc/SQLBuilder.Core?logo=github)](https://github.com/zqlovejyc/SQLBuilder.Core/network) [![GitHub license](https://img.shields.io/badge/license-Apache2-yellow)](https://github.com/zqlovejyc/SQLBuilder.Core/blob/master/LICENSE) [![nuget](https://img.shields.io/nuget/v/Zq.SQLBuilder.Core.svg?cacheSeconds=10800)](https://www.nuget.org/packages/Zq.SQLBuilder.Core)





.NET Standard 2.1、.NET 6、.NET 7、.NET 8  版本SQLBuilder，Expression表达式转换为SQL语句，支持SqlServer、MySql、Oracle、Sqlite、PostgreSql；基于Dapper实现了不同数据库对应的数据仓储Repository；



## 🌭 开源地址

- Gitee：[https://gitee.com/zqlovejyc/SQLBuilder.Core](https://gitee.com/zqlovejyc/SQLBuilder.Core)

- GitHub：[https://github.com/zqlovejyc/SQLBuilder.Core](https://github.com/zqlovejyc/SQLBuilder.Core)

- GitLab：[https://gitlab.com/zqlovejyc/SQLBuilder-Core](https://gitlab.com/zqlovejyc/SQLBuilder-Core)

- NuGet：[https://www.nuget.org/packages/Zq.SQLBuilder.Core](https://www.nuget.org/packages/Zq.SQLBuilder.Core)

- MyGet：[https://www.myget.org/feed/zq-myget/package/nuget/Zq.SQLBuilder.Core](https://www.myget.org/feed/zq-myget/package/nuget/Zq.SQLBuilder.Core)

## 🥥 框架扩展包

| 包类型 | 名称 | 版本 | 描述 |

| :---: | --- | :---: | --- |

| [![nuget](https://shields.io/badge/-Nuget-blue?cacheSeconds=604800)](https://www.nuget.org/packages/Zq.SQLBuilder.Core) | Zq.SQLBuilder.Core | [![nuget](https://img.shields.io/nuget/v/Zq.SQLBuilder.Core.svg?cacheSeconds=10800)](https://www.nuget.org/packages/Zq.SQLBuilder.Core) | SQLBuilder.Core 核心包 |

| [![nuget](https://shields.io/badge/-Nuget-blue?cacheSeconds=604800)](https://www.nuget.org/packages/Zq.SQLBuilder.Core.SkyWalking) | Zq.SQLBuilder.Core.SkyWalking | [![nuget](https://img.shields.io/nuget/v/Zq.SQLBuilder.Core.SkyWalking.svg?cacheSeconds=10800)](https://www.nuget.org/packages/Zq.SQLBuilder.Core.SkyWalking) | SQLBuilder.Core SkyWalking 扩展包 |

| [![nuget](https://shields.io/badge/-Nuget-blue?cacheSeconds=604800)](https://www.nuget.org/packages/Zq.SQLBuilder.Core.ElasticApm) | Zq.SQLBuilder.Core.ElasticApm | [![nuget](https://img.shields.io/nuget/v/Zq.SQLBuilder.Core.ElasticApm.svg?cacheSeconds=10800)](https://www.nuget.org/packages/Zq.SQLBuilder.Core.ElasticApm) | SQLBuilder.Core ElasticApm扩展包 |

| [![nuget](https://shields.io/badge/-Nuget-blue?cacheSeconds=604800)](https://www.nuget.org/packages/Zq.SQLBuilder.Core.Diagnostics) | Zq.SQLBuilder.Core.Diagnostics | [![nuget](https://img.shields.io/nuget/v/Zq.SQLBuilder.Core.Diagnostics.svg?cacheSeconds=10800)](https://www.nuget.org/packages/Zq.SQLBuilder.Core.Diagnostics) | SQLBuilder.Core Diagnostics扩展包 |

## 🚀 快速入门

- #### ➕ 新增

```csharp

//新增

await _repository.InsertAsync(entity);

//批量新增

await _repository.InsertAsync(entities);

//新增

await SqlBuilder

        .Insert(() =>

            entity)

        .ExecuteAsync(

            _repository);

//批量新增

await SqlBuilder

        .Insert(() =>

            new[]

            {

                new UserInfo { Name = "张三", Sex = 2 },

                new UserInfo { Name = "张三", Sex = 2 }

            })

        .ExecuteAsync(

            _repository);

```

- #### 🗑 删除

```csharp

//删除

await _repository.DeleteAsync(entity);

//批量删除

await _repository.DeleteAsync(entitties);

//条件删除

await _repository.DeleteAsync(x => x.Id == "1");

//删除

await SqlBuilder

        .Delete()

        .Where(x =>

            x.Id == "1")

        .ExecuteAsync(

            _repository);

//主键删除

await SqlBuilder

        .Delete()

        .WithKey("1")

        .ExecuteAsync(

            _repository);

```

- #### ✏ 更新

```csharp

//更新

await _repository.UpdateAsync(entity);

//批量更新

await _repository.UpdateAsync(entities);

//条件更新

await _repository.UpdateAsync(x => x.Id == "1", () => entity);

//更新

await SqlBuilder

        .Update(() =>

            entity,

            DatabaseType.MySql,

            isEnableFormat:true)

        .Where(x =>

            x.Id == "1")

        .ExecuteAsync(

            _repository);

```

- #### 🔍 查询

```csharp

//简单查询

await _repository.FindListAsync(x => x.Id == "1");

//连接查询

await SqlBuilder

        .Select((u, t, a, s, d, e, f) =>

            new { u.Id, UId = t.Id, a.Name, StudentName = s.Name, ClassName = d.Name, e.CityName, CountryName = f.Name })

        .Join((x, t) =>

            x.Id == t.Id) //注意此处单表多次Join所以要指明具体表别名，否则都会读取第一个表别名

        .Join((x, y) =>

            x.Id == y.UserId)

        .LeftJoin((x, y) =>

            x.Id == y.AccountId)

        .RightJoin((x, y) =>

            x.Id == y.UserId)

        .InnerJoin((x, y) =>

            x.CityId == y.Id)

        .FullJoin((x, y) =>

            x.CountryId == y.Id)

        .Where(x =>

            x.Id != null)

        .ToListAsync(

            _repository);

//分页查询

var condition = LinqExtensions

                    .True()

                    .And((x, y) => 

                        x.Id == y.UserId)

                    .WhereIf(

                        !name.IsNullOrEmpty(), 

                        (x, y) => name.EndsWith("∞")

                        ? x.Name.Contains(name.Trim('∞'))

                        : x.Name == name);

var hasWhere = false;

await SqlBuilder

        .Select(

            (u, a) => new { u.Id, UserName = "u.Name" })

        .InnerJoin(

            condition)

        .WhereIf(

            !name.IsNullOrEmpty(),

            x => x.Email != null && 

            (!name.EndsWith("∞") ? x.Name.Contains(name.TrimEnd('∞', '*')) : x.Name == name),

            ref hasWhere)

        .WhereIf(

            !email.IsNullOrEmpty(),

            x => x.Email == email,

            ref hasWhere)

        .ToPageAsync(

            _repository.UseMasterOrSlave(false),

            input.OrderField,

            input.Ascending,

            input.PageSize,

            input.PageIndex);

//仓储分页查询

await _repository.FindListAsync(condition, input.OrderField, input.Ascending, input.PageSize, input.PageIndex);

//高级查询

Func @delegate = x => $"ks.{x[0]}{x[1]}{x[2]} WITH(NOLOCK)";

await SqlBuilder

        .Select((u, a, s, d, e, f) =>

            new { u, a.Name, StudentName = s.Name, ClassName = d.Name, e.CityName, CountryName = f.Name },

            tableNameFunc: @delegate)

        .Join((x, y) =>

            x.Id == y.UserId,

            @delegate)

        .LeftJoin((x, y) =>

            x.Id == y.AccountId,

            @delegate)

        .RightJoin((x, y) =>

            y.Id == x.UserId,

            @delegate)

        .InnerJoin((x, y) =>

            x.CityId == y.Id,

            @delegate)

        .FullJoin((x, y) =>

            x.CountryId == y.Id,

            @delegate)

        .Where(u =>

            u.Id != null)

        .ToListAsync(

            _repository);

```

- #### 🎫 队列

```csharp

//预提交队列

_repository.AddQueue(async repo =>

    await repo.UpdateAsync(

        x => x.Id == "1",

        () => new

        {

            Name = "test"

        }) > 0);

_repository.AddQueue(async repo =>

    await repo.DeleteAsync(x =>

        x.Enabled == 1) > 0);

//统一提交队列，默认开启事务

var res = await _repository.SaveQueueAsync();

```

### 🌌 IOC注入

根据appsettions.json配置自动注入不同类型数据仓储，支持一主多从配置

```csharp

//注入SQLBuilder仓储

services.AddSqlBuilder(Configuration, "Base", (sql, parameter) =>

{

    //写入文本日志

    if (WebHostEnvironment.IsDevelopment())

    {

        if (parameter is DynamicParameters dynamicParameters)

            _logger.LogInformation($@"SQL语句：{sql}  参数：{dynamicParameters

                .ParameterNames?

                .ToDictionary(k => k, v => dynamicParameters.Get(v))

                .ToJson()}");

        else if (parameter is OracleDynamicParameters oracleDynamicParameters)

            _logger.LogInformation($@"SQL语句：{sql} 参数：{oracleDynamicParameters

                .OracleParameters

                .ToDictionary(k => k.ParameterName, v => v.Value)

                .ToJson()}");

        else

            _logger.LogInformation($"SQL语句：{sql}  参数：{parameter.ToJson()}");

    }

    //返回null，不对原始sql进行任何更改，此处可以修改待执行的sql语句

    return null;

});

```

### ⚙ 数据库配置

```csharp

//appsettions.json

"ConnectionStrings": {

  "Base": [

    "Oracle",

    "Data Source=(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=192.168.1.100)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=name)));Persist Security Info=True;User ID=test;Password=123;",

    "Data Source=(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=192.168.1.101)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=name)));Persist Security Info=True;User ID=test;Password=123;",

    "Data Source=(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=192.168.1.102)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=name)));Persist Security Info=True;User ID=test;Password=123;",

  ],

  "Cap": [

    "MySql",

    "Server=127.0.0.1;Database=db;Uid=root;Pwd=123456;SslMode=None;"

  ],

  "Oracle": [ "Oracle", "数据库连接字符串" ],

  "MySql": [ "MySql", "数据库连接字符串" ],

  "Sqlserver": [ "SqlServer", "数据库连接字符串" ],

  "Sqlite": [ "Sqlite", "数据库连接字符串" ],

  "Pgsql": [ "PostgreSql", "数据库连接字符串" ]

}

```

### 📰 事务

```csharp

//方式一

IRepository trans = null;

try

{

    //开启事务

    trans = await _repository.BeginTransactionAsync();

    //数据库写操作

    await trans.InsertAsync(entity);

    //提交事务

    await trans.CommitAsync();

}

catch (Exception)

{

    //回滚事务

    if(trans != null)

        await tran.RollbackAsync();

       

    throw;

}

//方式二

var res = await _repository.ExecuteTransactionAsync(async trans =>

{

    var retval = (await trans.InsertAsync(entity)) > 0;

    if (input.Action.EqualIgnoreCase(UnitAction.InDryBox))

        code = await _unitInfoService.InDryBoxAsync(dryBoxInput);

    else

        code = await _unitInfoService.OutDryBoxAsync(dryBoxInput);

    return code == ErrorCode.Successful && retval;

});

```

### 📯 仓储+切库

```csharp

private readonly Func _handler;

private readonly IRepository _repository;

public MyService(Func hander)

{

    _handler = hander;

    //默认base数据仓储

    _repository = hander(null);

}

//base仓储

var baseRepository = _handler("Base");

//cap仓储

var capRepository = _handler("Cap");

```

### 🎣 读写分离

```csharp

//方式一

_repository.Master = false;

//方式二

_repository.UseMasterOrSlave(master)

```

### 🔗 链路追踪

```csharp

//注入SQLBuilder SkyWalking链路追踪

services.AddSqlBuilderSkyApm()

//使用SQLBuilder ElasticApm链路追踪

app.UseSqlBuilderElasticApm(Configuration)

```

## 🧪 测试文档

- 单元测试 [https://github.com/zqlovejyc/SQLBuilder.Core/tree/master/SQLBuilder.Core.UnitTest](https://github.com/zqlovejyc/SQLBuilder.Core/tree/master/SQLBuilder.Core.UnitTest)

## 🍻 贡献代码

`SQLBuilder.Core` 遵循 `Apache-2.0` 开源协议，欢迎大家提交 `PR` 或 `Issue`。