Struct TieredCacheBuilder 

pub struct TieredCacheBuilder { /* private fields */ }

Builder for creating configured TieredCache instances

This builder provides a fluent interface for configuring tiered cache instances with L1 (memory) and L2 (Redis) layers.

Example

use oxcache::builder::TieredCacheBuilder;
use std::time::Duration;

let backend = TieredCacheBuilder::new()
    .l1_capacity(10000)
    .l1_ttl(Duration::from_secs(3600))
    .l2_connection_string("redis://localhost:6379")
    .l2_mode(RedisMode::Standalone)
    .auto_promote(true)
    .batch_writes(true)
    .build()?;

Implementations

impl TieredCacheBuilder

pub fn new() -> Self

Create a new tiered cache builder with default settings

Returns

TieredCacheBuilder instance

pub fn l1_capacity(self, capacity: u64) -> Self

Set the L1 cache capacity

Arguments

• capacity - Maximum number of entries in L1 cache

Returns

Self for method chaining

Example

let builder = TieredCacheBuilder::new().l1_capacity(10000);

pub fn l1_ttl(self, ttl: Duration) -> Self

Set the L1 cache TTL

Arguments

• ttl - Time-to-live duration for L1 entries

Returns

Self for method chaining

Example

use std::time::Duration;

let builder = TieredCacheBuilder::new().l1_ttl(Duration::from_secs(3600));

pub fn l2_connection_string(self, connection_string: &str) -> Self

Set the L2 Redis connection string

Arguments

• connection_string - Redis connection URL

Returns

Self for method chaining

Example

let builder = TieredCacheBuilder::new()
    .l2_connection_string("redis://localhost:6379");

pub fn l2_mode(self, mode: RedisMode) -> Self

Set the L2 Redis mode

Arguments

• mode - Redis mode (Standalone, Sentinel, Cluster)

Returns

Self for method chaining

Example

use oxcache::backend::RedisMode;

let builder = TieredCacheBuilder::new()
    .l2_mode(RedisMode::Standalone);

pub fn auto_promote(self, enabled: bool) -> Self

Enable or disable auto-promote

When enabled, values from L2 are automatically promoted to L1 on cache misses.

Arguments

• enabled - Whether to enable auto-promote

Returns

Self for method chaining

Example

let builder = TieredCacheBuilder::new().auto_promote(true);

pub fn batch_writes(self, enabled: bool) -> Self

Enable or disable batch writes

When enabled, multiple write operations are batched for better performance.

Arguments

• enabled - Whether to enable batch writes

Returns

Self for method chaining

Example

let builder = TieredCacheBuilder::new().batch_writes(true);

pub fn bloom_filter(self, enabled: bool) -> Self

Enable or disable bloom filter

When enabled, a bloom filter is used to prevent cache penetration attacks.

Arguments

• enabled - Whether to enable bloom filter

Returns

Self for method chaining

Example

let builder = TieredCacheBuilder::new().bloom_filter(true);

pub async fn build(self) -> Result<Arc<dyn CacheBackend>>

Build the tiered cache backend

Returns

Configured TieredBackend instance

Errors

Returns CacheError if configuration is invalid or backend creation fails

Example

let backend = TieredCacheBuilder::new()
    .l1_capacity(10000)
    .l2_connection_string("redis://localhost:6379")
    .build()?;

Trait Implementations

impl Default for TieredCacheBuilder

fn default() -> Self

Returns the “default value” for a type.