Struct SelectQuery 

pub struct SelectQuery { /* private fields */ }

SELECT 查询构造器

Implementations

impl SelectQuery

pub fn new() -> Self

创建空的 SELECT 查询

pub fn distinct(self) -> Self

设置 DISTINCT

pub fn column(self, name: &str) -> Self

添加列

pub fn columns(self, names: &[&str]) -> Self

添加多个列

pub fn all_columns(self) -> Self

添加 * 列

pub fn from(self, table: &str) -> Self

设置 FROM 表

pub fn inner_join(self, table: &str, on: &str) -> Self

添加 INNER JOIN

安全性（门禁 9 修复）

表名经 quote_ident() 转义。on 条件为表达式，调用方应确保不使用恶意输入构造。

pub fn left_join(self, table: &str, on: &str) -> Self

添加 LEFT JOIN

安全性（门禁 9 修复）

同 inner_join，表名经 quote_ident() 转义。

pub fn right_join(self, table: &str, on: &str) -> Self

添加 RIGHT JOIN

安全性（门禁 9 修复）

同 inner_join，表名经 quote_ident() 转义。

pub fn where_clause(self, condition: &str) -> Self

添加 WHERE 条件（AND 连接）

安全性（v0.2.2 修复 C-6）

调用 check_where_injection 检测高危模式（分号+SQL 关键字、行注释、块注释）。 复杂 WHERE 条件应使用参数化查询 API，避免直接拼接字符串。

pub fn or_where(self, condition: &str) -> Self

添加 OR WHERE 条件

安全性（v0.2.2 修复 C-6）

同 where_clause，调用 check_where_injection 检测高危模式。

pub fn group_by(self, column: &str) -> Self

添加 GROUP BY

pub fn having(self, condition: &str) -> Self

添加 HAVING

pub fn order_by(self, column: &str, asc: bool) -> Self

添加 ORDER BY

参数

• column: 列名
• asc: true=ASC, false=DESC

pub fn limit(self, n: u64) -> Self

设置 LIMIT

pub fn offset(self, n: u64) -> Self

设置 OFFSET

pub fn paginate(self, page: u64, size: u64) -> Self

生成分页（同时设置 LIMIT 和 OFFSET）

参数

• page: 页码（从 1 开始）
• size: 每页大小

pub fn build(self, db_type: DbType) -> String

生成 SQL

参数

• db_type: 数据库类型，用于选择方言

Trait Implementations

impl Clone for SelectQuery

fn clone(&self) -> SelectQuery

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for SelectQuery

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for SelectQuery

fn default() -> SelectQuery

Returns the “default value” for a type.