Rust Web应用开发:从用户注册到课程管理
在Rust的Web应用开发中,我们可以构建功能丰富的应用程序,涵盖用户注册、登录以及课程管理等功能。以下将详细介绍如何逐步实现这些功能。
1. 基础知识回顾
在开始新的开发之前,我们先回顾一下之前涉及的基础知识。一个服务器渲染的Rust Web应用程序在架构上主要由以下几个部分组成:
-
HTML模板
:使用像Tera这样的模板库来定义和渲染。
-
路由
:用于接收HTTP请求。
-
处理函数
:负责处理HTTP请求。
-
数据库访问层
:抽象数据的存储和检索细节。
在Actix Web应用中,标准的HTML表单可用于捕获用户输入。通过将Tera模板变量融入HTML表单,能为用户提供更好的体验和反馈。用户输入验证可以在浏览器内或服务器处理函数中进行,简单的验证(如字段长度检查)通常在浏览器中完成,而更复杂的验证(如检查用户名是否已注册)则在服务器处理函数中进行。当用户提交表单时,浏览器会向Actix Web服务器发送一个POST HTTP请求,并携带表单数据。为了统一错误处理,我们可以定义自定义错误类型。用户管理相关的数据(如用户名和密码)存储在本地数据存储中(这里使用PostgreSQL数据库),为了安全起见,密码以哈希形式存储。
2. 用户注册测试
在用户注册方面,我们进行了一些测试。当尝试使用相同的用户名再次注册时,注册表单会显示之前输入的值,并显示错误消息“User Id already exists”。当再次注册,但密码和确认密码字段不匹配时,表单同样会显示之前输入的值,并显示错误消息“Passwords do not match”。
3. 用户界面改进
当前的解决方案在用户交互方面存在一些不足。一方面,在出现错误时,需要重复大量代码来重建表单;另一方面,如果用户将端点标记为注册端点,使用书签访问时会得到一个空白页面。将其重定向到根路径(/)是一个更好的选择,不过这一修改并不简单,可以作为一个探索性的练习。
4. 课程维护功能开发
接下来,我们将重点转向课程维护功能的开发,这主要包括以下几个方面:
-
用户认证设计与实现
-
HTTP请求路由
-
使用HTTP POST方法创建资源
-
使用HTTP PUT方法更新资源
-
使用HTTP DELETE方法删除资源
5. 用户认证设计
在用户认证方面,我们主要关注导师登录功能。登录时,我们接受两个字段:用户名和密码,用于对导师进行身份验证。导师登录的工作流程如下:
graph LR
A[用户访问着陆页URL] --> B[显示导师登录表单]
B --> C[在表单内进行用户名和密码的基本验证]
C --> D{验证是否有错误}
D -- 是 --> E[向用户提供反馈]
D -- 否 --> F[用户提交登录表单]
F --> G[发送POST请求到Actix Web服务器的登录路由]
G --> H[路由处理器函数从本地数据库检索用户凭证进行验证]
H --> I{认证是否成功}
I -- 是 --> J[将用户定向到导师Web应用的主页]
I -- 否 --> K[重新显示登录表单并显示适当的错误消息]
6. 项目结构设置
为了开始开发,我们需要设置项目的代码结构和基本框架。具体步骤如下:
1. 克隆ezytutors仓库。
2. 设置
PROJECT_ROOT
环境变量为
/path-to-folder/ezytutors/tutor-web-app-ssr
,后续将该文件夹简称为
$PROJECT_ROOT
。
3. 复制
$PROJECT_ROOT/src/iter5
文件夹,并将其重命名为
$PROJECT_ROOT/src/iter6
。
4. 复制
$PROJECT_ROOT/static/iter5
文件夹,并将其重命名为
$PROJECT_ROOT/static/iter6
,该文件夹将包含HTML和Tera模板。
5. 复制
$PROJECT_ROOT/src/bin/iter5-ssr.rs
文件,并将其重命名为
$PROJECT_ROOT/src/bin/iter6-ssr.rs
,该文件包含
main()
函数,用于配置和启动Actix Web服务器。在
iter6-ssr.rs
中,将所有对
iter5
的引用替换为
iter6
。
6. 确保
$PROJECT_ROOT
中的
.env
文件正确配置了
HOST_PORT
和
DATABASE_URL
环境变量。
7. 路由和模型定义
在
$PROJECT_ROOT/src/iter6/routes.rs
中定义路由:
use crate::handler::{handle_register, show_register_form, show_signin_form,
handle_signin};
use actix_files as fs;
use actix_web::web;
pub fn app_config(config: &mut web::ServiceConfig) {
config.service(
web::scope("")
.service(fs::Files::new("/static", "./static").show_files_listing())
.service(web::resource("/").route(web::get().to(show_register_form)))
.service(web::resource("/signinform").route(web::get().to(
show_signin_form)))
.service(web::resource("/signin").route(web::post().to(
handle_signin)))
.service(web::resource("/register").route(web::post().to(
handle_register))),
);
}
在
$PROJECT_ROOT/src/iter6/model.rs
中添加
TutorSigninForm
数据结构:
// Form to enable tutors to sign in
#[derive(Serialize, Deserialize, Debug)]
pub struct TutorSigninForm {
pub username: String,
pub password: String,
}
8. 用户认证实现
在
$PROJECT_ROOT/src/iter6/handler/auth.rs
中编写处理用户登录的处理函数:
use crate::model::{TutorRegisterForm, TutorResponse,
TutorSigninForm, User};
pub async fn show_signin_form(tmpl: web::Data<tera::Tera>) ->
Result<HttpResponse, Error> {
let mut ctx = tera::Context::new();
ctx.insert("error", "");
ctx.insert("current_name", "");
ctx.insert("current_password", "");
let s = tmpl
.render("signin.html", &ctx)
.map_err(|_| EzyTutorError::TeraError(
"Template error".to_string()))?;
Ok(HttpResponse::Ok().content_type("text/html").body(s))
}
pub async fn handle_signin(
tmpl: web::Data<tera::Tera>,
app_state: web::Data<AppState>,
params: web::Form<TutorSigninForm>,
) -> Result<HttpResponse, Error> {
Ok(HttpResponse::Ok().finish())
}
9. 设计登录HTML表单
在
$PROJECT_ROOT/static/iter6
文件夹下创建新的
signin.html
文件,并添加以下代码:
<!doctype html>
<html>
<head>
<meta charset=utf-8>
<title>Tutor registration</title>
<style>
...
</style>
</head>
<body>
<div class="header">
<h1>Welcome to EzyTutor</h1>
<p>Start your own online tutor business in a few minutes</p>
</div>
<div class="center">
<h2>
Tutor sign in
</h2>
<form action=/signin method=POST>
<label for="userid">Enter username</label><br>
<input type="text" name="username" autocomplete="username"
value="{{current_name}}" minlength="6"
maxlength="12" required><br>
<label for="password">Enter password</label><br>
<input type="password" name="password"
autocomplete="new-password" value="{{current_password}}"
minlength="8" maxlength="12" required><br>
<label for="error">
<p style="color:red">{{error}}</p>
</label><br>
<button type=submit id="button2">Sign in</button>
</form>
<form action=/ method=GET>
<button type=submit id="button2">Register</button>
</form>
</div>
<p>
<div id="footer">
(c)Photo by Author
</div>
</p>
</html>
10. 用户通知屏幕
在
$PROJECT_ROOT/static/iter6
文件夹下添加
user.html
表单,用于在用户成功登录后显示:
<!DOCTYPE html>
<html>
<head>
<meta charset=\"utf-8\" />
<title>{{title}}</title>
</head>
<body>
<h1>Hi, {{name}}!</h1>
<p>{{message}}</p>
</body>
</html>
11. 主函数设置
在
$PROJECT_ROOT/src/bin/iter6-ssr.rs
中设置主函数:
#[path = "../iter6/mod.rs"]
mod iter6;
use actix_web::{web, App, HttpServer};
use actix_web::web::Data;
use dotenv::dotenv;
use iter6::{dbaccess, errors, handler, model, routes, state};
use routes::app_config;
use sqlx::postgres::PgPool;
use std::env;
use tera::Tera;
#[actix_web::main]
async fn main() -> std::io::Result<()> {
dotenv().ok();
//Start HTTP server
let host_port = env::var("HOST_PORT").expect(
"HOST:PORT address is not set in .env file");
println!("Listening on: {}", &host_port);
let database_url = env::var("DATABASE_URL").expect(
"DATABASE_URL is not set in .env file");
let db_pool = PgPool::connect(&database_url).await.unwrap();
// Construct App State
let shared_data = web::Data::new(state::AppState { db: db_pool });
HttpServer::new(move || {
let tera = Tera::new(concat!(env!("CARGO_MANIFEST_DIR"),
"/static/iter6/**/*")).unwrap();
App::new()
.app_data(Data::new(tera))
.app_data(shared_data.clone())
.configure(app_config)
})
.bind(&host_port)?
.run()
.await
}
12. 登录功能测试
我们可以通过以下步骤测试登录功能:
1. 从
$PROJECT_ROOT
运行以下命令启动服务器:
cargo run --bin iter6-ssr
如果出现错误“no implementation for u32 - usize”,运行以下命令:
cargo update -p lexical-core
- 从浏览器访问以下路由:
localhost:8080/signinform
你应该能够看到登录表单。你也可以通过访问索引路由(/),显示注册表单,然后点击“Sign In”按钮来调用登录表单。
3. 输入正确的用户名和密码,你应该看到确认消息。再次加载登录表单,输入有效的用户名但错误的密码,验证是否显示错误消息。第三次输入无效的用户名,同样应该看到错误消息。
13. 路由HTTP请求
为了实现课程维护功能,我们需要对路由进行调整。首先,将处理函数组织到各自的模块中。具体操作如下:
1. 在
$PROJECT_ROOT/src/iter6
文件夹下创建一个新的
handler
文件夹。
2. 将
$PROJECT_ROOT/src/iter6/handler.rs
移动到
$PROJECT_ROOT/src/iter6/handler
文件夹中,并将其重命名为
auth.rs
,因为该文件处理注册和登录功能。
3. 在
$PROJECT_ROOT/src/iter6/handler
文件夹下创建新的
course.rs
和
mod.rs
文件。在
mod.rs
中添加以下代码:
pub mod auth;
pub mod course;
14. 修改路由定义
修改
$PROJECT_ROOT/src/iter6/routes.rs
文件:
use crate::handler::auth::{handle_register, handle_signin,
show_register_form, show_signin_form};
use crate::handler::course::{handle_delete_course, handle_insert_course,
handle_update_course};
use actix_files as fs;
use actix_web::web;
pub fn app_config(config: &mut web::ServiceConfig) {
config.service(
web::scope("")
.service(fs::Files::new("/static", "./static").show_files_listing())
.service(web::resource("/").route(web::get().to(show_register_form)))
.service(web::resource("/signinform").route(web::get().to(
show_signin_form)))
.service(web::resource("/signin").route(web::post().to(
handle_signin)))
.service(web::resource("/register").route(web::post().to(
handle_register))),
);
}
pub fn course_config(config: &mut web::ServiceConfig) {
config.service(
web::scope("/courses")
.service(web::resource("new/{tutor_id}").route(web::post().to(
handle_insert_course)))
.service(
web::resource("{tutor_id}/{course_id}").route(web::put().to(
handle_update_course)),
)
.service(
web::resource("delete/{tutor_id}/{course_id}")
.route(web::delete().to(handle_delete_course)),
),
);
}
15. 添加课程维护路由
在
$PROJECT_ROOT/bin/iter6-ssr.rs
中添加新的课程维护路由:
use routes::{app_config, course_config};
HttpServer::new(move || {
let tera = Tera::new(concat!(env!("CARGO_MANIFEST_DIR"),
"/static/iter6/**/*")).unwrap();
App::new()
.app_data(Data::new(tera))
.app_data(shared_data.clone())
.configure(course_config)
.configure(app_config)
})
.bind(&host_port)?
.run()
.await
16. 添加课程维护处理函数占位符
在
$PROJECT_ROOT/src/iter6/handler/course.rs
中添加课程维护处理函数的占位符:
use actix_web::{web, Error, HttpResponse, Result};
use crate::state::AppState;
pub async fn handle_insert_course(
_tmpl: web::Data<tera::Tera>,
_app_state: web::Data<AppState>,
) -> Result<HttpResponse, Error> {
println!("Got insert request");
Ok(HttpResponse::Ok().body("Got insert request"))
}
pub async fn handle_update_course(
_tmpl: web::Data<tera::Tera>,
_app_state: web::Data<AppState>,
) -> Result<HttpResponse, Error> {
Ok(HttpResponse::Ok().body("Got update request"))
}
pub async fn handle_delete_course(
_tmpl: web::Data<tera::Tera>,
_app_state: web::Data<AppState>,
) -> Result<HttpResponse, Error> {
Ok(HttpResponse::Ok().body("Got delete request"))
}
17. 课程维护路由测试
我们可以通过以下命令测试课程维护的POST、PUT和DELETE请求:
curl -H "Content-Type: application/json" -X POST -d '{}' localhost:8080/courses/new/1
curl -H "Content-Type: application/json" -X PUT -d '{}' localhost:8080/courses/1/2
curl -H "Content-Type: application/json" -X DELETE -d '{}' localhost:8080/courses/delete/1/2
你应该看到服务器返回相应的消息,分别对应上述三个HTTP请求。
通过以上步骤,我们逐步实现了从用户注册、登录到课程维护的一系列功能,为构建完整的Rust Web应用奠定了基础。后续可以进一步完善课程维护处理函数的具体逻辑,实现更强大的功能。
Rust Web应用开发:从用户注册到课程管理
18. 课程维护功能细化
虽然我们已经添加了课程维护处理函数的占位符,但还需要进一步细化这些函数,以实现与后端服务的交互。在实际应用中,这些函数将负责调用后端的API来完成课程的插入、更新和删除操作。
19. 插入课程功能实现
为了实现插入课程的功能,我们需要修改
handle_insert_course
函数。以下是一个示例实现:
use actix_web::{web, Error, HttpResponse, Result};
use crate::state::AppState;
use reqwest;
pub async fn handle_insert_course(
tmpl: web::Data<tera::Tera>,
app_state: web::Data<AppState>,
params: web::Json<CourseInsertParams>, // 假设这是插入课程所需的参数结构体
) -> Result<HttpResponse, Error> {
let client = reqwest::Client::new();
let url = format!("{}/courses/new/{}", app_state.backend_url, params.tutor_id);
let response = client.post(&url)
.json(¶ms)
.send()
.await?;
if response.status().is_success() {
Ok(HttpResponse::Ok().body("Course inserted successfully"))
} else {
Ok(HttpResponse::InternalServerError().body("Failed to insert course"))
}
}
在这个示例中,我们使用
reqwest
库来发送POST请求到后端服务。需要注意的是,这里假设
AppState
结构体中包含
backend_url
字段,用于指定后端服务的URL。同时,
CourseInsertParams
是一个自定义的结构体,用于存储插入课程所需的参数。
20. 更新课程功能实现
更新课程的功能可以通过修改
handle_update_course
函数来实现:
use actix_web::{web, Error, HttpResponse, Result};
use crate::state::AppState;
use reqwest;
pub async fn handle_update_course(
tmpl: web::Data<tera::Tera>,
app_state: web::Data<AppState>,
params: web::Json<CourseUpdateParams>, // 假设这是更新课程所需的参数结构体
path: web::Path<(u32, u32)>, // 提取 tutor_id 和 course_id
) -> Result<HttpResponse, Error> {
let (tutor_id, course_id) = path.into_inner();
let client = reqwest::Client::new();
let url = format!("{}/courses/{}/{}", app_state.backend_url, tutor_id, course_id);
let response = client.put(&url)
.json(¶ms)
.send()
.await?;
if response.status().is_success() {
Ok(HttpResponse::Ok().body("Course updated successfully"))
} else {
Ok(HttpResponse::InternalServerError().body("Failed to update course"))
}
}
在这个示例中,我们使用
reqwest
库发送PUT请求到后端服务,同时从路径中提取
tutor_id
和
course_id
。
CourseUpdateParams
是一个自定义的结构体,用于存储更新课程所需的参数。
21. 删除课程功能实现
删除课程的功能可以通过修改
handle_delete_course
函数来实现:
use actix_web::{web, Error, HttpResponse, Result};
use crate::state::AppState;
use reqwest;
pub async fn handle_delete_course(
tmpl: web::Data<tera::Tera>,
app_state: web::Data<AppState>,
path: web::Path<(u32, u32)>, // 提取 tutor_id 和 course_id
) -> Result<HttpResponse, Error> {
let (tutor_id, course_id) = path.into_inner();
let client = reqwest::Client::new();
let url = format!("{}/courses/delete/{}/{}", app_state.backend_url, tutor_id, course_id);
let response = client.delete(&url)
.send()
.await?;
if response.status().is_success() {
Ok(HttpResponse::Ok().body("Course deleted successfully"))
} else {
Ok(HttpResponse::InternalServerError().body("Failed to delete course"))
}
}
在这个示例中,我们使用
reqwest
库发送DELETE请求到后端服务,同时从路径中提取
tutor_id
和
course_id
。
22. 数据模型更新
为了支持课程维护功能,我们需要更新数据模型。在
$PROJECT_ROOT/src/iter6/model.rs
中添加以下结构体:
#[derive(Serialize, Deserialize, Debug)]
pub struct CourseInsertParams {
pub tutor_id: u32,
pub course_name: String,
// 其他课程相关的字段
}
#[derive(Serialize, Deserialize, Debug)]
pub struct CourseUpdateParams {
pub course_name: Option<String>,
// 其他可更新的课程字段
}
23. 错误处理优化
在实际应用中,我们需要对各种可能的错误进行更细致的处理。可以定义一个自定义的错误类型,用于统一处理不同类型的错误。以下是一个示例:
use actix_web::error::ErrorInternalServerError;
use thiserror::Error;
#[derive(Error, Debug)]
pub enum CourseError {
#[error("Failed to connect to backend service")]
BackendConnectionError,
#[error("Backend service returned an error: {0}")]
BackendError(String),
// 其他可能的错误类型
}
impl From<reqwest::Error> for CourseError {
fn from(error: reqwest::Error) -> Self {
if error.is_connect() {
CourseError::BackendConnectionError
} else {
CourseError::BackendError(error.to_string())
}
}
}
impl From<CourseError> for actix_web::Error {
fn from(error: CourseError) -> Self {
ErrorInternalServerError(error.to_string())
}
}
然后在处理函数中使用这个自定义错误类型:
pub async fn handle_insert_course(
tmpl: web::Data<tera::Tera>,
app_state: web::Data<AppState>,
params: web::Json<CourseInsertParams>,
) -> Result<HttpResponse, CourseError> {
let client = reqwest::Client::new();
let url = format!("{}/courses/new/{}", app_state.backend_url, params.tutor_id);
let response = client.post(&url)
.json(¶ms)
.send()
.await?;
if response.status().is_success() {
Ok(HttpResponse::Ok().body("Course inserted successfully"))
} else {
Err(CourseError::BackendError(format!("Backend returned status: {}", response.status())))
}
}
24. 测试与验证
在完成上述功能的实现后,我们需要进行全面的测试和验证。可以使用以下步骤进行测试:
1. 启动后端服务,确保其正常运行。
2. 启动Rust Web应用:
cargo run --bin iter6-ssr
-
使用
curl或Postman等工具发送插入、更新和删除课程的请求,验证功能是否正常工作。例如:
# 插入课程
curl -H "Content-Type: application/json" -X POST -d '{"tutor_id": 1, "course_name": "Rust Programming"}' localhost:8080/courses/new/1
# 更新课程
curl -H "Content-Type: application/json" -X PUT -d '{"course_name": "Advanced Rust Programming"}' localhost:8080/courses/1/2
# 删除课程
curl -H "Content-Type: application/json" -X DELETE localhost:8080/courses/delete/1/2
25. 总结
通过以上步骤,我们完成了从用户注册、登录到课程维护的完整功能实现。在这个过程中,我们学习了如何使用Rust和Actix Web框架构建Web应用,包括路由定义、用户认证、表单处理、错误处理以及与后端服务的交互。以下是整个开发过程的流程图:
graph LR
A[用户注册] --> B[用户登录]
B --> C[课程维护]
C --> C1[插入课程]
C --> C2[更新课程]
C --> C3[删除课程]
C1 --> D[调用后端API插入课程]
C2 --> E[调用后端API更新课程]
C3 --> F[调用后端API删除课程]
D --> G[返回插入结果]
E --> H[返回更新结果]
F --> I[返回删除结果]
这个流程图展示了整个系统的主要功能流程,从用户注册登录开始,到课程的插入、更新和删除操作,最后返回相应的结果。通过这种方式,我们构建了一个功能完整、结构清晰的Rust Web应用。在后续的开发中,可以根据实际需求进一步扩展和优化这些功能,例如添加更多的课程信息字段、实现课程列表的查询功能等。
3万+



被折叠的 条评论
为什么被折叠?



