1 个不稳定版本
0.1.0 | 2023年2月18日 |
---|
#2668 在 数据库接口
被 world-tables-server 使用
3.5MB
1.5K SLoC
世界表格
这是一个实验,使用 Axum 构建的 API 实现 Egui 接口,使它们像一个单一应用程序一样一起工作。尽管目前仅限于单用户使用,但这个项目是在考虑未来的多用户应用的情况下制作的。
屏幕截图
备注
-
迄今为止,仅在 Linux 上进行了测试。
-
我不想让 Egui 应用在发送请求和等待 API 时阻塞,但我看不到使用
tokio
的理由,因为在这种情况下,你无论如何都受限于用户的按钮点击速度。我只是使用普通的std::thread
创建处理请求的线程,并通过通道将它们与主线程通信。 -
由于我使用了线程,我不知道该应用是否在 wasm 上运行。它可能只是使用
wasm_thread
和reqwasm
运行。 -
使用 Sqlite 与 rust (
rusqlite
) 和使用多线程或异步编程的最佳方法似乎在人们之间存在争议,没有明确的共识或关于最佳方法的文档。我决定只使用r2d2
的池管理器,但在这次测试中,我还没有正确使用tokio::spawn_blocking
。因此,API 的异步处理程序中的数据库调用仍然会阻塞,但这对这个应用来说不是什么大问题。 -
我不想使用复杂的 ORM 设置来配置数据库,这样我就可以更多地控制查询并在以后进行实验。相反,我创建了一系列简单的辅助特质,以便仍然像使用 ORM 一样组织代码,并将它们分割到
dbent
库中。
使用方法
此项目使用 cargo-make 进行构建和运行。要安装 cargo-make,请运行以下命令
cargo install cargo-make
安装完成后,您可以通过运行以下命令构建服务器和其他所有组件
cargo make server
请注意,这不仅会构建组件,如果成功,还应该运行带图形用户界面的服务器。第一次运行服务器时,SQLite数据库将在用户目录中创建,可能需要一些时间才能完成。
资源
-
国家-州-城市数据库 - 包含额外处理以创建更多表和关系的数据源。
-
Catppuccin/egui - egui的酷Frappé主题,包含一些个人定制。
许可证
根据您的选择,许可协议为Apache许可证,版本2.0或MIT许可证。
除非您明确表示,否则您提交给World-Tables的任何贡献,根据Apache-2.0许可证定义,将按上述方式双许可,不附加任何额外条款或条件。
依赖项
~31MB
~592K SLoC