Struct UseCaseBuilder 

pub struct UseCaseBuilder<Args, T> { /* private fields */ }

Builds a registered use case. Finish with register for serde JSON values or register_custom with an explicit codec and comparator.

Implementations

impl<Args, T> UseCaseBuilder<Args, T>

where Args: Clone + Send + Sync + 'static, T: Send + Sync + 'static,

pub fn policy(self, policy: Policy) -> Self

Static policy captured for every call of this use case.

pub fn tracked(self, tracked: bool) -> Self

Share the entity’s invalidation watermark with every tracked variant.

pub fn budget(self, budget: SourceBudget) -> Self

The source deadline. Defaults to 60 s.

pub fn codec(self, codec: Arc<dyn Codec<T>>) -> Self

Replace the JSON codec; required by register_custom.

pub fn comparator( self, comparator: impl Fn(&T, &T) -> bool + Send + Sync + 'static, ) -> Self

Application equality for shadow validation. Defaults to PartialEq.

pub fn should_recover( self, predicate: impl Fn(&Error) -> bool + Send + Sync + 'static, ) -> Self

Override the instance classifier for stale recovery.

pub fn preview( self, preview: impl Fn(&T) -> Option<String> + Send + Sync + 'static, ) -> Self

The text mismatch warnings log for each value in place of its JSON; required for value fields under register_custom. Difference fields then come only from mismatch_diff. See Preview.

pub fn mismatch_diff( self, hook: impl Fn(&T, &T) -> Vec<MismatchEntry> + Send + Sync + 'static, ) -> Self

Replace the built-in difference computation of mismatch warnings; required for difference fields under register_custom. See MismatchDiffHook.

pub fn key(self, key: impl Fn(&Args) -> KeySpec + Send + Sync + 'static) -> Self

Select every input dimension that affects the value. Runs only for enabled calls.

pub fn source<F, Fut>(self, source: F) -> Self

where F: Fn(Scope, Args) -> Fut + Send + Sync + 'static, Fut: Future<Output = Result<T, BoxError>> + Send + 'static,

The source of truth. It receives the call’s scope so nested cached calls can participate; served-hit shadow validation invokes it again under disabled caching.

pub fn register_custom(self) -> Result<UseCase<Args, T>, ConfigError>

Register with an explicit codec and comparator (set with codec and comparator).

impl<Args, T> UseCaseBuilder<Args, T>

where Args: Clone + Send + Sync + 'static, T: Serialize + DeserializeOwned + PartialEq + Send + Sync + 'static,

pub fn register(self) -> Result<UseCase<Args, T>, ConfigError>

Register with the JSON codec and PartialEq comparison unless overridden. Mismatch warnings use the values’ JSON, as for Operation::new.

Trait Implementations

impl<Args, T> Debug for UseCaseBuilder<Args, T>

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

Formats the value using the given formatter.