Skip to main content

mysql_handler/runtime/
context.rs

1// Copyright (C) 2026 ren-yamanashi
2//
3// This program is free software; you can redistribute it and/or modify
4// it under the terms of the GNU General Public License, version 2.0,
5// as published by the Free Software Foundation.
6//
7// This program is designed to work with certain software (including
8// but not limited to OpenSSL) that is licensed under separate terms,
9// as designated in a particular file or component or in included license
10// documentation. The authors of this program hereby grant you an additional
11// permission to link the program and your derivative works with the
12// separately licensed software that they have either included with
13// the program or referenced in the documentation.
14//
15// This program is distributed in the hope that it will be useful,
16// but WITHOUT ANY WARRANTY; without even the implied warranty of
17// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18// GNU General Public License for more details.
19//
20// You should have received a copy of the GNU General Public License
21// along with this program; if not, see <https://www.gnu.org/licenses/>.
22
23//! Per-handler Rust-side state owned across the C++ FFI boundary.
24
25use std::fmt;
26
27use crate::engine::StorageEngine;
28
29/// Per-handler Rust-side state owned through `Box::into_raw`. The C++
30/// `RustHandlerBase` keeps a `void*` to one of these.
31#[non_exhaustive]
32pub struct EngineContext {
33    engine: Box<dyn StorageEngine>,
34}
35
36impl EngineContext {
37    pub(crate) fn new(engine: Box<dyn StorageEngine>) -> Self {
38        Self { engine }
39    }
40
41    pub(crate) fn engine_mut(&mut self) -> &mut dyn StorageEngine {
42        &mut *self.engine
43    }
44}
45
46impl fmt::Debug for EngineContext {
47    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
48        f.debug_struct("EngineContext").finish_non_exhaustive()
49    }
50}