Enum CachingStrategy 

pub enum CachingStrategy {
    Strict,
    Adhoc,
    Extendable,
}

Defines how StaticApiProvider handles namespace cache misses.

Different strategies offer different trade-offs between strictness, performance, and flexibility.

Variants

Strict

Only allow access to namespaces that were pre-cached during initialization.

Returns an error if a namespace is not in the cache. This is the safest option and guarantees no runtime Api allocations.

Performance: Lock-free HashMap lookup (~5ns)

Adhoc

Create Api instances on-the-fly for uncached namespaces without caching them.

If a namespace is in the cache, returns the cached instance. Otherwise, creates a new Api instance each time (not cached). Useful when you have a core set of frequently-accessed namespaces but occasionally need to access others.

Performance:

• Cached: Lock-free HashMap lookup (~5ns)
• Uncached: Api creation per call (~100ns)

Extendable

Lazily create and cache Api instances on first access (extendable cache).

Similar to CachedApiProvider, but can be pre-populated with known namespaces. Uses RwLock for thread-safe dynamic caching.

Performance:

• Cached: RwLock read + HashMap lookup (~10-15ns)
• First access: RwLock write + Api creation (~100ns, one-time per namespace)

Trait Implementations

impl Clone for CachingStrategy

fn clone(&self) -> CachingStrategy

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CachingStrategy

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

Formats the value using the given formatter.

impl PartialEq for CachingStrategy

fn eq(&self, other: &CachingStrategy) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for CachingStrategy

impl Eq for CachingStrategy

impl StructuralPartialEq for CachingStrategy