Skip to main content

SyncRuntimeConfig

Struct SyncRuntimeConfig 

Source
pub struct SyncRuntimeConfig<T = StoredConfig> { /* private fields */ }
Expand description

Synchronous runtime configuration cache.

This type is intended for hot read paths where configuration is loaded from storage asynchronously at the boundary, but request handlers, middleware, policy builders, and task registries need cheap synchronous reads from an in-memory snapshot.

Implementations§

Source§

impl<T> SyncRuntimeConfig<T>

Source

pub fn new() -> Self

Creates an empty synchronous runtime cache.

Source

pub fn replace(&self, configs: Vec<T>) -> Vec<RuntimeConfigChange<T>>

Replaces the snapshot from a full record list and returns the diff.

Restart-only rows keep their in-process record when the key already exists (value and flags stay until restart), mirroring Self::apply; the diff does not report those keys as changed. Removals are applied immediately, matching Self::remove.

Source

pub fn snapshot(&self) -> SyncConfigSnapshot<T>

Returns a cloned snapshot for lock-free derived-state processing.

Source

pub fn get_model(&self, key: &str) -> Option<T>

Returns the stored model for key.

Source

pub fn get(&self, key: &str) -> Option<String>

Returns the storage string for key.

Source

pub fn get_bool(&self, key: &str) -> Option<bool>

Parses a bool-like storage string for key.

Source

pub fn get_i64(&self, key: &str) -> Option<i64>

Parses an i64 storage string for key.

Source

pub fn get_u64(&self, key: &str) -> Option<u64>

Parses a u64 storage string for key.

Source

pub fn get_string_or(&self, key: &str, default: &str) -> String

Returns a string value or default.

Source

pub fn get_bool_or(&self, key: &str, default: bool) -> bool

Returns a bool value or default.

Source

pub fn get_i64_or(&self, key: &str, default: i64) -> i64

Returns an i64 value or default.

Source

pub fn get_u64_or(&self, key: &str, default: u64) -> u64

Returns a u64 value or default.

Source

pub fn apply(&self, config: T) -> Option<RuntimeConfigChange<T>>

Applies one row to the snapshot.

If the incoming row requires restart and the key already exists, the update is ignored to preserve the in-process value until restart.

Source

pub fn remove(&self, key: &str) -> Option<RuntimeConfigChange<T>>

Removes one key from the snapshot.

Trait Implementations§

Source§

impl<T: Debug> Debug for SyncRuntimeConfig<T>

Source§

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

Formats the value using the given formatter. Read more
Source§

impl<T: Default> Default for SyncRuntimeConfig<T>

Source§

fn default() -> SyncRuntimeConfig<T>

Returns the “default value” for a type. Read more

Auto Trait Implementations§

§

impl<T = StoredConfig> !Freeze for SyncRuntimeConfig<T>

§

impl<T> RefUnwindSafe for SyncRuntimeConfig<T>

§

impl<T> Send for SyncRuntimeConfig<T>
where T: Send,

§

impl<T> Sync for SyncRuntimeConfig<T>
where T: Send + Sync,

§

impl<T> Unpin for SyncRuntimeConfig<T>
where T: Unpin,

§

impl<T> UnsafeUnpin for SyncRuntimeConfig<T>

§

impl<T> UnwindSafe for SyncRuntimeConfig<T>

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

§

impl<T> Instrument for T

§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided [Span], returning an Instrumented wrapper. Read more
§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> IntoEither for T

Source§

fn into_either(self, into_left: bool) -> Either<Self, Self>

Converts self into a Left variant of Either<Self, Self> if into_left is true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
where F: FnOnce(&Self) -> bool,

Converts self into a Left variant of Either<Self, Self> if into_left(&self) returns true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
§

impl<T> WithSubscriber for T

§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a [WithDispatch] wrapper. Read more
§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a [WithDispatch] wrapper. Read more