Skip to main content

LambdaQueryWrapper

Struct LambdaQueryWrapper 

Source
pub struct LambdaQueryWrapper<T> {
    pub inner: AbstractWrapper,
    pub func: FuncSegments,
    /* private fields */
}
Expand description

基于类型安全列引用的查询构建器(对标 Java LambdaQueryWrapper<T>)。

使用 Column<F> 替代字符串列名,编译期保证列名正确性。 列引用通常由 #[derive(TableName)] 宏自动生成。

§对应 Java

  • com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper<T>
  • com.baomidou.mybatisplus.core.conditions.AbstractLambdaWrapper<T, Children>

§Example

ⓘ
use rbatis_plus::core::conditions::query::LambdaQueryWrapper;

// 假设 User 已 derive TableName,生成了 User::column_name() 等方法
let w = LambdaQueryWrapper::<User>::new()
    .eq(User::column_name(), "Alice")
    .ge(User::column_age(), 18)
    .order_by_desc(User::column_create_time());

let sql = w.build_select_sql("sys_user");
// SELECT * FROM sys_user WHERE name = 'Alice' AND age >= 18 ORDER BY create_time DESC

Fields§

§inner: AbstractWrapper

内部条件构建状态。

§func: FuncSegments

GROUP BY / ORDER BY / HAVING 状态。

Implementations§

Source§

impl<T> LambdaQueryWrapper<T>

Source

pub fn new() -> LambdaQueryWrapper<T>

创建空的 Lambda 查询构建器。

Source

pub fn select<F>(&mut self, column: Column<F>) -> &mut LambdaQueryWrapper<T>

设置查询字段(类型安全列引用)。

对应 Java LambdaQueryWrapper.select(SFunction...)

Source

pub fn select_columns(&mut self, columns: &[&str]) -> &mut LambdaQueryWrapper<T>

批量设置查询字段。

Source

pub fn eq<F>( &mut self, column: Column<F>, value: impl Into<Value>, ) -> &mut LambdaQueryWrapper<T>

column = value(等值比较)

对应 Java AbstractWrapper.eq(boolean condition, R column, Object val)

Source

pub fn if_eq<F>( &mut self, condition: bool, column: Column<F>, value: impl Into<Value>, ) -> &mut LambdaQueryWrapper<T>

条件等值比较 — 仅当 condition 为 true 时生效。

Source

pub fn ne<F>( &mut self, column: Column<F>, value: impl Into<Value>, ) -> &mut LambdaQueryWrapper<T>

column <> value(不等比较)

对应 Java AbstractWrapper.ne(...)

Source

pub fn if_ne<F>( &mut self, condition: bool, column: Column<F>, value: impl Into<Value>, ) -> &mut LambdaQueryWrapper<T>

条件不等比较。

Source

pub fn gt<F>( &mut self, column: Column<F>, value: impl Into<Value>, ) -> &mut LambdaQueryWrapper<T>

column > value(大于)

对应 Java AbstractWrapper.gt(...)

Source

pub fn if_gt<F>( &mut self, condition: bool, column: Column<F>, value: impl Into<Value>, ) -> &mut LambdaQueryWrapper<T>

条件大于比较。

Source

pub fn ge<F>( &mut self, column: Column<F>, value: impl Into<Value>, ) -> &mut LambdaQueryWrapper<T>

column >= value(大于等于)

对应 Java AbstractWrapper.ge(...)

Source

pub fn if_ge<F>( &mut self, condition: bool, column: Column<F>, value: impl Into<Value>, ) -> &mut LambdaQueryWrapper<T>

条件大于等于比较。

Source

pub fn lt<F>( &mut self, column: Column<F>, value: impl Into<Value>, ) -> &mut LambdaQueryWrapper<T>

column < value(小于)

对应 Java AbstractWrapper.lt(...)

Source

pub fn if_lt<F>( &mut self, condition: bool, column: Column<F>, value: impl Into<Value>, ) -> &mut LambdaQueryWrapper<T>

条件小于比较。

Source

pub fn le<F>( &mut self, column: Column<F>, value: impl Into<Value>, ) -> &mut LambdaQueryWrapper<T>

column <= value(小于等于)

对应 Java AbstractWrapper.le(...)

Source

pub fn if_le<F>( &mut self, condition: bool, column: Column<F>, value: impl Into<Value>, ) -> &mut LambdaQueryWrapper<T>

条件小于等于比较。

Source

pub fn between<F>( &mut self, column: Column<F>, val1: impl Into<Value>, val2: impl Into<Value>, ) -> &mut LambdaQueryWrapper<T>

column BETWEEN val1 AND val2

对应 Java AbstractWrapper.between(...)

Source

pub fn if_between<F>( &mut self, condition: bool, column: Column<F>, val1: impl Into<Value>, val2: impl Into<Value>, ) -> &mut LambdaQueryWrapper<T>

条件 BETWEEN。

Source

pub fn not_between<F>( &mut self, column: Column<F>, val1: impl Into<Value>, val2: impl Into<Value>, ) -> &mut LambdaQueryWrapper<T>

column NOT BETWEEN val1 AND val2

对应 Java AbstractWrapper.notBetween(...)

Source

pub fn if_not_between<F>( &mut self, condition: bool, column: Column<F>, val1: impl Into<Value>, val2: impl Into<Value>, ) -> &mut LambdaQueryWrapper<T>

条件 NOT BETWEEN。

Source

pub fn eq_or_is_null<F>( &mut self, column: Column<F>, value: impl Into<Value>, ) -> &mut LambdaQueryWrapper<T>

column = value OR column IS NULL

对应 Java AbstractWrapper.eqOrIsNull(...)

Source

pub fn like<F>( &mut self, column: Column<F>, value: &str, ) -> &mut LambdaQueryWrapper<T>

column LIKE '%value%'(模糊匹配)

对应 Java AbstractWrapper.like(...)

Source

pub fn if_like<F>( &mut self, condition: bool, column: Column<F>, value: &str, ) -> &mut LambdaQueryWrapper<T>

条件 LIKE。

Source

pub fn not_like<F>( &mut self, column: Column<F>, value: &str, ) -> &mut LambdaQueryWrapper<T>

column NOT LIKE '%value%'

对应 Java AbstractWrapper.notLike(...)

Source

pub fn if_not_like<F>( &mut self, condition: bool, column: Column<F>, value: &str, ) -> &mut LambdaQueryWrapper<T>

条件 NOT LIKE。

Source

pub fn like_right<F>( &mut self, column: Column<F>, value: &str, ) -> &mut LambdaQueryWrapper<T>

column LIKE 'value%'(右匹配)

对应 Java AbstractWrapper.likeRight(...)

Source

pub fn if_like_right<F>( &mut self, condition: bool, column: Column<F>, value: &str, ) -> &mut LambdaQueryWrapper<T>

条件右匹配 LIKE。

Source

pub fn like_left<F>( &mut self, column: Column<F>, value: &str, ) -> &mut LambdaQueryWrapper<T>

column LIKE '%value'(左匹配)

对应 Java AbstractWrapper.likeLeft(...)

Source

pub fn if_like_left<F>( &mut self, condition: bool, column: Column<F>, value: &str, ) -> &mut LambdaQueryWrapper<T>

条件左匹配 LIKE。

Source

pub fn is_null<F>(&mut self, column: Column<F>) -> &mut LambdaQueryWrapper<T>

column IS NULL

对应 Java AbstractWrapper.isNull(...)

Source

pub fn if_is_null<F>( &mut self, condition: bool, column: Column<F>, ) -> &mut LambdaQueryWrapper<T>

条件 IS NULL。

Source

pub fn is_not_null<F>( &mut self, column: Column<F>, ) -> &mut LambdaQueryWrapper<T>

column IS NOT NULL

对应 Java AbstractWrapper.isNotNull(...)

Source

pub fn if_is_not_null<F>( &mut self, condition: bool, column: Column<F>, ) -> &mut LambdaQueryWrapper<T>

条件 IS NOT NULL。

Source

pub fn in_values<F>( &mut self, column: Column<F>, values: Vec<Value>, ) -> &mut LambdaQueryWrapper<T>

column IN (v1, v2, ...)

对应 Java AbstractWrapper.in(...)

Source

pub fn if_in_values<F>( &mut self, condition: bool, column: Column<F>, values: Vec<Value>, ) -> &mut LambdaQueryWrapper<T>

条件 IN。

Source

pub fn not_in<F>( &mut self, column: Column<F>, values: Vec<Value>, ) -> &mut LambdaQueryWrapper<T>

column NOT IN (v1, v2, ...)

对应 Java AbstractWrapper.notIn(...)

Source

pub fn if_not_in<F>( &mut self, condition: bool, column: Column<F>, values: Vec<Value>, ) -> &mut LambdaQueryWrapper<T>

条件 NOT IN。

Source

pub fn in_sql<F>( &mut self, column: Column<F>, sql: &str, ) -> &mut LambdaQueryWrapper<T>

column IN (subquery)

对应 Java AbstractWrapper.inSql(...)

Source

pub fn not_in_sql<F>( &mut self, column: Column<F>, sql: &str, ) -> &mut LambdaQueryWrapper<T>

column NOT IN (subquery)

对应 Java AbstractWrapper.notInSql(...)

Source

pub fn group_by(&mut self, columns: &[&str]) -> &mut LambdaQueryWrapper<T>

GROUP BY 多列(类型安全列引用,支持混合字段类型)。

对应 Java AbstractWrapper.groupBy(boolean condition, R... columns)

因为 Rust 泛型不允许 slice 中混合不同类型,此方法接受列名字符串切片。 推荐配合 derive 宏生成的 COLUMN_* 常量使用。

Source

pub fn order_by<F>( &mut self, column: Column<F>, is_asc: bool, ) -> &mut LambdaQueryWrapper<T>

ORDER BY(类型安全列引用)。

对应 Java AbstractWrapper.orderBy(boolean condition, boolean isAsc, R... columns)

Source

pub fn order_by_asc<F>( &mut self, column: Column<F>, ) -> &mut LambdaQueryWrapper<T>

ORDER BY ASC(类型安全列引用)。

Source

pub fn order_by_desc<F>( &mut self, column: Column<F>, ) -> &mut LambdaQueryWrapper<T>

ORDER BY DESC(类型安全列引用)。

Source

pub fn having(&mut self, sql: &str) -> &mut LambdaQueryWrapper<T>

HAVING 子句。

对应 Java AbstractWrapper.having(...)

Source

pub fn or(&mut self) -> &mut LambdaQueryWrapper<T>

下一个条件用 OR 连接。

对应 Java AbstractWrapper.or()

Source

pub fn and_group(&mut self, inner_sql: &str) -> &mut LambdaQueryWrapper<T>

AND (sub-conditions)

对应 Java AbstractWrapper.and(...)

Source

pub fn or_group(&mut self, inner_sql: &str) -> &mut LambdaQueryWrapper<T>

OR (sub-conditions)

对应 Java AbstractWrapper.or(Consumer) — 字符串版本

Source

pub fn nested(&mut self, inner_sql: &str) -> &mut LambdaQueryWrapper<T>

嵌套条件 AND (conditions)

对应 Java AbstractWrapper.nested(...)

Source

pub fn not_group(&mut self, inner_sql: &str) -> &mut LambdaQueryWrapper<T>

NOT (sub-conditions)

对应 Java AbstractWrapper.not(...)

Source

pub fn apply(&mut self, sql: &str) -> &mut LambdaQueryWrapper<T>

自定义 SQL 片段拼接。

对应 Java AbstractWrapper.apply(...)

Source

pub fn exists(&mut self, sql: &str) -> &mut LambdaQueryWrapper<T>

EXISTS (subquery)

对应 Java AbstractWrapper.exists(...)

Source

pub fn not_exists(&mut self, sql: &str) -> &mut LambdaQueryWrapper<T>

NOT EXISTS (subquery)

对应 Java AbstractWrapper.notExists(...)

Source

pub fn last(&mut self, sql: &str) -> &mut LambdaQueryWrapper<T>

追加 SQL 到末尾(如 LIMIT 1)。

对应 Java AbstractWrapper.last(...)

Source

pub fn comment(&mut self, sql: &str) -> &mut LambdaQueryWrapper<T>

SQL 注释(前置)。

对应 Java AbstractWrapper.comment(...)

Source

pub fn first(&mut self, sql: &str) -> &mut LambdaQueryWrapper<T>

SQL first(最前置)。

对应 Java AbstractWrapper.first(...)

Source

pub fn build_select_sql(&self, table_name: &str) -> String

构建完整 SELECT SQL。

对应 Java QueryWrapper.getSqlSelect() → SqlUtils.SqlSegment

Source

pub fn build_count_sql(&self, table_name: &str) -> String

构建 COUNT SQL(用于分页)。

Source

pub fn params(&self) -> &[Value]

返回绑定参数。

Source

pub fn clear(&mut self)

清空所有条件。

Trait Implementations§

Source§

impl<T> Clone for LambdaQueryWrapper<T>
where T: Clone,

Source§

fn clone(&self) -> LambdaQueryWrapper<T>

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

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

Performs copy-assignment from source. Read more
Source§

impl<T> Debug for LambdaQueryWrapper<T>
where T: Debug,

Source§

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

Formats the value using the given formatter. Read more
Source§

impl<T> Default for LambdaQueryWrapper<T>

Source§

fn default() -> LambdaQueryWrapper<T>

Returns the “default value” for a type. Read more

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = !

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, !>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.