存档文章列表

模板

本功能模板文件是templates/frontend/topic_arch.html。

视图类

本功能视图类定义在src/view/frontend/topic.rs文件。

handler

• 通过 Path(dt): Path<String>获取到的是数据是字符串类型的、类似2022年03月这种格式的数据。
• let dt = format!("{}01 00:00:00", dt);将上述说的数据拼接为类似2022年03月01 00:00:00的格式
• let dt = Local.datetime_from_str(&dt, "%Y年%m月%d %H:%M:%S").map_err(AppError::from).map_err(log_error(handler_name))?;将上述的数据转换成chrono::DateTime<Local>。通过这个操作，可以确保传入的参数的格式是正确的。
• let dt = dt.format("%Y-%m-%d %H:%M:%S").to_string();将其转换成2022-03-01 00:00:00的格式的字符串。

通过上面一系列的操作，我们最终得到了某年某月1日，零点零分零秒的日期时间。

topic::list_by_arch()：通过传入的日期时间(每月1日零点，月初)，使用 PostgreSQL 计算出月初和月尾的所有文章。

数据库操作

// src/db/topic.rs
pub async fn list_by_arch(
    client: &Client,
    page: u32,
    dt:String,
) -> Result<Paginate<Vec<TopicList>>> {
    let condition = format!("dateline BETWEEN '{}'::timestamp AND '{}'::timestamp + (INTERVAL '1' MONTH) - (INTERVAL '1' SECOND)", &dt, &dt);
    list_by_condition(client, page, Some(&condition), Some(&[])).await
}

SELECT 
	id,title,category_id,summary,hit,dateline,is_del,category_name 
FROM v_topic_cat_list 
WHERE
	is_del=false AND 
	dateline BETWEEN '2022-03-01 00:00:00'::timestamp AND '2022-03-01 00:00:00'::timestamp + (INTERVAL '1' MONTH) - (INTERVAL '1' SECOND)
ORDER BY id DESC
LIMIT 30 OFFSET 0

• '2022-03-01 00:00:00'::timestamp：将字符串 '2022-03-01 00:00:00'转换为Postgresql的timestamp类型
• '2022-03-01 00:00:00'::timestamp + (INTERVAL '1' MONTH)：在 2022-03-01 00:00:00的基础上加上1个月，结果为2022-04-01 00:00:00
• - (INTERVAL '1' SECOND)：再将上一步的结果减去1秒，变成2022-03-31 23:59:59
• 代入以上结果之后，dateline BETWEEN '2022-03-01 00:00:00' AND '2022-03-31 23:59:59' ，实现我们的目标

这里之所以要这样操作，是因为每个月的天数是不一定的，如果使用固定的值，比如30天等，结果会不精确。当然对于博客来说，这种程度的不精确也是可以接受的。现在既然AXUM中文网给出了精确的方案，那自然应该用此方案了。

路由

本功能的路由定义在src/handler/frontend/mod.rs。

AppError

为了处理chrono可能产生的错误，对AppError进行了补充：

/// src/error.rs

#[derive(Debug)]
pub enum AppErrorType {
 		// ...
    Chrono,
}

impl From<chrono::ParseError> for AppError {
    fn from(err: chrono::ParseError) -> Self {
        Self::from_err(Box::new(err), AppErrorType::Chrono)
    }
}

本章代码位于10/存档分支。