1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
//! 表查询构建器
//!
//! 提供由 [`super::TableDefinition`] 约束的查询构建器,支持字段权限验证和 CRUD。
//!
//! # 主要组件
//!
//! - `TableQuery`:查询构建器,支持链式调用
//!
//! # 示例
//!
//! ```rust,ignore
//! use yang_base::table::{Field, SortOrder, Table};
//! use serde_json::json;
//! use std::sync::Arc;
//!
//! let table = Table::new("users")
//! .fields(vec![
//! Field::id("id"),
//! Field::string("name", 50),
//! Field::string("email", 100),
//! ])
//! .build()?;
//!
//! let query = table.bind(Arc::new(pool)).query(["user"]);
//!
//! // 链式调用构建查询
//! let result = query
//! .select_fields(&["id", "name", "email"])?
//! .where_eq("status", json!("active"))?
//! .order_by("created_at", SortOrder::Desc)?
//! .page(1, 20)?
//! .all()
//! .await?;
//! ```
// 保持 crate 内既有路径 `crate::table::table_query::SqlParam` 可用于测试
pub use SqlParam;
use crate;
use Value;
use HashSet;
use Arc;
/// 受保护表查询允许的最大单页大小。
///
/// 该上限必须在 `TableQuery` 底层执行,而不能只放在上层 action。自定义 action 或库调用方
/// 可直接调用 `ctx.table_query()?.page(...)`,底层没有上限会绕过内置 `SelectAction` 的保护,
/// 导致超大查询拖垮数据库或应用内存。
pub const MAX_TABLE_QUERY_PAGE_SIZE: usize = MAX_QUERY_PAGE_SIZE;
/// 表查询构建器
///
/// 基于不可变表定义创建受保护的查询构建器,支持:
/// - 字段选择和权限验证
/// - WHERE 条件构建
/// - 排序规则
/// - 分页查询
///
/// # 字段
///
/// - 内部表契约:由 [`super::TableDefinition`] 提供字段定义和权限配置
/// - `user_roles`:用户角色列表,用于权限检查
/// - `query_params`:查询参数,包含字段选择、WHERE 条件、排序规则和分页参数
/// - `pool`:数据库连接池引用(预留,暂未使用)
///
/// # 示例
///
/// ```rust,ignore
/// use yang_base::table::{Field, SortOrder, Table};
/// use std::sync::Arc;
/// use serde_json::json;
///
/// let table = Table::new("users")
/// .fields(vec![Field::id("id"), Field::string("name", 50)])
/// .build()?;
/// let query = table.bind(Arc::new(pool)).query(["admin"]);
///
/// // 选择字段
/// let query = query.select_fields(&["id", "name"])?;
///
/// // 添加 WHERE 条件
/// let query = query.where_eq("status", json!(1))?;
///
/// // 添加排序
/// let query = query.order_by("created_at", SortOrder::Desc)?;
///
/// // 设置分页
/// let query = query.page(1, 20)?;
/// ```