dualcache-ff 1.0.0

A wait-free, high-performance concurrent cache optimized for extreme read-to-write ratios.
Documentation 
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

//! Static Configuration Policy for DualCacheCore
//! Uses a Trait-based Static Config pattern for maximum extensibility and zero runtime overhead.

pub trait CachePolicy {
    type Evict: crate::componant::policy::EvictionPolicy + Default;
    
    /// Hit count threshold to promote from Local TLS Cache to T2 Core Cache.
    const T2_THRESHOLD: u16;
    /// Hit count threshold to promote from T2 to T1.
    const T1_THRESHOLD: u16;
    /// Hit count threshold to promote from T1 to T0.
    const T0_THRESHOLD: u16;

    /// Compile-Time Assertions
    /// Forces the user-defined thresholds to be powers of two.
    const _ASSERT_POWER_OF_TWO: () = {
        assert!(Self::T2_THRESHOLD.is_power_of_two(), "T2 Threshold must be 2^n");
        assert!(Self::T1_THRESHOLD.is_power_of_two(), "T1 Threshold must be 2^n");
        assert!(Self::T0_THRESHOLD.is_power_of_two(), "T0 Threshold must be 2^n");
    };
}

/// The default Exponential Policy scaling latency thresholds by 2^n.
pub struct DefaultExponentialPolicy;

impl CachePolicy for DefaultExponentialPolicy {
    type Evict = crate::componant::policy::DefaultEvictionPolicy;
    
    const T2_THRESHOLD: u16 = 2;   // Local to T2 (T2 threshold not strictly defined in earlier prompts but 2 fits 2^1)
    const T1_THRESHOLD: u16 = 16;  // T2 to T1
    const T0_THRESHOLD: u16 = 256; // T1 to T0
}