use crate::error::LimboError; use crate::{io::Completion, Buffer, Result}; use std::sync::Arc; use tracing::{instrument, Level}; /// DatabaseStorage is an interface a database file that consists of pages. /// /// The purpose of this trait is to abstract the upper layers of Limbo from /// the storage medium. A database can either be a file on disk, like in SQLite, /// or something like a remote page server service. pub trait DatabaseStorage: Send + Sync { fn read_header(&self, c: Completion) -> Result; fn read_page(&self, page_idx: usize, c: Completion) -> Result; fn write_page(&self, page_idx: usize, buffer: Arc, c: Completion) -> Result; fn write_pages( &self, first_page_idx: usize, page_size: usize, buffers: Vec>, c: Completion, ) -> Result; fn sync(&self, c: Completion) -> Result; fn size(&self) -> Result; fn truncate(&self, len: usize, c: Completion) -> Result; } #[cfg(feature = "fs")] pub struct DatabaseFile { file: Arc, } #[cfg(feature = "fs")] unsafe impl Send for DatabaseFile {} #[cfg(feature = "fs")] unsafe impl Sync for DatabaseFile {} #[cfg(feature = "fs")] impl DatabaseStorage for DatabaseFile { #[instrument(skip_all, level = Level::DEBUG)] fn read_header(&self, c: Completion) -> Result { self.file.pread(0, c) } #[instrument(skip_all, level = Level::DEBUG)] fn read_page(&self, page_idx: usize, c: Completion) -> Result { let r = c.as_read(); let size = r.buf().len(); assert!(page_idx > 0); if !(512..=65536).contains(&size) || size & (size - 1) != 0 { return Err(LimboError::NotADB); } let pos = (page_idx - 1) * size; self.file.pread(pos, c) } #[instrument(skip_all, level = Level::DEBUG)] fn write_page( &self, page_idx: usize, buffer: Arc, c: Completion, ) -> Result { let buffer_size = buffer.len(); assert!(page_idx > 0); assert!(buffer_size >= 512); assert!(buffer_size <= 65536); assert_eq!(buffer_size & (buffer_size - 1), 0); let pos = (page_idx - 1) * buffer_size; self.file.pwrite(pos, buffer, c) } fn write_pages( &self, page_idx: usize, page_size: usize, buffers: Vec>, c: Completion, ) -> Result { assert!(page_idx > 0); assert!(page_size >= 512); assert!(page_size <= 65536); assert_eq!(page_size & (page_size - 1), 0); let pos = (page_idx - 1) * page_size; let c = self.file.pwritev(pos, buffers, c)?; Ok(c) } #[instrument(skip_all, level = Level::DEBUG)] fn sync(&self, c: Completion) -> Result { self.file.sync(c) } #[instrument(skip_all, level = Level::DEBUG)] fn size(&self) -> Result { self.file.size() } #[instrument(skip_all, level = Level::INFO)] fn truncate(&self, len: usize, c: Completion) -> Result { let c = self.file.truncate(len, c)?; Ok(c) } } #[cfg(feature = "fs")] impl DatabaseFile { pub fn new(file: Arc) -> Self { Self { file } } }