rbatis-wrapper

🚀 一个基于 rbatis 的现代化查询构建器，类似于 MyBatis Plus 的链式查询风格。

✨ 特性

• 🔗 链式调用: 类似 MyBatis Plus 的查询构建器风格
• 📄 分页支持: 内置分页功能，支持总数统计
• 🛠 自定义SQL: 支持复杂的自定义 SQL 查询
• 🔄 JOIN查询: 支持 INNER JOIN、LEFT JOIN、RIGHT JOIN
• 🎯 类型安全: 基于泛型的类型安全查询
• ⚡ 异步支持: 完全支持 Rust async/await

📦 安装

在您的 Cargo.toml 中添加以下依赖：

[dependencies]
rbatis-wrapper = "0.1.0"
rbatis = { version = "4.6", features = ["debug_mode"] }
serde = { version = "1.0", features = ["derive"] }

🚀 快速开始

基础设置

use rbatis::RBatis;
use rbatis_wrapper::QueryWrapper;
use serde::{Deserialize, Serialize};

#[derive(Debug, Serialize, Deserialize)]
struct User {
    id: u64,
    name: String,
    email: Option<String>,
    age: u32,
}

// 初始化 RBatis 实例
static RB: Lazy<RBatis> = Lazy::new(|| RBatis::new());

基础查询

// 查询单个记录
let user = QueryWrapper::new()
    .eq("id", 1)
    .get_one::<User>(&RB, "users")
    .await?;

// 查询多个记录
let users = QueryWrapper::new()
    .gt("age", 18)
    .like("name", "张")
    .order_by("age", true) // true 为升序
    .query::<User>(&RB, "users")
    .await?;

条件查询

let users = QueryWrapper::new()
    .eq("status", 1)                    // 等于
    .ne("deleted", 1)                   // 不等于  
    .gt("age", 18)                      // 大于
    .lt("age", 60)                      // 小于
    .like("name", "张")                 // LIKE 模糊查询
    .query::<User>(&RB, "users")
    .await?;

分页查询

let page_result = QueryWrapper::new()
    .eq("status", 1)
    .order_by("created_at", false) // 按创建时间降序
    .page::<User>(&RB, "users", 1, 10) // 第1页，每页10条
    .await?;

println!("总记录数: {}", page_result.total);
println!("当前页: {}", page_result.page_no);
println!("总页数: {}", page_result.pages);
println!("是否有下一页: {}", page_result.has_next);

指定查询字段

let users = QueryWrapper::new()
    .select(vec!["id", "name", "email"])
    .eq("status", 1)
    .query::<User>(&RB, "users")
    .await?;

JOIN 查询

let results = QueryWrapper::new()
    .inner_join("profiles p", "u.id = p.user_id")
    .left_join("orders o", "u.id = o.user_id")
    .eq("u.status", 1)
    .query::<User>(&RB, "users u")
    .await?;

自定义 SQL

// 自定义查询
let users = QueryWrapper::new()
    .custom_sql("SELECT * FROM users WHERE age BETWEEN 18 AND 65")
    .eq("status", 1) // 会自动添加到 WHERE 条件
    .query::<User>(&RB, "")
    .await?;

// 统计查询
let count = QueryWrapper::new()
    .custom_sql("SELECT COUNT(*) FROM users")
    .eq("status", 1)
    .get_one::<u64>(&RB, "")
    .await?;

复杂查询示例

// 复合条件查询
let mut wrapper = QueryWrapper::new();
wrapper
    .limit(20)
    .offset(40);

let users = wrapper
    .eq("department", "技术部")
    .gt("salary", 8000)
    .order_by("hire_date", false)
    .query::<User>(&RB, "employees")
    .await?;

📖 API 文档

QueryWrapper 方法

Page 结构体

pub struct Page<T> {
    pub records: Vec<T>,      // 数据列表
    pub total: u64,          // 总记录数
    pub page_no: u64,        // 当前页码
    pub page_size: u64,      // 每页大小
    pub pages: u64,          // 总页数
    pub has_next: bool,      // 是否有下一页
}

🤝 贡献

欢迎提交 Issue 和 Pull Request！

1. Fork 本项目
2. 创建您的特性分支 (git checkout -b feature/AmazingFeature)
3. 提交您的修改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 开启一个 Pull Request

📄 许可证

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

🙏 致谢

• rbatis - 优秀的 Rust ORM 框架
• MyBatis Plus - API 设计灵感来源