Struct BatchLoader 

pub struct BatchLoader<K, V>
where
    K: Hash + Eq + Clone + Send + Sync,
    V: Clone + Send + Sync,
{ /* private fields */ }

批量加载器

将 N 个单条加载请求合并为 ⌈N/batch_size⌉ 次批量加载，避免 N+1 查询问题。

泛型参数

• K：主键类型（必须实现 Hash + Eq + Clone）
• V：值类型

示例

use sz_orm_query::entity_graph::BatchLoader;
use std::collections::HashMap;

fn load_users(ids: &[i64]) -> HashMap<i64, String> {
    ids.iter().map(|id| (*id, format!("user_{}", id))).collect()
}

let loader = BatchLoader::new(100, Box::new(load_users));
let users = loader.load_many(&[1, 2, 3]);
assert_eq!(users.len(), 3);

Implementations

impl<K, V> BatchLoader<K, V>

where K: Hash + Eq + Clone + Send + Sync, V: Clone + Send + Sync,

pub fn new( batch_size: usize, loader: Box<dyn Fn(&[K]) -> HashMap<K, V> + Sync + Send>, ) -> BatchLoader<K, V>

创建批量加载器

参数

• batch_size：每批数量
• loader：实际加载函数，接收一批 key，返回 key→value 的 HashMap

pub fn load_many(&self, keys: &[K]) -> HashMap<K, V>

批量加载多个 key

• 自动跳过缓存中已有的 key
• 按 batch_size 分批调用 loader
• 返回所有 key 对应的 value（包含缓存与新加载的）

pub fn load_one(&self, key: &K) -> Option<V>

加载单个 key（便捷方法）

pub fn clear_cache(&self)

清空缓存

pub fn cache_size(&self) -> usize

返回当前缓存大小

pub fn batch_size(&self) -> usize

返回 batch_size