axum-yaml

axum-yaml 为 axum 添加 YAML 功能

功能

• 序列化和反序列化请求/响应中的 YAML

使用示例

提取器示例

当用作提取器时，它可以反序列化请求体为实现了 serde::Deserialize 的某些类型。如果请求体无法解析，或者它不包含 Content-Type: application/yaml 头部，它将拒绝请求并返回 400 Bad Request 响应。

use axum::{
    extract,
    routing::post,
    Router,
};
use axum_yaml::Yaml;
use serde::Deserialize;

#[derive(Deserialize)]
struct CreateUser {
    email: String,
    password: String,
}

async fn create_user(Yaml(payload): Yaml<CreateUser>) {
    // payload is a `CreateUser`
}

let app = Router::new().route("/users", post(create_user));

[!NOTE] 此外，您还可以从字节数组（Yaml::from_bytes()）构造 Yaml<T>。大多数用户应首选使用 FromRequest 实现，但特殊情况可能需要首先将 Request 提取为 Bytes，然后可选地构造一个 Yaml<T>。

use axum::{
    extract::Path,
    routing::get,
    Router,
};

use axum_yaml::Yaml;
use serde::Serialize;
use uuid::Uuid;

#[derive(Serialize)]
struct User {
    id: Uuid,
    username: String,
}

async fn get_user(Path(user_id) : Path<Uuid>) -> Yaml<User> {
    let user = find_user(user_id).await;
    Yaml(user)
}

async fn find_user(user_id: Uuid) -> User {
    // ...
}

let app = Router::new().route("/users/:id", get(get_user));