Rust的Actix默认响应处理器actix-default-responder使用指南

actix-default-responder是一个用于Actix-web框架的中间件，它简化了Web应用中的错误处理和HTTP响应标准化流程。

主要功能

1. 自动将错误转换为标准化的HTTP响应
2. 提供一致的错误响应格式
3. 简化错误处理代码
4. 支持自定义错误响应格式

安装

在Cargo.toml中添加依赖：

[dependencies]
actix-default-responder = "0.5"
actix-web = "4"

基本使用方法

1. 基本示例

use actix_web::{get, App, HttpServer, HttpResponse};
use actix_default_responder::DefaultResponder;

#[get("/")]
async fn index() -> Result<HttpResponse, std::io::Error> {
    Ok(HttpResponse::Ok().body("Hello world!"))
}

#[actix_web::main]
async fn main() -> std::io::Result<()> {
    HttpServer::new(|| {
        App::new()
            .wrap(DefaultResponder::default())
            .service(index)
    })
    .bind("127.0.0.1:8080")?
    .run()
    .await
}

2. 错误处理示例

use actix_web::{get, App, HttpServer, HttpResponse};
use actix_default_responder::DefaultResponder;
use thiserror::Error;

#[derive(Error, Debug)]
enum MyError {
    #[error("Not Found")]
    NotFound,
    #[error("Internal Server Error")]
    Internal,
}

#[get("/items/{id}")]
async fn get_item(id: web::Path<u32>) -> Result<HttpResponse, MyError> {
    if *id == 0 {
        return Err(MyError::NotFound);
    }
    if *id == 999 {
        return Err(MyError::Internal);
    }
    Ok(HttpResponse::Ok().body(format!("Item {}", id)))
}

#[actix_web::main]
async fn main() -> std::io::Result<()> {
    HttpServer::new(|| {
        App::new()
            .wrap(DefaultResponder::default())
            .service(get_item)
    })
    .bind("127.0.0.1:8080")?
    .run()
    .await
}

自定义响应格式

use actix_web::{get, App, HttpServer, HttpResponse};
use actix_default_responder::{DefaultResponder, DefaultResponderConfig};
use serde_json::json;

#[get("/")]
async fn index() -> Result<HttpResponse, std::io::Error> {
    Ok(HttpResponse::Ok().body("Hello world!"))
}

#[actix_web::main]
async fn main() -> std::io::Result<()> {
    let config = DefaultResponderConfig::default()
        .error_formatter(|err, status| {
            let error_message = err.to_string();
            let json_response = json!({
                "success": false,
                "error": error_message,
                "status": status.as_u16()
            });
            HttpResponse::build(status).json(json_response)
        });

    HttpServer::new(|| {
        App::new()
            .wrap(DefaultResponder::new(config.clone()))
            .service(index)
    })
    .bind("127.0.0.1:8080")?
    .run()
    .await
}

高级配置

1. 自定义状态码映射

use actix_web::{get, App, HttpServer, HttpResponse};
use actix_default_responder::{DefaultResponder, DefaultResponderConfig};
use thiserror::Error;

#[derive(Error, Debug)]
enum MyError {
    #[error("Not Found")]
    NotFound,
    #[error("Forbidden")]
    Forbidden,
}

#[get("/items/{id}")]
async fn get_item(id: web::Path<u32>) -> Result极好的，根据您提供的完整内容，我将为您展示一个结合了所有特性的完整示例demo，包含自定义错误处理、响应格式和状态码映射：

```rust
use actix_web::{get, web, App, HttpServer, HttpResponse};
use actix_default_responder::{DefaultResponder, DefaultResponderConfig};
use serde_json::json;
use thiserror::Error;

// 自定义错误类型
#[derive(Error, Debug)]
enum ApiError {
    #[error("Authentication failed")]
    Unauthorized,
    #[error("Resource not found")]
    NotFound,
    #[error("Internal server error")]
    Internal,
}

// 自定义响应格式
fn custom_error_formatter(err: &dyn std::error::Error, status: actix_web::http::StatusCode) -> HttpResponse {
    let error_message = err.to_string();
    let json_response = json!({
        "ok": false,
        "code": status.as_u16(),
        "message": error_message,
        "timestamp": chrono::Utc::now().to_rfc3339()
    });
    HttpResponse::build(status).json(json_response)
}

#[get("/users/{id}")]
async fn get_user(id: web::Path<u32>) -> Result<HttpResponse, ApiError> {
    match *id {
        0 => Err(ApiError::NotFound),
        1 => Err(ApiError::Unauthorized),
        2 => Err(ApiError::Internal),
        _ => Ok(HttpResponse::Ok().json(json!({
            "id": id,
            "name": format!("User {}", id)
        })))
    }
}

#[actix_web::main]
async fn main() -> std::io::Result<()> {
    // 配置默认响应处理器
    let config = DefaultResponderConfig::default()
        .error_formatter(custom_error_formatter)
        .with_status_code::<ApiError>(|err| match err {
            ApiError::Unauthorized => actix_web::http::StatusCode::UNAUTHORIZED,
            ApiError::NotFound => actix_web::http::StatusCode::NOT_FOUND,
            ApiError::Internal => actix_web::http::StatusCode::INTERNAL_SERVER_ERROR,
        });

    HttpServer::new(move || {
        App::new()
            .wrap(DefaultResponder::new(config.clone()))
            .service(get_user)
    })
    .bind("127.0.0.1:8080")?
    .run()
    .await
}

这个完整示例展示了：

1. 自定义错误类型ApiError，包含三种常见错误情况
2. 自定义的错误响应格式，包含时间戳和标准化的字段名
3. 为每种错误类型映射到适当的HTTP状态码
4. 成功和错误的统一响应格式处理

您可以通过访问以下端点测试：

• /users/0 - 返回404 Not Found
• /users/1 - 返回401 Unauthorized
• /users/2 - 返回500 Internal Server Error
• /users/3 - 返回成功的用户数据