Rust / 系统课时

设计数据模型

设计数据模型

一个小型 Rust 工具如果先把配置、命令、成功结果和失败状态建模清楚,后续流程会明显更简单。本课用结构体承载稳定字段,用枚举表达互斥分支,让类型本身约束程序可以出现的状态。

学习目标

  • 用结构体表达配置和处理结果等“字段固定”的数据
  • 用枚举表达命令变体和错误状态等“互斥选择”
  • 通过类型边界减少无效组合,并为后续错误传播准备统一接口

先按职责拆开数据

配置描述“程序如何工作”,命令参数描述“这次要做什么”,处理结果描述“做完得到了什么”。三者虽然都可能包含数字或字符串,但生命周期和职责不同,最好不要塞进同一个大结构体。

例如,Config 可以保存最小长度、是否忽略空行等稳定选项;Command 用不同变体表示统计或预览;ProcessResult 只保存业务结果。这样函数签名能直接说明自己依赖哪类数据,也更容易单独测试。

配置、命令、结果与错误类型的职责关系

用枚举消除无效组合

如果把所有命令参数都放进一个结构体,统计命令可能被迫携带只属于预览命令的 lines 字段。枚举可以把每种命令所需字段绑定在对应变体上,因此不存在“命令是 Count,但又带着 Preview 专属参数”的无效状态。

错误也适合用枚举。I/O 失败和参数非法的来源、处理方式不同,把它们区分成不同变体后,上层既可以统一返回 AppError,也可以在需要时精确匹配具体错误。

建立最小可运行模型

下面的程序只演示数据模型,不负责真正解析命令行。它创建配置、命令、成功结果和错误值,并通过 Debug 输出确认每个类型保存的数据。

rust
#![allow(dead_code)]

#[derive(Debug, Clone)]
struct Config {
    ignore_blank: bool,
    min_len: usize,
}

#[derive(Debug)]
enum Command {
    Count { path: String },
    Preview { path: String, lines: usize },
}

#[derive(Debug)]
struct ProcessResult {
    matched: usize,
    total: usize,
}

#[derive(Debug)]
enum AppError {
    Io(std::io::Error),
    InvalidArgument(String),
}

impl From<std::io::Error> for AppError {
    fn from(error: std::io::Error) -> Self {
        Self::Io(error)
    }
}

fn main() {
    let config = Config {
        ignore_blank: true,
        min_len: 3,
    };
    let command = Command::Count {
        path: "input.txt".to_string(),
    };
    let result = ProcessResult {
        matched: 7,
        total: 10,
    };
    let error = AppError::InvalidArgument(
        "min_len must be greater than 0".to_string(),
    );

    println!("config = {config:?}");
    println!("command = {command:?}");
    println!("result = {result:?}");
    println!("error = {error:?}");
}

预期输出

text
config = Config { ignore_blank: true, min_len: 3 }
command = Count { path: "input.txt" }
result = ProcessResult { matched: 7, total: 10 }
error = InvalidArgument("min_len must be greater than 0")

实际编译器版本可能影响警告文本,但上面的标准输出保持一致。

给后续流程留出稳定边界

真正实现处理函数时,可以让它接收 &Config 和具体命令参数,再返回 Result<ProcessResult, AppError>。其中 From<std::io::Error> for AppError 很重要:它允许后续代码对 I/O 操作直接使用 ?,同时仍保持统一的业务错误类型。

当结构体负责承载稳定字段、枚举负责表达互斥分支、Result 负责区分成功与失败后,核心处理流程就可以围绕这些类型展开,而不必反复检查大量彼此冲突的布尔值或可选字段。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

设计数据模型

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通