ChuSQL/chusql-storage/src/heap.rs

use std::collections::HashSet;
use std::io;
use std::path::Path;

use crate::btree::DiskBTree;
use crate::page::PageId;
use crate::page::{Page, PageFile};
use crate::protocol::Row;

// 堆表：行按插入顺序进页，支持全表扫描、按索引取行、行级删除。

const HEADER_SIZE: usize = 2;
const SLOT_SIZE: usize = 8;
const SLOT_DIR_START: usize = HEADER_SIZE;

/// 读一个小端 u16
fn read_u16(buf: &[u8], off: usize) -> u16 {
    u16::from_le_bytes([buf[off], buf[off + 1]])
}

/// 写一个小端 u16
fn write_u16(buf: &mut [u8], off: usize, v: u16) {
    buf[off..off + 2].copy_from_slice(&v.to_le_bytes());
}

/// 读一个小端 u32
fn read_u32(buf: &[u8], off: usize) -> u32 {
    u32::from_le_bytes([buf[off], buf[off + 1], buf[off + 2], buf[off + 3]])
}

/// 写一个小端 u32
fn write_u32(buf: &mut [u8], off: usize, v: u32) {
    buf[off..off + 4].copy_from_slice(&v.to_le_bytes());
}

/// (页号, 槽位号) 打包成 u64
fn pack_position(page_id: PageId, slot: u16) -> u64 {
    (page_id << 16) | (slot as u64)
}

/// 从 u64 解回 (页号, 槽位号)
fn unpack_position(v: u64) -> (PageId, u16) {
    (v >> 16, (v & 0xFFFF) as u16)
}

/// 取行里某一列的整数值（不是整数就没有）
fn row_int(row: &Row, column: &str) -> Option<i64> {
    match row.get(column) {
        Some(serde_json::Value::Number(n)) => n.as_i64(),
        _ => None,
    }
}

pub struct HeapPage;

impl HeapPage {
    /// 这一页有几个槽位
    pub fn slot_count(page: &Page) -> u16 {
        read_u16(&page.data, 0)
    }

    /// 改写槽位数量
    fn set_slot_count(page: &mut Page, v: u16) {
        write_u16(&mut page.data, 0, v);
    }

    /// 空闲空间下界
    fn free_start(page: &Page) -> usize {
        SLOT_DIR_START + (Self::slot_count(page) as usize) * SLOT_SIZE
    }

    /// 空闲空间上界
    fn free_end(page: &Page) -> usize {
        let n = Self::slot_count(page);
        let mut min_off = page.data.len() as u32;
        for i in 0..n as usize {
            let slot_off = SLOT_DIR_START + i * SLOT_SIZE;
            let off = read_u32(&page.data, slot_off);
            let len = read_u32(&page.data, slot_off + 4);
            if len > 0 && off < min_off {
                min_off = off;
            }
        }
        min_off as usize
    }

    /// 试插一行，放不下返回 None
    pub fn insert_tuple(page: &mut Page, tuple: &[u8]) -> Option<u16> {
        let n = Self::slot_count(page);
        let free_start = Self::free_start(page);
        let free_end = Self::free_end(page);

        if free_start + SLOT_SIZE + tuple.len() > free_end {
            return None;
        }

        let tuple_off = free_end - tuple.len();
        page.data[tuple_off..tuple_off + tuple.len()].copy_from_slice(tuple);

        let slot_off = SLOT_DIR_START + (n as usize) * SLOT_SIZE;
        write_u32(&mut page.data, slot_off, tuple_off as u32);
        write_u32(&mut page.data, slot_off + 4, tuple.len() as u32);
        Self::set_slot_count(page, n + 1);

        Some(n)
    }

    /// 删掉一个槽位，只把长度置 0
    pub fn delete_tuple(page: &mut Page, slot: u16) -> bool {
        let n = Self::slot_count(page);
        if slot >= n {
            return false;
        }
        let slot_off = SLOT_DIR_START + (slot as usize) * SLOT_SIZE;
        if read_u32(&page.data, slot_off + 4) == 0 {
            return false;
        }
        write_u32(&mut page.data, slot_off + 4, 0);
        true
    }

    /// 读槽位里的行字节
    pub fn get_tuple(page: &Page, slot: u16) -> Option<Vec<u8>> {
        let n = Self::slot_count(page);
        if slot >= n {
            return None;
        }
        let slot_off = SLOT_DIR_START + (slot as usize) * SLOT_SIZE;
        let off = read_u32(&page.data, slot_off) as usize;
        let len = read_u32(&page.data, slot_off + 4) as usize;
        if len == 0 {
            return None;
        }
        Some(page.data[off..off + len].to_vec())
    }

    /// 所有槽位号
    pub fn iter_slots(page: &Page) -> Vec<u16> {
        (0..Self::slot_count(page)).collect()
    }
}

struct NamedIndex {
    column: String,
    tree: DiskBTree,
}

pub struct HeapTable {
    file: PageFile,
    indexes: Vec<NamedIndex>,
}

impl HeapTable {
    /// 打开表（不带索引）
    pub fn open<P: AsRef<Path>>(path: P, page_size: usize, pool_size: usize) -> io::Result<Self> {
        Ok(HeapTable {
            file: PageFile::with_options(path, page_size, pool_size)?,
            indexes: Vec::new(),
        })
    }

    /// 打开表并挂上 id 列索引
    pub fn open_indexed<P: AsRef<Path>, Q: AsRef<Path>>(
        path: P,
        index_path: Q,
        page_size: usize,
        btree_order: usize,
        pool_size: usize,
    ) -> io::Result<Self> {
        let mut t = HeapTable {
            file: PageFile::with_options(path, page_size, pool_size)?,
            indexes: Vec::new(),
        };
        t.attach_index("id", index_path, page_size, btree_order, pool_size)?;
        Ok(t)
    }

    /// 打开表并挂上多组索引
    pub fn open_with_indexes<P: AsRef<Path>>(
        path: P,
        indexes: &[(String, std::path::PathBuf)],
        page_size: usize,
        btree_order: usize,
        pool_size: usize,
    ) -> io::Result<Self> {
        let mut t = HeapTable {
            file: PageFile::with_options(path, page_size, pool_size)?,
            indexes: Vec::new(),
        };
        for (col, p) in indexes {
            t.attach_index(col, p, page_size, btree_order, pool_size)?;
        }
        Ok(t)
    }

    /// 挂上一棵索引树，不填数据
    fn attach_index<P: AsRef<Path>>(
        &mut self,
        column: &str,
        path: P,
        page_size: usize,
        btree_order: usize,
        pool_size: usize,
    ) -> io::Result<()> {
        let tree = DiskBTree::open(path, page_size, btree_order, pool_size)?;
        self.indexes.push(NamedIndex {
            column: column.to_string(),
            tree,
        });
        Ok(())
    }

    /// 这一列有索引吗
    pub fn has_index(&self, column: &str) -> bool {
        self.indexes.iter().any(|i| i.column == column)
    }

    /// 建索引：要求这一列取值唯一
    pub fn build_index(
        &mut self,
        column: &str,
        path: &Path,
        page_size: usize,
        btree_order: usize,
        pool_size: usize,
    ) -> io::Result<()> {
        if self.has_index(column) {
            return Err(io::Error::new(
                io::ErrorKind::AlreadyExists,
                format!("index on column \"{}\" already exists", column),
            ));
        }

        let mut seen: HashSet<i64> = HashSet::new();
        let mut entries: Vec<(i64, u64)> = Vec::new();
        for (page_id, slot, r) in self.scan_with_positions()? {
            let Some(k) = row_int(&r, column) else {
                continue;
            };
            if !seen.insert(k) {
                return Err(io::Error::new(
                    io::ErrorKind::InvalidInput,
                    format!(
                        "column \"{}\" has duplicate value {} -- non-unique indexes are not supported yet",
                        column, k
                    ),
                ));
            }
            entries.push((k, pack_position(page_id, slot)));
        }

        self.attach_index(column, path, page_size, btree_order, pool_size)?;
        let i = self.indexes.len() - 1;
        self.indexes[i].tree.clear()?;
        for (k, pos) in entries {
            self.indexes[i].tree.insert(k, pos)?;
        }
        Ok(())
    }

    /// 摘掉一个索引（不删文件）
    pub fn detach_index(&mut self, column: &str) -> bool {
        match self.indexes.iter().position(|i| i.column == column) {
            None => false,
            Some(i) => {
                self.indexes.remove(i);
                true
            }
        }
    }

    /// 插入一行，并顺手写各索引
    pub fn insert_row(&mut self, row: &Row) -> io::Result<()> {
        self.insert_row_returning_position(row).map(|_| ())
    }

    /// 插入一行并返回它的位置
    pub fn insert_row_returning_position(&mut self, row: &Row) -> io::Result<(PageId, u16)> {
        let mut pending: Vec<(usize, i64)> = Vec::new();
        for (i, idx) in self.indexes.iter_mut().enumerate() {
            let Some(k) = row_int(row, &idx.column) else {
                continue;
            };
            if idx.tree.get(k)?.is_some() {
                return Err(io::Error::new(
                    io::ErrorKind::InvalidInput,
                    format!("duplicate key {} on indexed column \"{}\"", k, idx.column),
                ));
            }
            pending.push((i, k));
        }

        let (page_id, slot) = self.insert_returning_position(row)?;
        let pos = pack_position(page_id, slot);
        for (i, k) in pending {
            self.indexes[i].tree.insert(k, pos)?;
        }
        Ok((page_id, slot))
    }

    /// 批量插入，落盘由调用方负责
    pub fn insert_rows(&mut self, rows: &[Row]) -> io::Result<()> {
        for r in rows {
            self.insert_row(r)?;
        }
        Ok(())
    }

    /// 插入一行，只进堆表、不碰索引
    fn insert_returning_position(&mut self, row: &Row) -> io::Result<(PageId, u16)> {
        let tuple = serde_json::to_vec(row).map_err(io::Error::other)?;

        if HEADER_SIZE + SLOT_SIZE + tuple.len() > self.file.page_size() {
            return Err(io::Error::other(format!(
                "tuple too large: {} bytes",
                tuple.len()
            )));
        }

        let n = self.file.num_pages()?;
        if n > 0 {
            let last_id = n - 1;
            let mut slot = None;
            self.file.update_page(last_id, |p| {
                slot = HeapPage::insert_tuple(p, &tuple);
            })?;
            if let Some(s) = slot {
                return Ok((last_id, s));
            }
        }

        let mut p = self.file.append_page()?;
        let page_id = p.id;
        let slot = HeapPage::insert_tuple(&mut p, &tuple).expect("pre-checked fits");
        self.file.write_page(&p)?;
        Ok((page_id, slot))
    }

    /// 按 `id` 取一行
    pub fn get_by_key(&mut self, key: i64) -> io::Result<Option<Row>> {
        self.get_by_column_key("id", key)
    }

    /// 按某一列的索引取一行
    pub fn get_by_column_key(&mut self, column: &str, key: i64) -> io::Result<Option<Row>> {
        let Some(idx) = self.indexes.iter_mut().find(|i| i.column == column) else {
            return Ok(None);
        };
        let Some(pos) = idx.tree.get(key)? else {
            return Ok(None);
        };
        let (page_id, slot) = unpack_position(pos);
        self.read_at(page_id, slot)
    }

    /// 按位置读一行
    pub fn read_at(&mut self, page_id: PageId, slot: u16) -> io::Result<Option<Row>> {
        let bytes = self.file.with_page(page_id, |p| HeapPage::get_tuple(p, slot))?;
        match bytes {
            None => Ok(None),
            Some(bytes) => {
                let row: Row = serde_json::from_slice(&bytes).map_err(io::Error::other)?;
                Ok(Some(row))
            }
        }
    }

    /// 按位置删一行并返回它
    pub fn delete_at(&mut self, page_id: PageId, slot: u16) -> io::Result<Option<Row>> {
        let row = self.read_at(page_id, slot)?;
        let existed = self.file.update_page(page_id, |p| HeapPage::delete_tuple(p, slot))?;
        if !existed {
            return Ok(None);
        }
        if let Some(r) = &row {
            for idx in &mut self.indexes {
                if let Some(k) = row_int(r, &idx.column) {
                    idx.tree.delete(k)?;
                }
            }
        }
        Ok(row)
    }

    /// 按 id 批量删行，返回删掉的行
    pub fn delete_by_keys(&mut self, keys: &[i64]) -> io::Result<Vec<Row>> {
        let mut positions: Vec<(PageId, u16)> = Vec::new();

        if self.has_index("id") {
            for &k in keys {
                let pos = self
                    .indexes
                    .iter_mut()
                    .find(|i| i.column == "id")
                    .and_then(|i| i.tree.get(k).ok().flatten());
                if let Some(p) = pos {
                    positions.push(unpack_position(p));
                }
            }
        } else {
            let mut wanted: Vec<i64> = keys.to_vec();
            wanted.sort_unstable();
            for (page_id, slot, r) in self.scan_with_positions()? {
                if let Some(k) = row_int(&r, "id") {
                    if wanted.binary_search(&k).is_ok() {
                        positions.push((page_id, slot));
                    }
                }
            }
        }

        let mut deleted: Vec<Row> = Vec::new();
        for (page_id, slot) in positions {
            if let Some(r) = self.delete_at(page_id, slot)? {
                deleted.push(r);
            }
        }
        Ok(deleted)
    }

    /// 全表扫描
    pub fn scan(&mut self) -> io::Result<Vec<Row>> {
        Ok(self
            .scan_with_positions()?
            .into_iter()
            .map(|(_, _, r)| r)
            .collect())
    }

    /// 全表扫描，同时给出每行的位置（建索引用）
    pub fn scan_with_positions(&mut self) -> io::Result<Vec<(PageId, u16, Row)>> {
        let n = self.file.num_pages()?;
        let mut out = Vec::new();
        for i in 0..n {
            let tuples = self.file.with_page(i, |p| {
                let mut v = Vec::new();
                for slot in HeapPage::iter_slots(p) {
                    if let Some(bytes) = HeapPage::get_tuple(p, slot) {
                        v.push((slot, bytes));
                    }
                }
                v
            })?;
            for (slot, bytes) in tuples {
                let row: Row = serde_json::from_slice(&bytes).map_err(io::Error::other)?;
                out.push((i, slot, row));
            }
        }
        Ok(out)
    }

    /// 整表改写并重建所有索引
    pub fn replace_all(&mut self, rows: &[Row]) -> io::Result<()> {
        self.file.truncate()?;
        for idx in &mut self.indexes {
            idx.tree.clear()?;
        }
        for r in rows {
            let (page_id, slot) = self.insert_returning_position(r)?;
            let pos = pack_position(page_id, slot);
            for idx in &mut self.indexes {
                if let Some(k) = row_int(r, &idx.column) {
                    idx.tree.insert(k, pos)?;
                }
            }
        }
        Ok(())
    }

    /// 把脏页写回（索引也一起）
    pub fn flush(&mut self) -> io::Result<()> {
        for idx in &mut self.indexes {
            idx.tree.flush()?;
        }
        self.file.flush()
    }

    /// 当前缓存页数
    pub fn cached_pages(&self) -> usize { self.file.cached_pages() }
    /// 命中次数
    pub fn hits(&self) -> u64 { self.file.hits() }
    /// 未命中次数
    pub fn misses(&self) -> u64 { self.file.misses() }
    /// 命中率
    pub fn hit_rate(&self) -> f64 { self.file.hit_rate() }
}