Skip to main content

rbatis_plus_core/
wrapper.rs

1// Source: rbatis-wrapper/src/wrapper.rs (absorbed for backward compat)
2
3use crate::conditions::query::QueryWrapper;
4use crate::conditions::join::Join;
5use crate::page::{Page, PageRequest};
6use rbatis::executor::Executor;
7use rbatis::Error;
8use serde::de::DeserializeOwned;
9use serde::Serialize;
10
11/// Legacy compatibility entry point — absorbs the `rbatis-wrapper` crate API.
12///
13/// In new code prefer `QueryWrapper` directly; this module provides
14/// the same `query()`, `get_one()`, `delete()`, and `page()` async methods
15/// that `rbatis-wrapper` exposed, now backed by the full `QueryWrapper`.
16impl QueryWrapper {
17    /// Execute the query and return a list of entities.
18    ///
19    /// 执行查询返回列表
20    pub async fn query<T: Serialize + DeserializeOwned>(
21        &self,
22        rb: &dyn Executor,
23        table_name: &str,
24    ) -> Result<Vec<T>, Error> {
25        let sql = self.build_select_sql(table_name);
26        let v = rb.query(&sql, vec![]).await?;
27        Ok(rbs::from_value(v)?)
28    }
29
30    /// Execute the query and return a single entity (or None).
31    ///
32    /// 执行查询返回单条
33    pub async fn get_one<T: Serialize + DeserializeOwned>(
34        &self,
35        rb: &dyn Executor,
36        table_name: &str,
37    ) -> Result<Option<T>, Error> {
38        // Add LIMIT 1 if not already set
39        let mut clone = self.clone();
40        if clone.inner.sql_last.is_empty() {
41            clone.last("LIMIT 1");
42        }
43        let sql = clone.build_select_sql(table_name);
44        let v = rb.query(&sql, vec![]).await?;
45        let list: Vec<T> = rbs::from_value(v)?;
46        Ok(list.into_iter().next())
47    }
48
49    /// Execute a paginated query.
50    ///
51    /// 执行分页查询
52    pub async fn page<T: Serialize + DeserializeOwned>(
53        &self,
54        rb: &dyn Executor,
55        table_name: &str,
56        page_no: u64,
57        page_size: u64,
58    ) -> Result<Page<T>, Error> {
59        let req = PageRequest::new(page_no, page_size);
60
61        // Count
62        let count_sql = self.build_count_sql(table_name);
63        let v = rb.query(&count_sql, vec![]).await?;
64        let total: u64 = rbs::from_value(v).unwrap_or(0);
65
66        if total == 0 {
67            return Ok(Page::empty(page_no, page_size));
68        }
69
70        // Data
71        let mut clone = self.clone();
72        clone.last(&format!("LIMIT {} OFFSET {}", req.page_size, req.offset()));
73        let sql = clone.build_select_sql(table_name);
74        let v = rb.query(&sql, vec![]).await?;
75        let records: Vec<T> = rbs::from_value(v)?;
76
77        Ok(Page::new(records, total, page_no, page_size))
78    }
79}