4个稳定版本

1.0.3 2023年10月30日

#5 in #tutorial

MIT/Apache

65KB
1.5K SLoC

Rust中的Web服务教程

概述

本项目是一个全面的教程,介绍了如何使用Rust编程语言构建web服务。它涵盖了从设置PostgreSQL数据库到处理JSON响应的各个方面。

使用的技术

  • Rust:本项目的核心编程语言。
  • Tokio:Rust的异步运行时。
  • SQLx:Rust库,用于连接PostgreSQL数据库。
  • Dotenv:Rust包,用于处理.env文件。
  • Serde:Rust包,用于序列化和反序列化数据结构。
  • Actix-Web:用于构建web服务的Rust框架。
  • Chrono:Rust的时间处理库。

文档

要为此项目生成文档

cargo doc --open

或者,您可以在docs.rs上找到每个crate的文档。

入门

先决条件

  • 确保您已安装Docker Compose。如果没有,您可以从Docker Desktop下载。

设置

  1. 环境变量:复制示例环境文件并配置变量。

    cp env.example .env
    
  2. Docker Compose:启动Docker容器。

    docker compose up -d
    
  3. 测试路由:打开您的浏览器或使用Postman等工具访问以下路由

    http://127.0.0.1:8080/blogs
    

数据库GUI (PgAdmin4)

  • https://127.0.0.1:16543访问PgAdmin4界面。
  • 用户名:test@test.com
  • 密码:test

有关在PgAdmin4中添加PostgreSQL服务器的详细说明,请参阅PG Admin指南

SQL模式

init.sql文件包含定义数据库模式的SQL语句。您可以自由探索它以了解数据库结构。

身份验证

SKIP_AUTH 环境变量控制 JWT 认证。将其设置为 true 以在开发期间禁用 JWT。

附加资源

依赖项

~59MB
~1M SLoC