oxcache 0.4.1

A high-performance multi-level cache library for Rust with L1 (memory) and L2 (Redis) caching.
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
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98

// Copyright (c) 2025-2026 Kirky.X
// SPDX-License-Identifier: MIT
//! Backend provider module for oxcache.
//!
//! Re-exports ISP-compliant trait hierarchy (`CacheReader`/`CacheWriter`/
//! `CacheConnector`/`CacheBackend`) and concrete backend implementations
//! (memory, Redis, Dragonfly, Aerospike, chain).

// Backend score system
pub mod score;

// Memory backend implementations
pub mod memory;

// Modernized API backend interface
pub mod interface;

// Configuration validation utilities
pub mod config_validation;

// Dragonfly backend (Redis-compatible, feature-gated)
#[cfg(feature = "dragonfly")]
pub mod dragonfly;

// Aerospike backend (independent protocol, feature-gated)
#[cfg(feature = "aerospike")]
pub mod aerospike;

// Custom tiered backend configuration (always available)
#[cfg(any(
    feature = "memory",
    feature = "redis",
    feature = "minimal",
    feature = "core",
    feature = "full"
))]
pub mod custom_tiered;

// Re-exports for new API
pub use interface::CacheSetItem;
pub use interface::{CacheBackend, CacheConnector, CacheReader, CacheWriter};
// Re-export atomic operation traits
pub use interface::{AtomicCacheWriter, SyncAtomicCacheWriter};
// Re-exports for synchronous API (任务组 5)
pub use interface::{SyncCacheBackend, SyncCacheConnector, SyncCacheReader, SyncCacheWriter};

// Re-export BackendKind for runtime type identification
pub use interface::BackendKind;

// Re-export LuaExecutor trait for Lua script execution
#[cfg(feature = "lua-script")]
pub use interface::LuaExecutor;

// Re-export ConfigValidation for configuration validation utilities
pub use config_validation::ConfigValidation;

// Dragonfly backend re-exports
#[cfg(feature = "dragonfly")]
pub use dragonfly::{DragonflyBackend, DragonflyRestrictions};

// Aerospike backend re-exports
#[cfg(feature = "aerospike")]
pub use aerospike::{AerospikeBackend, AerospikeConfig};

// Score system exports
pub use score::{BackendScore, Scores};

// Memory backend implementations
pub use memory::{
    DashMapMemoryBackend,
    // Type definitions
    MemoryBackendType,
    MokaMemoryBackend,
    dashmap_memory,
    default_memory_backend,
    // Convenience functions
    moka_memory,
};

// Re-export MockBackend for crate-internal test usage
#[cfg(test)]
pub use memory::MockBackend;

#[cfg(feature = "redis")]
pub use memory::{RedisBackend, RedisBackendBuilder, RedisMode};

// Re-exports for custom tiered configuration
#[cfg(any(
    feature = "memory",
    feature = "redis",
    feature = "minimal",
    feature = "core",
    feature = "full"
))]
pub use custom_tiered::LayerRestriction;

// 从 core::types 重新导出统一的枚举类型
pub use crate::core::{BackendType, CacheLayer};