Struct FileManager 

pub struct FileManager { /* private fields */ }

Manages file I/O for the database

Implementations

impl FileManager

pub fn open(config: &Config) -> Result<Self>

Open or create a database file

pub fn init_if_needed(&self, _config: &Config) -> Result<()>

Initialize the database file if it’s new

pub fn read_page(&self, page_id: PageId) -> Result<Vec<u8>>

Read a page from disk

The read order is: read from disk -> decrypt (if encrypted) -> decompress (if compressed)

pub fn write_page(&self, page_id: PageId, data: &[u8]) -> Result<()>

Write a page to disk

The write order is: compress (if enabled) -> encrypt (if enabled) -> write to disk

pub fn sync(&self) -> Result<()>

Sync all changes to disk

pub fn total_pages(&self) -> u64

Get the current total number of pages

pub fn extend(&self) -> Result<PageId>

Extend the file by one page, return the new page ID

pub fn write_superblock(&self) -> Result<()>

Update superblock on disk

pub fn superblock(&self) -> Superblock

Get superblock

pub fn update_superblock<F>(&self, f: F) -> Result<()>

where F: FnOnce(&mut Superblock),

Update superblock

pub fn page_size(&self) -> usize

Get page size

pub fn is_encrypted(&self) -> bool

Check if encryption is enabled

pub fn is_compressed(&self) -> bool

Check if compression is enabled

pub fn compression_stats(&self) -> &CompressionStats

Get compression statistics Returns the stats from the compressor if compression is enabled, otherwise returns the empty stats.

pub fn compression_type(&self) -> Option<StorageCompressionType>

Get the compression type (if any)

pub fn current_size(&self) -> u64

Get current database file size in bytes

pub fn max_size(&self) -> Option<u64>

Get configured maximum size (None if unlimited)

pub fn remaining_capacity(&self) -> Option<u64>

Get remaining capacity before hitting limit (None if unlimited)

pub fn would_exceed_limit(&self, additional_bytes: u64) -> bool

Check if an operation of given size would exceed the limit

pub fn check_disk_space(&self, _required_bytes: u64) -> Result<()>

Check if sufficient disk space is available for an operation

Returns Ok(()) if enough space, or Err(InsufficientDiskSpace) if not. This performs a best-effort check. On platforms where we can’t determine available space, we optimistically allow the operation (it will fail with I/O error if there’s actually insufficient space).