actix_multipart/
error.rs

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
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
//! Error and Result module

use actix_web::{
    error::{ParseError, PayloadError},
    http::StatusCode,
    ResponseError,
};
use derive_more::{Display, Error, From};

/// A set of errors that can occur during parsing multipart streams.
#[derive(Debug, Display, From, Error)]
#[non_exhaustive]
pub enum Error {
    /// Could not find Content-Type header.
    #[display(fmt = "Could not find Content-Type header")]
    ContentTypeMissing,

    /// Could not parse Content-Type header.
    #[display(fmt = "Could not parse Content-Type header")]
    ContentTypeParse,

    /// Parsed Content-Type did not have "multipart" top-level media type.
    ///
    /// Also raised when extracting a [`MultipartForm`] from a request that does not have the
    /// "multipart/form-data" media type.
    ///
    /// [`MultipartForm`]: struct@crate::form::MultipartForm
    #[display(fmt = "Parsed Content-Type did not have "multipart" top-level media type")]
    ContentTypeIncompatible,

    /// Multipart boundary is not found.
    #[display(fmt = "Multipart boundary is not found")]
    BoundaryMissing,

    /// Content-Disposition header was not found or not of disposition type "form-data" when parsing
    /// a "form-data" field.
    ///
    /// As per [RFC 7578 §4.2], a "multipart/form-data" field's Content-Disposition header must
    /// always be present and have a disposition type of "form-data".
    ///
    /// [RFC 7578 §4.2]: https://datatracker.ietf.org/doc/html/rfc7578#section-4.2
    #[display(fmt = "Content-Disposition header was not found when parsing a \"form-data\" field")]
    ContentDispositionMissing,

    /// Content-Disposition name parameter was not found when parsing a "form-data" field.
    ///
    /// As per [RFC 7578 §4.2], a "multipart/form-data" field's Content-Disposition header must
    /// always include a "name" parameter.
    ///
    /// [RFC 7578 §4.2]: https://datatracker.ietf.org/doc/html/rfc7578#section-4.2
    #[display(fmt = "Content-Disposition header was not found when parsing a \"form-data\" field")]
    ContentDispositionNameMissing,

    /// Nested multipart is not supported.
    #[display(fmt = "Nested multipart is not supported")]
    Nested,

    /// Multipart stream is incomplete.
    #[display(fmt = "Multipart stream is incomplete")]
    Incomplete,

    /// Field parsing failed.
    #[display(fmt = "Error during field parsing")]
    Parse(ParseError),

    /// HTTP payload error.
    #[display(fmt = "Payload error")]
    Payload(PayloadError),

    /// Stream is not consumed.
    #[display(fmt = "Stream is not consumed")]
    NotConsumed,

    /// Form field handler raised error.
    #[display(fmt = "An error occurred processing field: {name}")]
    Field {
        name: String,
        source: actix_web::Error,
    },

    /// Duplicate field found (for structure that opted-in to denying duplicate fields).
    #[display(fmt = "Duplicate field found: {_0}")]
    #[from(ignore)]
    DuplicateField(#[error(not(source))] String),

    /// Required field is missing.
    #[display(fmt = "Required field is missing: {_0}")]
    #[from(ignore)]
    MissingField(#[error(not(source))] String),

    /// Unknown field (for structure that opted-in to denying unknown fields).
    #[display(fmt = "Unknown field: {_0}")]
    #[from(ignore)]
    UnknownField(#[error(not(source))] String),
}

/// Return `BadRequest` for `MultipartError`.
impl ResponseError for Error {
    fn status_code(&self) -> StatusCode {
        match &self {
            Error::Field { source, .. } => source.as_response_error().status_code(),
            Error::ContentTypeIncompatible => StatusCode::UNSUPPORTED_MEDIA_TYPE,
            _ => StatusCode::BAD_REQUEST,
        }
    }
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn test_multipart_error() {
        let resp = Error::BoundaryMissing.error_response();
        assert_eq!(resp.status(), StatusCode::BAD_REQUEST);
    }
}