Rust开发服务器库devserver_lib使用指南

简介

devserver_lib是一个用于快速搭建本地开发服务器的Rust库，提供了高效的静态文件服务和调试功能，特别适合前端开发、API测试和本地开发环境搭建。

主要特性

• 轻量级高性能HTTP服务器
• 静态文件服务
• 热重载支持
• 跨平台兼容
• 可配置的路由和中间件

安装方法

在Cargo.toml中添加依赖：

[dependencies]
devserver_lib = "0.1"  # 请使用最新版本号

基础使用示例

1. 启动简单静态文件服务器

use devserver_lib::Server;

fn main() {
    let server = Server::new()
        .port(8080)
        .static_dir("./public")  // 设置静态文件目录
        .start()
        .expect("Failed to start server");
    
    println!("Server running at http://localhost:8080");
    server.wait();  // 阻塞主线程保持服务器运行
}

2. 自定义路由处理

use devserver_lib::{Server, Request, Response};

fn main() {
    let server = Server::new()
        .port(3000)
        .get("/api/hello", |_req: Request| {
            Response::text("Hello from devserver!")
        })
        .post("/api/echo", |req: Request| {
            Response::json(&req.body)
        })
        .start()
        .unwrap();
    
    server.wait();
}

高级功能

1. 中间件支持

use devserver_lib::{Server, Request, Response, MiddlewareResult};

fn logger(req: &Request) -> MiddlewareResult {
    println!("[{}] {} {}", req.method, req.path, req.query);
    Ok(())
}

fn main() {
    Server::new()
        .middleware(logger)
        .get("/", |_| Response::text("Logged request"))
        .start()
        .unwrap()
        .wait();
}

2. WebSocket支持

use devserver_lib::{Server, WsMessage};

fn main() {
    Server::new()
        .ws("/ws", |msg: WsMessage| {
            println!("Received WS message: {:?}", msg);
            Some(WsMessage::Text("Echo: ".to_string() + &msg.to_string()))
        })
        .start()
        .unwrap()
        .wait();
}

3. 热重载配置

use devserver_lib::Server;
use std::time::Duration;

fn main() {
    Server::new()
        .port(8080)
        .static_dir("./src")
        .hot_reload(Duration::from_secs(1))  // 每秒检查文件变化
        .start()
        .unwrap()
        .wait();
}

配置选项

性能建议

1. 生产环境建议设置线程池大小：

Server::new()
    .threads(4)  // 根据CPU核心数设置
    // ...其他配置

1. 对于大量静态文件，启用内存缓存：

Server::new()
    .static_dir("./assets")
    .enable_cache(true)

错误处理

devserver_lib提供了详细的错误报告：

match Server::new().start() {
    Ok(server) => server.wait(),
    Err(e) => eprintln!("Server error: {:?}", e),
}

完整示例demo

下面是一个结合静态文件服务、自定义路由和中间件的完整示例：

use devserver_lib::{Server, Request, Response, MiddlewareResult};
use std::time::Duration;

// 自定义中间件 - 请求日志记录
fn request_logger(req: &Request) -> MiddlewareResult {
    println!("[请求日志] {} {} 查询参数: {:?}", req.method, req.path, req.query);
    Ok(())
}

// 自定义中间件 - 响应时间头
fn response_timing(_req: &Request, res: &mut Response) -> MiddlewareResult {
    res.headers.insert("X-Response-Time".to_string(), "100ms".to_string());
    Ok(())
}

fn main() {
    let server = Server::new()
        .port(8080)
        // 静态文件服务配置
        .static_dir("./public")
        .enable_cache(true)
        // 热重载配置
        .hot_reload(Duration::from_secs(2))
        // 中间件配置
        .middleware(request_logger)
        .middleware(response_timing)
        // 自定义路由
        .get("/api/status", |_| {
            Response::json(&serde_json::json!({
                "status": "ok",
                "version": "1.0.0"
            }))
        })
        .post("/api/users", |req| {
            // 这里可以添加用户创建逻辑
            Response::json(&req.body)
        })
        // WebSocket支持
        .ws("/chat", |msg| {
            println!("收到聊天消息: {:?}", msg);
            Some(WsMessage::Text(format!("服务器回复: {}", msg.to_string())))
        })
        // 性能配置
        .threads(4)
        .start()
        .expect("服务器启动失败");

    println!("开发服务器已启动: http://localhost:8080");
    println!("静态文件目录: ./public");
    println!("WebSocket端点: ws://localhost:8080/chat");
    
    server.wait();
}

总结

devserver_lib是一个功能丰富且易于使用的Rust服务器库，特别适合开发阶段的快速原型搭建和调试。通过简单的API可以快速构建出功能完善的本地开发服务器，支持静态文件服务、自定义路由、中间件和WebSocket等现代Web开发所需的功能。