Galosys.Foundation.FreeSql 26.10.29.1

Galosys.Foundation.FreeSql

成熟度: 🟡 可用 — 功能完整，测试或文档可能不完善

FreeSql ORM 框架集成模块，为 Galosys.Foundation 提供基于 FreeSql 的数据访问层实现。

简介

Galosys.Foundation.FreeSql 是 FreeSql ORM 框架在 Galosys.Foundation 框架中的集成模块。它提供了自动化的数据库连接管理、实体映射、审计字段填充、多租户支持等企业级功能。

特性

• 多数据库支持：自动识别并支持 SqlServer、MySql、PostgreSQL、Oracle、SQLite
• 自动审计字段：自动填充创建时间、修改时间、创建人、修改人等审计字段
• 多租户支持：基于 IMultiTenancy 接口实现数据隔离
• 多应用支持：基于 IMultiApplication 接口实现应用级数据隔离
• 软删除过滤：自动过滤已删除数据（IDeletable 接口）
• Snowflake ID：集成雪花算法生成分布式唯一ID
• SQL 监控：自动记录慢查询（>200ms）并输出详细日志
• Snake Case 命名：自动将 PascalCase 属性名转换为 snake_case 列名

安装

<ItemGroup>
  <PackageReference Include="Galosys.Foundation.FreeSql" Version="x.x.x" />
</ItemGroup>

配置

appsettings.json

{
  "ConnectionStrings": {
    "Default": {
      "ConnectionString": "Server=localhost;Database=mydb;User=root;Password=password;",
      "Provider": "MySqlConnector"
    }
  }
}

支持的数据库 Provider

使用示例

基本 CRUD 操作

public class ProductService
{
    private readonly IFreeSql _fsql;
    
    public ProductService([FromKeyedServices("Default")] IFreeSql fsql)
    {
        _fsql = fsql;
    }
    
    // 查询
    public async Task<List<Product>> GetProductsAsync()
    {
        return await _fsql.Select<Product>()
            .Where(p => !p.Deleted) // 软删除过滤
            .ToListAsync();
    }
    
    // 新增
    public async Task AddProductAsync(Product product)
    {
        await _fsql.Insert(product).ExecuteAffrowsAsync();
    }
    
    // 更新
    public async Task UpdateProductAsync(Product product)
    {
        await _fsql.Update<Product>(product).ExecuteAffrowsAsync();
    }
    
    // 删除（软删除）
    public async Task DeleteProductAsync(long id)
    {
        await _fsql.Update<Product>(id)
            .Set(p => p.Deleted, true)
            .ExecuteAffrowsAsync();
    }
}

实体定义

[Table("products")]
public class Product : FullEntity<long>
{
    [SnowflakeId]
    public new long Id { get; set; }
    
    public string Name { get; set; }
    
    public decimal Price { get; set; }
    
    [CreatedAt]
    public DateTime CreatedAt { get; set; }
    
    [CreatorId]
    public long CreatorId { get; set; }
    
    [LastModifiedAt]
    public DateTime? LastModifiedAt { get; set; }
}

核心类

依赖

• Galosys.Foundation.Data：基础数据模块，提供 IRepository、IUnitOfWork 等接口
• Galosys.Foundation.Core：核心模块，提供审计特性、多租户接口等
• FreeSql：FreeSql ORM 核心库

自动审计字段

模块会自动填充以下审计字段：

全局过滤器

• 软删除过滤：自动过滤 IDeletable.Deleted == true 的记录
• 租户过滤：当 TenantManager.Current > 0 时，自动按 TenantId 过滤
• 应用过滤：当 ApplicationManager.Current > 0 时，自动按 AppId 过滤