mycelium-http-tools 8.3.0+beta

Provide HTTP related elements to the mycelium project.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82

use actix_web::{
    error,
    http::{header::ContentType, StatusCode},
    HttpResponse,
};
use derive_more::Display;
use serde::Serialize;
use std::fmt::Debug;

/// The default JSON response from API errors
///
/// Use it in replacement of the simple html body.
#[derive(Debug, Serialize)]
pub(crate) struct HttpJsonResponse {
    msg: String,
    status: u16,
    message: String,
}

/// Internal errors as HTTP responses
///
/// Forwarding errors are fired only by Stomata errors.
#[derive(Debug, Display)]
pub enum GatewayError {
    // ? -----------------------------------------------------------------------
    // ? Client errors (4xx)
    // ? -----------------------------------------------------------------------
    #[display(fmt = "BadRequest")]
    BadRequest(String),

    #[display(fmt = "BadGateway")]
    BadGateway(String),

    #[display(fmt = "Forbidden")]
    Forbidden(String),

    #[display(fmt = "Unauthorized")]
    Unauthorized(String),

    #[display(fmt = "MethodNotAllowed")]
    MethodNotAllowed(String),

    // ? -----------------------------------------------------------------------
    // ? Server errors (5xx)
    // ? -----------------------------------------------------------------------
    #[display(fmt = "InternalServerError")]
    InternalServerError(String),
}

impl error::ResponseError for GatewayError {
    fn error_response(&self) -> HttpResponse {
        HttpResponse::build(self.status_code())
            .insert_header(ContentType::json())
            .json(HttpJsonResponse {
                msg: self.to_string(),
                status: self.status_code().as_u16(),
                message: match self {
                    GatewayError::BadRequest(msg) => msg.to_owned(),
                    GatewayError::BadGateway(msg) => msg.to_owned(),
                    GatewayError::Forbidden(msg) => msg.to_owned(),
                    GatewayError::Unauthorized(msg) => msg.to_owned(),
                    GatewayError::MethodNotAllowed(msg) => msg.to_owned(),
                    GatewayError::InternalServerError(msg) => msg.to_owned(),
                },
            })
    }

    fn status_code(&self) -> StatusCode {
        match *self {
            GatewayError::BadRequest { .. } => StatusCode::BAD_REQUEST,
            GatewayError::BadGateway { .. } => StatusCode::BAD_GATEWAY,
            GatewayError::Forbidden { .. } => StatusCode::FORBIDDEN,
            GatewayError::Unauthorized { .. } => StatusCode::UNAUTHORIZED,
            GatewayError::MethodNotAllowed { .. } => {
                StatusCode::METHOD_NOT_ALLOWED
            }
            GatewayError::InternalServerError { .. } => {
                StatusCode::INTERNAL_SERVER_ERROR
            }
        }
    }
}