Struct FileHandle 

pub struct FileHandle {
    pub path: PathBuf,
    pub num_pages: u64,
    pub page_size: usize,
    pub free_space_manager: Option<Arc<FreeSpaceManager>>,
}

A file handle mapping logical page numbers to file offsets.

Fields

path: PathBuf

Path to the database file.

num_pages: u64

Number of pages currently in the file.

page_size: usize

Page size in bytes.

free_space_manager: Option<Arc<FreeSpaceManager>>

Free space manager for reusing pages.

Implementations

impl FileHandle

pub fn new(path: PathBuf, page_size: usize) -> Self

pub fn with_free_space_manager(self, fsm: Arc<FreeSpaceManager>) -> Self

pub fn page_offset(&self, page_num: PageNum) -> u64

Get the file offset for a given page number.

pub fn read_page(&self, page_num: PageNum) -> Result<Vec<u8>>

Read a page from disk.

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

Write a page to disk.

pub fn allocate_page(&mut self) -> PageNum

Allocate a new page (extend the file or reuse from FSM).

pub fn free_page(&self, page_num: PageNum)

Free a page for reuse.

pub fn extend_file(&mut self, num_pages: u64) -> Result<PageNum>

Extend the file by num_pages pages, writing zero-filled data.

Returns the starting page number of the newly extended region.

Trait Implementations

impl Clone for FileHandle

fn clone(&self) -> FileHandle

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for FileHandle

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.