ferrum 0.2.1

Extensible, Concurrency Focused Web Framework in Rust.
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

use std::fmt;

use {Response};

pub use std::error::Error;
pub use hyper::Error as HyperError;
pub use hyper::error::Result as HyperResult;
use hyper::Response as HyperResponse;
use hyper::header::ContentLength;
use hyper::StatusCode;

/// The type of Errors inside and when using Ferrum.
///
/// `FerrumError` informs its receivers of two things:
///
/// * What went wrong
/// * What to do about it
///
/// The `error` field is responsible for informing receivers of which
/// error occured, and receivers may also modify the error field by layering
/// it (building up a cause chain).
///
/// The `response` field provides a tangible action to be taken if this error
/// is not otherwise handled.
#[derive(Debug)]
pub struct FerrumError {
    /// The underlying error
    ///
    /// This can be layered and will be logged at the end of an errored request.
    pub error: Box<Error + Send>,

    /// What to do about this error.
    ///
    /// This Response will be used when the error-handling flow finishes.
    pub response: Option<Response>
}

impl FerrumError {
    /// Create a new `FerrumError` from an error and a response.
    pub fn new<E: 'static + Error + Send>(error: E, response: Option<Response>) -> FerrumError {
        FerrumError {
            error: Box::new(error),
            response
        }
    }
}

impl fmt::Display for FerrumError {
    fn fmt(&self, formatter: &mut fmt::Formatter) -> Result<(), fmt::Error> {
        fmt::Display::fmt(&*self.error, formatter)
    }
}

impl Error for FerrumError {
    fn description(&self) -> &str {
        self.error.description()
    }

    fn cause(&self) -> Option<&Error> {
        self.error.cause()
    }
}

impl From<FerrumError> for HyperResponse {
    fn from(error: FerrumError) -> HyperResponse {
        match error.response {
            Some(response) => HyperResponse::from(response),
            None => {
                let error_message = format!("ERROR: {}", error);
                HyperResponse::new()
                    .with_header(ContentLength(error_message.len() as u64))
                    .with_body(error_message)
                    .with_status(StatusCode::InternalServerError)
            }
        }
    }
}