1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89
// Copyright 2024 Foyer Project Authors
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
// http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
use std::sync::Arc;
use foyer_common::runtime::{BackgroundShutdownRuntime, SingletonHandle};
use tokio::runtime::Handle;
#[derive(Debug)]
struct RuntimeInner {
_read_runtime: Option<Arc<BackgroundShutdownRuntime>>,
_write_runtime: Option<Arc<BackgroundShutdownRuntime>>,
read_runtime_handle: SingletonHandle,
write_runtime_handle: SingletonHandle,
user_runtime_handle: SingletonHandle,
}
/// [`Runtime`] holds the runtime reference and non-clonable handles to prevent handle usage after runtime shutdown.
#[derive(Debug, Clone)]
pub struct Runtime {
inner: Arc<RuntimeInner>,
}
impl Runtime {
/// Create a new runtime with runtimes if given.
pub fn new(
read_runtime: Option<Arc<BackgroundShutdownRuntime>>,
write_runtime: Option<Arc<BackgroundShutdownRuntime>>,
user_runtime_handle: Handle,
) -> Self {
let read_runtime_handle = read_runtime
.as_ref()
.map(|rt| rt.handle().clone())
.unwrap_or(user_runtime_handle.clone());
let write_runtime_handle = write_runtime
.as_ref()
.map(|rt| rt.handle().clone())
.unwrap_or(user_runtime_handle.clone());
Self {
inner: Arc::new(RuntimeInner {
_read_runtime: read_runtime,
_write_runtime: write_runtime,
read_runtime_handle: read_runtime_handle.into(),
write_runtime_handle: write_runtime_handle.into(),
user_runtime_handle: user_runtime_handle.into(),
}),
}
}
/// Create a new runtime with current runtime env only.
pub fn current() -> Self {
Self {
inner: Arc::new(RuntimeInner {
_read_runtime: None,
_write_runtime: None,
read_runtime_handle: Handle::current().into(),
write_runtime_handle: Handle::current().into(),
user_runtime_handle: Handle::current().into(),
}),
}
}
/// Get the non-clonable read runtime handle.
pub fn read(&self) -> &SingletonHandle {
&self.inner.read_runtime_handle
}
/// Get the non-clonable write runtime handle.
pub fn write(&self) -> &SingletonHandle {
&self.inner.write_runtime_handle
}
/// Get the non-clonable user runtime handle.
pub fn user(&self) -> &SingletonHandle {
&self.inner.user_runtime_handle
}
}