Expand description
执行器:注册一次,全链路通用(预览 / 导入 / 导出 / 模板)
业务端只需在行模型上挂 #[derive(ExcelExecutor)](配合 #[excel(register = "...")]),
本模块会自动生成该模型的执行器工厂并静态注册进全局表(inventory 链接期收集,
无需任何启动初始化代码),随后按类型或按注册名统一调用:
use serde::{Deserialize, Serialize};
use fast_excel::{ExcelExecutor, ExcelRow, ZipSource};
#[derive(ExcelRow, ExcelExecutor, Serialize, Deserialize)]
#[excel(sheet = "产品导入", register = "product")]
struct ProductRow {
#[excel(header = "品名", required)]
name: String,
}
let source = ZipSource::open("products.xlsx")?;
// ① 按类型调用(编译期保证类型安全)
let exec = fast_excel::executor_for::<ProductRow>();
let preview = exec.preview(source.clone(), 200)?;
let report = exec.commit(source.clone(), sink).await?;
let bytes = exec.export_bytes(&products())?;
// ② 按注册名字符串调度(Web 层按请求参数路由)
let erased = fast_excel::executor_by_name("product").expect("已注册");
let json = erased.preview(source, 200)?;Structs§
- Executor
- 一个行模型的通用执行器:预览 / 导入 / 导出 / 模板的统一入口
- Executor
Config Entry - 执行器的模型级默认配置(
executor_config!链接期注册,按注册名关联) - Executor
Entry - 注册表条目:
#[derive(ExcelExecutor)]自动提交
Traits§
- Erased
Executor - 擦除具体类型后的执行器(按名调度用:预览 / 按名导入 / 按名导出 / 模板)
- Excel
Executor - 行模型注册契约:
#[derive(ExcelExecutor)]生成实现 - Json
Batch Sink - JSON 批次落库:按名调度的 sink(把每批模型以 JSON 数组交给业务)
Functions§
- commit_
json_ by_ name - 按注册名导入(JSON 边界);未注册返回
Ok(None) - executor_
by_ name - 按注册名创建擦除类型的执行器(preview 返回 JSON,适合 Web 层按请求参数路由)
- executor_
config_ entry - 按注册名查配置
- executor_
entry - 按注册名查条目
- executor_
for - 按类型获取注册模型的通用执行器(自动创建,业务端无需管理工厂)
- export_
bytes_ by_ name - 按注册名导出(JSON 行数组 → xlsx 字节);未注册返回
Ok(None) - identity_
import_ runner - 导入配置恒等函数(宏缺省时用)
- identity_
sheet_ options - 导出配置恒等函数(宏缺省时用)
- preview_
by_ name - 按注册名直接预览,返回 JSON;未注册返回
Ok(None) - registered_
executors - 已注册的全部执行器条目
- registered_
names - 已注册的注册名清单