Skip to main content

Module executor

Module executor 

Source
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
一个行模型的通用执行器:预览 / 导入 / 导出 / 模板的统一入口
ExecutorConfigEntry
执行器的模型级默认配置(executor_config! 链接期注册,按注册名关联)
ExecutorEntry
注册表条目:#[derive(ExcelExecutor)] 自动提交

Traits§

ErasedExecutor
擦除具体类型后的执行器(按名调度用:预览 / 按名导入 / 按名导出 / 模板)
ExcelExecutor
行模型注册契约:#[derive(ExcelExecutor)] 生成实现
JsonBatchSink
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
已注册的注册名清单