内容介绍
本专题将带你使用 axum 构建一个短链接服务。短链接,又称短网址,是指将一个可能比较长的链接变成固定长度的短链接,便于在社交媒体、短信等渠道发布。另外,它也可以隐藏原链接里的一些敏感信息,比如带邀请码的推广链接。短链接的核心算法
本章将对短链接的原理及实现算法进行讲解。准备工作
搞定了短链接的核心算法,我们可以开始进行业务开发。本章将进行一系列的准备工作,包括:配置、日志、自定义错误、handler、数据库操作原型、模板等。创建短链接
本章将实现创建短链接功能。短链接跳转到原始链接
我们继续实现功能,本章要实现的是通过短链接跳转到原始链接的功能。注意,跳转之前,我们需要将它的访问量加一。排行榜
本章继续完善短链接服务:显示排行。总结与代码清理
目前为止,我们的短链接服务基本已经完成了。但有一些地方不完善,同时有些警告没有处理掉。
创建短链接
本章将实现创建短链接功能。
本章代码在03/创建短链接分支。
可以看到,我们只是简单的做了一个表单。
/// 处理提交的内容
pub async fn index_action(
Extension(state): Extension<AppState>,
Form(cu): Form<form::CreateUrl>,
) -> HandlerRedirectResult {
let id = core::short_url(&cu.url);
let handler_name = "index_action";
let client = get_client(&state, handler_name).await?;
let result = db::create(&client, cu, id)
.await
.map_err(log_error(handler_name.to_string()))?;
let msg = MsgArgs {
ok: Some(format!("添加成功,短网址是:{}", result.id)),
err: None,
target: Some("/".to_string()),
};
Ok(redirect_with_msg("/msg", Some(&msg)))
}
/// 首页
pub async fn index() -> HandlerHtmlResult {
let handler_name = "index";
let tmpl = IndexTemplate {};
render(tmpl).map_err(log_error(handler_name.to_string()))
}
-
index_action
:用于接收用户提交的表单,并将其作为参数调用数据库操作的函数 -
index
:显示表单
index_action
:用于接收用户提交的表单,并将其作为参数调用数据库操作的函数
数据库操作
pub async fn create(client: &Client, cu: form::CreateUrl, id: String) -> Result<UrlID> {
// 是否存在
let result = super::query_one(client, "SELECT id FROM url WHERE id=$1", &[&id]).await;
match result {
// 如果已存在,直接返回
Ok(result) => return Ok(result),
// 如果不是“未找到”的错误,直接返回
Err(err) if !err.is_not_found() => return Err(err),
// 如果不存在,什么也不做,继续下面的代码
_ => {}
};
let result = super::query_one(
client,
"INSERT INTO url(id, url, email) VALUES ($1,$2,$3) RETURNING id",
&[&id, &cu.url, &cu.email],
)
.await?;
Ok(result)
}
首先判断提交的原始链接是否存在,如果存在,直接返回对应的短链接。否则,将提交的数据写入数据库。注意,虽然这个函数有两个数据库操作,但并不需要使用事务来保证原子性,因为这两个操作是无关联的。