leptos 框架快速入门教程

1. 项目目录结构及介绍

在 leptos 项目中，典型的目录结构如下：

├── Cargo.toml      // 项目配置文件，包括依赖项和元数据
├── src              // 主要代码源目录
│   ├── main.rs     // 应用主入口文件
│   └── lib.rs      // 共享库代码
└── public           // 静态资源目录（如CSS、图片等）
    ├── css
    └── js

• Cargo.toml: 使用 Rust 的构建系统 Cargo 管理项目的配置，包含项目名称、作者、版本以及项目依赖。
• src/main.rs: 应用程序的主入口点，通常包含 main 函数，负责初始化 Web 服务器并设置路由。
• src/lib.rs: 可选的共享库文件，可以存放应用中的通用组件或函数。
• public: 存放静态资源，例如样式表和 JavaScript 文件。

2. 项目的启动文件介绍

以 src/main.rs 为例，这个文件通常包含以下部分：

use leptos::{App, Router};

fn main() {
    let mut app = App::new();
    
    // 添加路由
    let router = Router::new()
        .get("/", index)
        .post("/api/users", create_user); // 示例路由

    // 注册路由器到应用
    app.register_router(router);

    // 启动 HTTP 服务器
    app.listen("localhost:3000").await.unwrap();
}

// 示例路由处理函数
async fn index(req: leptos::Request) -> Result<leptos::Response, leptos::Error> {
    Ok(leptos::Response::from_string("Hello, World!"))
}

这里，App::new() 创建了一个新的应用程序实例，Router::new() 定义了 URL 路由，app.register_router() 将路由注册到应用程序中，最后 app.listen() 开启监听特定地址的服务器。

3. 项目的配置文件介绍

leptos 默认不强制使用配置文件，但你可以选择创建一个 YAML 或 TOML 格式的配置文件来管理应用设置。例如，你可以创建一个 config.toml:

[server]
bind_address = "localhost"
port = 3000
thread_count = 4

[database]
url = "sqlite:///data.db"
pool_size = 5

然后，在 main.rs 中加载这个配置文件：

use std::env;
use config::{Config, FileSource};

// 加载配置
let config_path = env::current_dir().unwrap().join("config.toml");
let mut config = Config::default();
config.merge(FileSource::new(config_path)).unwrap();

// 提取配置值
let bind_addr = config.get_str("server.bind_address").unwrap();
let port = config.get_i32("server.port").unwrap();
let thread_count = config.get_i32("server.thread_count").unwrap();
// ...其他配置项...

通过这种方式，你可以将敏感信息或运行时环境变量隔离在外部配置文件中，而不是硬编码在代码里。

以上就是对 leptos 框架的基本介绍，更多详细的使用方法和高级特性可以在官方文档中找到。祝你在使用 leptos 构建高性能 Web 应用时一切顺利！