pub struct ChunkCache { /* private fields */ }Expand description
On-disk chunk cache for decoded xorb ranges, keyed by the 64-hex xorb hash.
See the module docs for layout, atomicity, corruption handling, and the LRU budget/eviction mechanics.
Implementations§
Source§impl ChunkCache
impl ChunkCache
Sourcepub fn new(
cache_dir: impl Into<PathBuf>,
budget_bytes: u64,
) -> Result<Self, SdxError>
pub fn new( cache_dir: impl Into<PathBuf>, budget_bytes: u64, ) -> Result<Self, SdxError>
Creates a cache rooted at cache_dir with an LRU budget of
budget_bytes (0 disables the cache).
Existing entries are scanned and validated; corrupt or oversized files are removed, and entries over the budget are evicted (oldest first).
§Errors
Returns SdxError::Io when cache_dir cannot be created or scanned.
Sourcepub const fn budget_bytes(&self) -> u64
pub const fn budget_bytes(&self) -> u64
Returns the configured budget in bytes (0 = disabled).
Sourcepub async fn total_bytes(&self) -> Result<u64, SdxError>
pub async fn total_bytes(&self) -> Result<u64, SdxError>
Returns the total bytes currently tracked by this cache instance.
§Errors
Returns SdxError::StreamInternal when the cache state lock is
poisoned.
Sourcepub async fn entry_count(&self) -> Result<usize, SdxError>
pub async fn entry_count(&self) -> Result<usize, SdxError>
Returns the number of entries currently tracked by this cache instance.
§Errors
Returns SdxError::StreamInternal when the cache state lock is
poisoned.
Sourcepub async fn get(
&self,
xorb_hash: &str,
chunk_range: (u64, u64),
) -> Result<Option<CachedXorbRange>, SdxError>
pub async fn get( &self, xorb_hash: &str, chunk_range: (u64, u64), ) -> Result<Option<CachedXorbRange>, SdxError>
Returns the cached decoded xorb range for xorb_hash covering exactly
chunk_range, or None on a miss.
A corrupt or truncated entry is deleted and reported as a miss; no error is propagated for data-level corruption.
§Errors
Returns SdxError::Hash when xorb_hash is not a valid 64-hex Xet
CAS API hash, or SdxError::Io when reading fails.
Sourcepub async fn put(
&self,
xorb_hash: &str,
chunk_range: (u64, u64),
chunk_offsets: &[u32],
data: &[u8],
) -> Result<(), SdxError>
pub async fn put( &self, xorb_hash: &str, chunk_range: (u64, u64), chunk_offsets: &[u32], data: &[u8], ) -> Result<(), SdxError>
Stores the decoded xorb range data/chunk_offsets under xorb_hash
for chunk_range.
chunk_offsets must have chunk_end - chunk_start + 1 entries, the
first must be 0, and the last must equal data.len() (validated;
invalid input is rejected with SdxError::StreamInternal). Entries
may cover at most 8192 chunks. Entries larger than the budget are not
stored. On overflow, the
least-recently-accessed entry is evicted until the cache fits.
§Errors
Returns SdxError::Hash when xorb_hash is invalid,
SdxError::StreamInternal when the entry shape is invalid, or
SdxError::Io when writing or evicting fails.
Trait Implementations§
Auto Trait Implementations§
impl !RefUnwindSafe for ChunkCache
impl !UnwindSafe for ChunkCache
impl Freeze for ChunkCache
impl Send for ChunkCache
impl Sync for ChunkCache
impl Unpin for ChunkCache
impl UnsafeUnpin for ChunkCache
Blanket Implementations§
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Source§impl<T> DropFlavorWrapper<T> for T
impl<T> DropFlavorWrapper<T> for T
Source§impl<T, W> HasTypeWitness<W> for Twhere
W: MakeTypeWitness<Arg = T>,
T: ?Sized,
impl<T, W> HasTypeWitness<W> for Twhere
W: MakeTypeWitness<Arg = T>,
T: ?Sized,
Source§impl<T> Identity for Twhere
T: ?Sized,
impl<T> Identity for Twhere
T: ?Sized,
Source§impl<T> Instrument for T
impl<T> Instrument for T
Source§fn instrument(self, span: Span) -> Instrumented<Self> ⓘ
fn instrument(self, span: Span) -> Instrumented<Self> ⓘ
Source§fn in_current_span(self) -> Instrumented<Self> ⓘ
fn in_current_span(self) -> Instrumented<Self> ⓘ
Source§impl<T> IntoEither for T
impl<T> IntoEither for T
Source§fn into_either(self, into_left: bool) -> Either<Self, Self> ⓘ
fn into_either(self, into_left: bool) -> Either<Self, Self> ⓘ
self into a Left variant of Either<Self, Self>
if into_left is true.
Converts self into a Right variant of Either<Self, Self>
otherwise. Read moreSource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self> ⓘ
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self> ⓘ
self into a Left variant of Either<Self, Self>
if into_left(&self) returns true.
Converts self into a Right variant of Either<Self, Self>
otherwise. Read more