mongo-collection 0.3.3

A trait and derive macro for mapping Rust types to MongoDB collections with automatic pluralization
Documentation
use serde::{Deserialize, Serialize};
use smart_default::SmartDefault;
use std::collections::HashMap;

use crate::query::SortOrder;

#[cfg(feature = "openapi")]
use utoipa::{IntoParams, ToSchema};

/// 列表查询参数
#[derive(Debug, Clone, SmartDefault, Deserialize)]
#[cfg_attr(feature = "openapi", derive(ToSchema, IntoParams))]
#[serde(default)]
pub struct ListQuery {
    /// 排序字段(如 "created_at"、"name")
    pub sort_by: Option<String>,
    /// 排序方向
    #[default(_code = "SortOrder::Desc")]
    pub sort_order: SortOrder,
    /// 全局搜索关键词
    pub search: Option<String>,
    /// 字段级筛选
    #[serde(flatten)]
    pub filters: Option<HashMap<String, String>>,
}

impl ListQuery {
    pub fn parsed_filters(&self) -> Option<HashMap<String, String>> {
        if let Some(ref raw_filters) = self.filters {
            let mut filters = HashMap::new();
            for (key, value) in raw_filters {
                // 解析 filters[key] 格式
                if let Some(k) = key
                    .strip_prefix("filters[")
                    .and_then(|s| s.strip_suffix("]"))
                {
                    filters.insert(k.to_string(), value.to_string());
                }
                // 解析 filters.key 格式
                else if let Some(k) = key.strip_prefix("filters.") {
                    filters.insert(k.to_string(), value.to_string());
                }
            }
            return Some(filters);
        }
        None
    }
}

/// 列表数据响应
#[derive(Debug, Clone, Serialize)]
#[cfg_attr(feature = "openapi", derive(ToSchema))]
#[cfg_attr(feature = "openapi", schema(bound = "T: ToSchema"))]
pub struct ListData<T> {
    /// 数据列表
    pub items: Vec<T>,
    /// 总记录数
    pub total_count: u64,
}

impl<T> ListData<T> {
    /// 创建新的列表数据
    pub fn new(items: Vec<T>) -> Self {
        Self {
            total_count: items.len() as u64,
            items,
        }
    }

    /// 转换数据类型
    ///
    /// 使用泛型闭包对每个元素进行转换
    pub fn map<P, F>(self, f: F) -> ListData<P>
    where
        F: FnMut(T) -> P,
    {
        ListData {
            items: self.items.into_iter().map(f).collect(),
            total_count: self.total_count,
        }
    }

    /// 转换数据类型(可能失败)
    ///
    /// 使用泛型闭包对每个元素进行转换,转换可能失败
    pub fn try_map<P, E, F>(self, f: F) -> Result<ListData<P>, E>
    where
        F: FnMut(T) -> Result<P, E>,
    {
        Ok(ListData {
            items: self
                .items
                .into_iter()
                .map(f)
                .collect::<Result<Vec<_>, _>>()?,
            total_count: self.total_count,
        })
    }
}