Struct RuntimeManager

pub struct RuntimeManager<R>
where
    R: VmRuntime + Send + Sync + 'static,
{ /* private fields */ }

运行时管理器

• 🎯在一个数据结构中封装「虚拟机运行时」与「配置信息」
• 📌只负责单个运行时的运行管理
  • 🚩不负责「终止、重启运行时」等过程

Implementations

impl<R> RuntimeManager<R>

where R: VmRuntime + Send + Sync + 'static,

pub fn new(runtime: R, config: RuntimeConfig) -> Self

构造函数

• 🎯由此接管虚拟机实例、配置的所有权

pub fn manage(&mut self) -> Result<Result<()>>

【主函数】在运行时启动后，对其进行管理

• 🎯健壮性：更多「警告/重来」而非panic
• 🎯用户友好：尽可能隐藏底层内容
  • 如错误堆栈
• 📌主要逻辑
  • .nal脚本预加载
  • 用户的运行时交互
  • Websocket服务端
• 🚩【2024-04-03 00:33:41】返回的Result作为程序的终止码
  • Ok(Ok(..)) ⇒ 程序正常终止
  • Ok(Err(..)) ⇒ 程序异常终止
  • Err(..) ⇒ 程序异常中断

pub fn prelude_nal(&mut self) -> ControlFlow<Result<()>, Result<()>>

预置NAL

• 🎯用于自动化调取.nal文件进行测试
• 🚩【2024-04-03 10:28:18】使用ControlFlow对象以控制「是否提前返回」和「返回的结果」
  • 📌Continue => 使用「警告&忽略」的方式处理Result => 继续（用户输入/Websocket服务端）
  • 📌Break => 告知调用者「需要提前结束」
    • 📌Break => 正常退出
    • 📌Break => 异常退出（报错）

pub fn spawn_read_output(&mut self) -> Result<JoinHandle<Result<()>>>

生成「读取输出」子线程

pub fn try_spawn_ws_server(&mut self) -> Result<Option<JoinHandle<Result<()>>>>

生成「Websocket服务」子线程

pub fn spawn_user_input(&mut self) -> Result<JoinHandle<Result<()>>>

生成「用户输入」子线程

pub fn input_line_to_vm( runtime: &mut R, line: &str, config: &RuntimeConfig, output_cache: &mut OutputCache, nal_root_path: &Path, ) -> Result<()>

置入一行输入

• 📄nal_root_path：从NAL文件加载⇒NAL文件所在路径；用户输入⇒配置文件所在路径

Trait Implementations

impl<R> Clone for RuntimeManager<R>

where R: VmRuntime + Send + Sync + 'static + Clone,

fn clone(&self) -> RuntimeManager<R>

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<R> Debug for RuntimeManager<R>

where R: VmRuntime + Send + Sync + 'static + Debug,

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.