谢谢

• Marc Cámara 为添加不区分大小写的支持和Postgresql的with-ilike支持表示感谢。 PR #3
• Andrii Yermakov 为修复“数字的null操作符” PR #2

快速概述

/// This is the model entity, annotated with Fields.
#[derive(Debug, Clone, modql::field::Fields, FromRow, Serialize)]
pub struct Task {
    pub id: i64,
    pub project_id: i64,

    pub title: String,
    pub done: bool,
}

/// This is a Filter, with the modql::filter::OpVals... properties
#[derive(modql::filter::FilterNodes, Deserialize, Default, Debug)]
pub struct TaskFilter {
    project_id: Option<OpValsInt64>,
    title: Option<OpValsString>,
    done: Option<OpValsBool>,
}

// -- Parsing JSON representation to TaskFilter
// This condition requires all of these rules to match (AND).
let list_filter: TaskFilter = serde_json::from_value(json! ({
    "project_id": 123,
    "title": {"$startsWith": "Hello", "$contains": "World"} ,
}))?;

// -- modql ListOptions
let list_options: modql::filter::ListOptions =
    serde_json::from_value(json! ({
        "offset": 0,
        "limit": 2,
        "order_bys": "!title" // ! for descending
    }))?;

// -- Building a sea-query select query with those condition
// Convert the TaskFilter into sea-query condition
let cond: sea_query::Condition = filter.try_into()?;
let mut query = sea_query::Query::select();

// Select only the columns corresponding to the task type.
// This is determined by the modql::field::Fields annotation.
query.from(task_table).columns(Task::sea_column_refs());

// Add the condition from the filter
query.cond_where(cond);

// Apply the list options
list_options.apply_to_sea_query(&mut query);

// and execute query
let (sql, values) = query.build_sqlx(PostgresQueryBuilder);
let entities = sqlx::query_as_with::<_, E, _>(&sql, values)
    .fetch_all(db)
    .await?;

此crate对JSON-RPC或其他类型的模型API（例如，joql模式）非常有用。

重要 v0.3.x代表modql的新版本，具有with-sea-query功能集。它在rust10x网络应用程序生产代码蓝图第02集中得到了应用。这个版本与v0.2.x版本在一定程度上不兼容，主要是由于模块重组。如果您正在使用rust10x/awesomeapp桌面应用程序，请暂时继续使用v0.2.x版本。我计划不久后将代码库升级到v0.3.x版本。

变更日志

OpVal[Type] 条件运算符

OpVal[Type]是一个过滤器单元，允许对指定类型的给定值表达运算符。

对应的OpVals[Type]（带有“s”），通常用于过滤属性，因为它允许对同一字段使用多个运算符。

OpVal[Type]的基本JSON表示形式遵循{field_name: {$operator1: value1, $operator2: value2}}格式。例如

{
    "title": {"$startsWith": "Hello", "$contains": "World"}
}

这表示“startsWith”和“contains”都必须满足的条件。

以下表格显示了每种类型的可能运算符列表。

OpValString 运算符

OpValInt32, OpValInt64, OpValFloat64运算符

OpValBool运算符

更多信息

• modql::filter - 提供一个可从JSON反序列化的声明性结构。
• modql::field - 提供在结构上获取字段信息的方法。启用with-sea-query特性会从标准结构和派生中添加与sea-query兼容的数据结构。

#[derive(modql::field::Fields)提供以下功能

• Task::field_names()返回结构体的属性名。它可以由#[field(name="another_name")]属性属性重写。
• Task::field_refs() 返回用于属性的 FieldRef { name: &'static str, rel: Option<&'static str>}。其中，rel 作用如同表名，可以在结构体级别设置为 #[modql(rel="some_table_name")]，或在字段级别设置为 #[field(rel="special_rel_name")]。

pub type Result<T> = core::result::Result<T, Error>;
pub type Error = Box<dyn std::error::Error>; // For early dev.
use modql::filter::{FilterGroups, FilterNode, OpValtring};

fn main() -> Result<()> {
    let filter_nodes: Vec<FilterNode> = vec![
        (
            "title",
            OpValtring::ContainsAny(vec!["Hello".to_string(), "welcome".to_string()]),
        )
            .into(),
        ("done", true).into(),
    ];
    let filter_groups: FilterGroups = filter_nodes.into();

    println!("filter_groups:\n{filter_groups:#?}");

    Ok(())
}