Galosys.Foundation.FreeSql 26.5.19.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 过滤