markbase/docs/WEBDAV_MARKBASE_BACKEND_PLAN.md

WebDAV MarkBase Backend集成计划

当前状态

现有WebDAV实现：

• src/webdav/handler.rs (26 lines)
• 使用 dav-server 库
• 使用 LocalFs（本地文件系统backend）
• 使用 FakeLs（简单lock system）

问题：

• ❌ LocalFs只是本地目录映射，不是SQLite backend
• ❌ 无法直接访问warren.sqlite（12659 nodes）
• ❌ 无法使用MarkBaseFS的query_node/read_file功能

---

需要实现：MarkBaseFs backend

目标：

• 实现dav-server的filesystem trait
• 使用MarkBaseFS（SQLite backend）
• 支持warren.sqlite的12659 nodes
• 实现PROPFIND、GET、PUT操作

---

dav-server filesystem trait分析

dav-server库的filesystem trait需要实现：

pub trait DavFileSystem: Send + Sync {
    // 必须实现的方法
    fn read_dir(&self, path: &str, meta: bool) -> io::Result<Vec<DavDirItem>>;
    fn get_file(&self, path: &str) -> io::Result<Box<dyn DavFile>>;
    fn metadata(&self, path: &str) -> io::Result<DavMetaData>;
    
    // 可选方法（PUT写入）
    fn put_file(&self, path: &str) -> io::Result<Box<dyn DavFile>>;
    fn create_dir(&self, path: &str) -> io::Result<()>;
    fn remove_file(&self, path: &str) -> io::Result<()>;
    fn remove_dir(&self, path: &str) -> io::Result<()>;
}

---

实现方案

方案A：直接实现filesystem trait（推荐）

优势：

• 完全控制
• 直接使用MarkBaseFS
• 性能最优

步骤：

1. 创建 MarkBaseFs struct，实现 DavFileSystem trait
2. 使用 MarkBaseFS::query_node() 获取文件节点
3. 使用 MarkBaseFS::query_children() 实现read_dir
4. 使用 MarkBaseFS::read_file() 实现get_file
5. 集成到DavHandler

预估时间： 3-4小时

---

方案B：修改handler.rs，使用SQLite backend（简化）

优势：

• 快速实现
• 不需要自定义filesystem trait
• 利用现有handler结构

步骤：

1. 修改 MarkBaseWebDAV::create_handler()
2. 使用 data/users/warren.sqlite 作为数据源
3. 创建虚拟文件映射
4. 保留LocalFs，但映射到SQLite虚拟目录

预估时间： 1-2小时

---

方案C：使用WebDAV handler + HTTP server（最简单）

优势：

• 最快实现
• 不需要自定义filesystem
• 使用现有的localfs

步骤：

1. 创建 data/webdav/warren/ 目录
2. 使用 MarkBaseFS::read_file() 将warren.sqlite文件复制到该目录
3. LocalFs自动映射目录结构
4. Finder可通过HTTP访问

缺点：

• 不是真正的SQLite backend
• 需要文件复制（占用磁盘空间）
• 性能较差

预估时间： 30分钟

---

推荐方案：方案A（完整实现）

理由：

• 完全使用SQLite backend
• 真正的虚拟文件系统
• 性能最优
• 可扩展（未来可添加PUT写入）

---

实现步骤（方案A）

步骤1：创建MarkBaseFs struct

文件： src/webdav/markbase_fs.rs

use dav_server::{DavFileSystem, DavDirItem, DavMetaData, DavFile};
use crate::fskit::filesystem::MarkBaseFS;
use std::io;

pub struct MarkBaseFs {
    markbase_fs: MarkBaseFS,
    user_id: String,
}

impl MarkBaseFs {
    pub fn new(user_id: String, db_path: &str) -> Self {
        let markbase_fs = MarkBaseFS::new(&user_id, db_path);
        Self { markbase_fs, user_id }
    }
}

impl DavFileSystem for MarkBaseFs {
    fn read_dir(&self, path: &str, meta: bool) -> io::Result<Vec<DavDirItem>> {
        // 使用MarkBaseFS::query_children()
        // 返回目录内容
    }
    
    fn get_file(&self, path: &str) -> io::Result<Box<dyn DavFile>> {
        // 使用MarkBaseFS::read_file()
        // 返回文件内容
    }
    
    fn metadata(&self, path: &str) -> io::Result<DavMetaData> {
        // 使用MarkBaseFS::query_node()
        // 返回文件元数据
    }
}

---

步骤2：实现DavDirItem和DavMetaData

DavDirItem结构：

pub struct MarkBaseDavDirItem {
    name: String,
    is_dir: bool,
    size: u64,
}

impl DavDirItem for MarkBaseDavDirItem {
    fn name(&self) -> &str { &self.name }
    fn is_dir(&self) -> bool { self.is_dir }
}

DavMetaData结构：

pub struct MarkBaseMetaData {
    is_dir: bool,
    size: u64,
    modified: SystemTime,
}

impl DavMetaData for MarkBaseMetaData {
    fn is_dir(&self) -> bool { self.is_dir }
    fn len(&self) -> u64 { self.size }
    fn modified(&self) -> SystemTime { self.modified }
}

---

步骤3：修改handler.rs

文件： src/webdav/handler.rs

use crate::webdav::markbase_fs::MarkBaseFs;

impl MarkBaseWebDAV {
    pub fn create_handler(&self) -> DavHandler {
        let db_path = format!("data/users/{}/{}.sqlite", self.user_id, self.user_id);
        
        DavHandler::builder()
            .filesystem(MarkBaseFs::new(self.user_id.clone(), &db_path))
            .locksystem(FakeLs::new())
            .strip_prefix("/webdav")
            .build_handler()
    }
}

---

步骤4：启动HTTP server

文件： src/bin/webdav_server.rs

use axum::Router;
use markbase::webdav::handler::MarkBaseWebDAV;

fn main() {
    let webdav = MarkBaseWebDAV::new("warren", PathBuf::from("data/users/warren.sqlite"));
    let handler = webdav.create_handler();
    
    let app = Router::new()
        .route("/webdav/*path", get(handler.handle_get))
        .route("/webdav/*path", put(handler.handle_put));
    
    // 启动server
    let addr = SocketAddr::from(([127, 0, 0, 1], 8080));
    axum::Server::bind(&addr).serve(app.into_make_service()).await;
}

---

步骤5：Finder连接测试

Finder操作：

• Connect to Server → http://localhost:8080/webdav
• 验证warren.sqlite的12659 nodes显示
• 验证文件读取功能

---

预估时间

步骤	时间
步骤1：MarkBaseFs struct	1小时
步骤2：DavDirItem/DavMetaData	1小时
步骤3：修改handler.rs	30分钟
步骤4：HTTP server启动	30分钟
步骤5：Finder测试	30分钟
总计	3.5小时

---

快速开始

立即可执行：

1. 创建 src/webdav/markbase_fs.rs
2. 实现 DavFileSystem trait
3. 修改 src/webdav/handler.rs
4. 启动HTTP server
5. Finder连接测试

---

最后更新： 2026-05-18 20:50