- 使用回退机制处理程序的错误情况 -
- -## 书接上文 - - 在上文中，我们介绍了如何使用 **Mingling** 开发基本的命令行程序：你可以使用 `"greet"` 子命令输出 `"Hello, World!"`，也可以使用 `"greet Alice"` 输出 `"Hello, Alice!"` - - 而当用户并未输入 `"greet"` 时呢？让我们键入命令尝试一下 ⌨️ - -```bash -~> your-bin hello -~> your-bin hello Alice -``` - - **它没有任何反应！** 👆 - - 让我来解释为什么：**Mingling** 不自作主张，无论发生什么它都不会输出内容到终端（除了 `unwind` 下的 `panic!`） - - 这意味着，如果您需要在命令行程序出错时能够主动地做些什么，你就得显式声明。 - - 好在 **Mingling** 提供了较为方便的接口实现该功能：在 `gen_program!` 宏中，会生成两个 `FallBack` 类型 - -|类型|发生时机|发生方式| -|-|-|-| -|RendererNotFound|调度无法找到的渲染器时|作为 `Chain` 调度| -|DispatcherNotFound|输入命令但无法匹配分发器|作为 `Chain` 调度| - -### `DispatcherNotFound` 类型 - - 首先让我们关注 `DispatcherNotFound` 类型，它的产生方式如下： - -```rust -// 1. 定义 `greet` 命令 -dispatcher!("greet", GreetCommand => GreetEntry); - -fn main() { - // ->> 用户输入 "hello Alice" - let mut program = ThisProgram::new(); - - // 2. 导入 `greet` 命令 - program.with_dispatcher(GreetCommand); - - // 3. 执行程序 - program.exec(); -} - -// ... - -// 5. 接收 DispatcherNotFound 调度 -#[renderer] -fn dispatcher_not_found(prev: DispatcherNotFound) { - // 6. 输出 - r_println!( - "Cannot match any command! Current input: \"{}\"", - prev.join(" ") - ); -} - -// 4. 无法匹配到任何名为 `hello` 的分发器 -// 将用户参数原样分发到 DispatcherNotFound -gen_program!(); -``` - - 上述程序的运行效果为： - -```bash -~> omg hello -Cannot match any command! Current input: "hello" - -~> omg hello Alice -Cannot match any command! Current input: "hello Alice" -``` - - 现在若用户输入了不匹配的命令，**Mingling** 将会输出对应的内容！ - -## `RendererNotFound` 类型 - - `RendererNotFound` 有两种可能产生： - - 1. 该类型被显式分发到了 `Renderer` (使用 `.to_render()` 函数)，但是该类型未实现渲染器 - 2. 该类型被分发到了 `Chain`，但是该类型未实现链，也未实现渲染器 - - 一般来说，`RendererNotFound` **不应该在业务逻辑中产生**：它被调度意味着您的类型需要被渲染但是并不能被渲染。您可以使用该类型来定位哪个类型缺失渲染器实现 ✏️ - -```rust -dispatcher!("greet", GreetCommand => GreetEntry); - -fn main() { - let mut program = ThisProgram::new(); - - program.with_dispatcher(GreetCommand); - program.exec(); -} - -pack!(ResultGreetSomeone = String); - -#[chain] -fn handle_greet_entry(prev: GreetEntry) -> Next { - let args = prev.inner; - let name = args.first().cloned().unwrap_or_else(|| "World".to_string()); - - ResultGreetSomeone::new(name) -} - -// 让我们故意去除 `ResultGreetSomeone` 类型的渲染器实现 -// #[renderer] -// fn render_greet_someone(prev: ResultGreetSomeone) { -// r_println!("Hello, {}!", *prev); -// } - -#[renderer] -fn renderer_not_found(prev: RendererNotFound) { - if *prev == "DispatcherNotFound" { - return; // 排除 "DispatcherNotFound" 类型 - } - - // 当未找到渲染器时触发 `panic!` - panic!("Renderer \"{}\" not found!", *prev); -} - -gen_program!(); - -``` - - 上述程序的运行效果为： - -```bash -~> your-bin greet Alice - -thread 'main' (90772) panicked at src/bin/your-bin.rs:30:5: -Renderer "ResultGreetSomeone" not found! -note: run with `RUST_BACKTRACE=1` environment variable to display a backtrace -``` - - 以上便是 **Mingling** 的回退机制，在接下来的章节中，您将学习如何使用 `Picker` 解析复杂的用户输入。 - -- Written by @Weicao-CatilGrass -
-- cgit