文章

本章继续完善短链接服务：显示排行。

我们继续实现功能，本章要实现的是通过短链接跳转到原始链接的功能。注意，跳转之前，我们需要将它的访问量加一。

本章将实现创建短链接功能。

搞定了短链接的核心算法，我们可以开始进行业务开发。本章将进行一系列的准备工作，包括：配置、日志、自定义错误、handler、数据库操作原型、模板等。

本章将对短链接的原理及实现算法进行讲解。

本专题将带你使用 axum 构建一个短链接服务。短链接，又称短网址，是指将一个可能比较长的链接变成固定长度的短链接，便于在社交媒体、短信等渠道发布。另外，它也可以隐藏原链接里的一些敏感信息，比如带邀请码的推广链接。

经过一番不懈努力，我们终于完成了一个提供 RESTFul API 的 Todo 服务。虽然功能简单，但它涉及到了 Axum 开发的多个方面。

经过一番重构，目前我们的 Todo 服务已经基本完善了，现在只差最后一个部分：TodoItem。本章我们就来实现它。

本章我们将对之前的代码进行重构并且使用日志记录可能发生的错误。

现在是时候开始进行数据库操作，以便实现功能了。本章将实现`TodoList`的功能。

我们的 Todo 服务是对外提供 API 的服务，它的响应格式总是`JSON`类型。为此，我们可以定义响应类型，以简化 handler 的编写。

本章我们将自定义错误、自定义一个`Result`以及让它们作为 handler 的返回值，进行 HTTP 响应。

本章我们将实现配置文件的加载。我们将对 axum 的监听地址和 PostgreSQL 相关的信息进行配置，并保存到`.env`文件中。

本专题将带你从零开始实现一个简单的、RESTFUL 风格的 Todo 服务。包括：JSON 响应及请求、PostgreSQL 的使用、自定义错误的处理、RESTFul 的定义、配置文件、日志的记录等。

将数据库连接信息、redis 连接信息以及 Web 应用监听地址等信息通过配置文件进行单独管理是一个比较好的开发实践。这样就无须在更改配置的时候重新编译整个项目，同时也可以针对不同环境使用不同的配置文件。

在机器人采集、恶意攻击的今天，人机验证筑起了一道保护网。从之前的图片验证码，到 Google 提供的 reCaptcha，人机验证经历了一段漫长的演进过程。

文件上传是 Web 开发中常见的功能，本章将演示如何在 axum 实现文件上传。

利用模板引擎，我们不需要再把 HTML 代码写在 Rust 代码中了，而是将其独立保存为`*.html`文件。既方便维护，也有利用开发。

Json web token（JWT）是为了网络应用环境间传递声明而执行的一种基于 JSON 的开发标准（RFC 7519），该 token 被设计为紧凑且安全的，特别适用于分布式站点的单点登陆（SSO）场景。JWT 的声明一般被用来在身份提供者和服务提供者间传递被认证的用户身份信息，以便于从资源服务器获取资源，也可以增加一些额外的其它业务逻辑所必须的声明信息，该 token 也可直接被用于认证，也可被加密。

由于 HTTP 是无状态的，所以我们可以通过Cookie来维护状态。但 cookie 是直接保存到客户端，所以对于敏感数据，不能直接保存到 cookie。我们可以把敏感数据保存到服务端，然后把对应的 ID 保存到 cookie，这就是 Session。本章我们将使用 Cookie 和 Redis 实现一个简单的 Session。

PostgreSQL 是一款天然支持异步操作的高性能开源关系型数据库。本章将讨论如何在 axum 中使用 PostgreSQL。包括：数据的增加、修改、删除、查找以及开始事务保证业务的原子性。

通过 redis-rs 这个 crate，可以很方便的操作 redis。它提供了同步和异步两种连接，由于我们要集成到 axum 中，所以这里使用异步连接。本章将展示如何获取 redis 异步连接、如何将字符串保存到 redis、如何获取到保存在 redis 里的字符串以及如何通过 redis 保存和读取自定义结构体。

Cookie 是通过 HTTP Header 进行传递的。由某个响应头进行设置，然后其它请求头就可以获取到了。本章将通过模拟用户中心来用 axum 操作 HTTP Header 演示 Cookie 的读写操作。

和其它 Web 框架一样，axum 也会对所有请求进行处理。对于 CSS、JS 及图片等静态文件，并不需要 axum 的 handler 进行处理，而是只需要简单的把它们的内容进行返回即可。axum 提供了处理静态文件的中间件。

中间件是一类提供系统软件和应用软件之间连接、便于软件各部件之间的沟通的软件，应用软件可以借助中间件在不同的技术架构之间共享信息与资源。本章将讨论如何在axum中使用中间件，以及如何自定义中间件。

axum 提供了常用的 HTTP 请求方式对应的路由，比如 `get`, `post`, `put`, `delete` 等。除此之外，axum 还提供了“嵌套路由”。路由，通常和 `handler(处理函数)` 结合在一起。

**状态共享**是指，在整个应用或不同路由之间，共享一份数据。axum 提供了方便的状态共享机制，但可能也会踩坑。本章将带你学习如何在 axum web 应用中共享状态。

在日常开发中，我们需要与用户进行交互，从各种渠道获取用户输入，包括但不限于：表单、URL 参数、URL Path 以及 JSON 等。axum 为我们提供了这些获取用户输入的支持。

本章主要讨论 axum 的响应。axum 已经实现了多种响应，比如纯文本、HTML、JSON 及 自定义响应头(response header)。除了这些 axum 内置的响应之外，我们还将讨论如何将自己定义的结构体，作为响应返回给客户端。