FluentCondition 1.0.0

🚀 FluentCondition

强大的查询条件构建器，让复杂查询变得简单优雅！

✨ 特性

• 🎯 声明式设计 - 使用特性标记定义查询条件，代码清晰易维护
• 🔄 双模式支持 - 同时支持内存查询（Lambda）和数据库查询（SQL）
• 🛡️ 类型安全 - 编译时检查，避免运行时错误
• ⚡ 高性能 - 表达式树编译，零反射性能损耗
• 🔒 安全可靠 - 参数化查询，防止SQL注入
• 🎨 灵活强大 - 支持复杂条件组合、OR逻辑、条件依赖

📦 安装

dotnet add package FluentCondition

或在 Package Manager Console 中:

Install-Package FluentCondition

🎯 快速开始

1. 定义实体类

public class Product
{
    public int Id { get; set; }
    public string Name { get; set; }
    public decimal Price { get; set; }
    public string Category { get; set; }
}

2. 定义查询条件类

using FluentCondition.Attributes;

public class ProductSearch
{
    [Equal]
    public int? Id { get; set; }
    
    [Contains]
    public string Name { get; set; }
    
    [GreaterThanOrEqual(FieldName = "Price")]
    public decimal? MinPrice { get; set; }
    
    [In]
    public string[] Categories { get; set; }
}

3. 使用条件查询

内存查询（LINQ）

using FluentCondition.Extensions;

var criteria = new ProductSearch { MinPrice = 100 };
var results = products.Where(criteria).ToList();

数据库查询（SQL）

using FluentCondition.Core;

var criteria = new ProductSearch { MinPrice = 100 };
var sql = ConditionBuilder.BuildSqlCondition<Product, ProductSearch>(criteria);

// 输出: WHERE Price >= @p0
Console.WriteLine($"WHERE {sql.WhereClause}");

// 在ADO.NET中使用
using (var command = new SqlCommand(sql.ToSql("SELECT * FROM Product"), connection))
{
    command.Parameters.AddRange(sql.Parameters);
    // 执行查询...
}

📚 支持的条件类型

🔥 高级特性

OR 条件组合

使用 [OrWith] 特性创建 OR 条件：

public class Search
{
    [Contains]
    [OrWith(nameof(Email))]
    public string Name { get; set; }
    
    [Contains]
    [OrWith(nameof(Name))]
    public string Email { get; set; }
}

// 生成: (Name LIKE '%search%' OR Email LIKE '%search%')

条件依赖（IF）

使用 [If] 特性根据其他属性决定是否应用条件：

public class Search
{
    public bool UseAdvanced { get; set; }
    
    // 只有当 UseAdvanced = true 时才应用此条件
    [Equal]
    [If(nameof(UseAdvanced), CheckType = ConditionCheck.IsTrue)]
    public bool? IsActive { get; set; }
}

支持的检查类型：

• ConditionCheck.Equal - 相等
• ConditionCheck.NotEqual - 不相等
• ConditionCheck.IsTrue - 为 true
• ConditionCheck.IsFalse - 为 false
• ConditionCheck.NotNull - 不为空
• ConditionCheck.IsNull - 为空

字段名映射

使用 FieldName 属性映射到不同的字段名：

[GreaterThan(FieldName = "Age")]
public int? MinAge { get; set; }
// 映射到 Age 字段，而不是 MinAge

表别名支持

var sql = ConditionBuilder.BuildSqlCondition<Product, ProductSearch>(
    criteria, 
    tableAlias: "p");
// 生成: p.Price >= @p0

📖 完整示例

// 定义查询条件
public class ProductSearchCriteria
{
    [Equal]
    public int? Id { get; set; }

    [Contains]
    [OrWith(nameof(Description))]
    public string Name { get; set; }

    [Contains]
    [OrWith(nameof(Name))]
    public string Description { get; set; }

    [GreaterThanOrEqual(FieldName = "Price")]
    public decimal? MinPrice { get; set; }

    [LessThanOrEqual(FieldName = "Price")]
    public decimal? MaxPrice { get; set; }

    [In]
    public string[] Categories { get; set; }

    public bool UseAdvancedSearch { get; set; }

    [GreaterThan(FieldName = "Stock")]
    [If(nameof(UseAdvancedSearch), CheckType = ConditionCheck.IsTrue)]
    public int? MinStock { get; set; }
}

// 使用示例
var criteria = new ProductSearchCriteria
{
    Name = "键盘",
    MinPrice = 500,
    MaxPrice = 2000,
    Categories = new[] { "电子产品", "配件" },
    UseAdvancedSearch = true,
    MinStock = 10
};

// Lambda 查询
var memoryResults = products.Where(criteria).ToList();

// SQL 查询
var sql = ConditionBuilder.BuildSqlCondition<Product, ProductSearchCriteria>(criteria);
Console.WriteLine(sql.ToSql("SELECT * FROM Product"));
// 输出: SELECT * FROM Product WHERE (Name LIKE @p0 OR Description LIKE @p1) 
//       AND Price >= @p2 AND Price <= @p3 AND Categories IN (@p4, @p5) AND Stock > @p6

🧪 运行示例项目

cd samples/FluentCondition.Samples
dotnet run

🧪 运行测试

dotnet test

📄 许可证

本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情

🤝 贡献

欢迎提交 Issue 和 Pull Request！

📧 联系方式

如有问题或建议，请通过 GitHub Issues 联系我们。

⭐ 如果这个项目对您有帮助，请给我们一个 Star！