      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

    use bytes::BytesMut;
    use http::{HeaderMap, Method};

    use crate::body::DecodedLength;
    use crate::proto::{BodyLength, MessageHead};

    pub(crate) use self::conn::Conn;
    pub(crate) use self::decode::Decoder;
    pub(crate) use self::dispatch::Dispatcher;
    pub(crate) use self::encode::{EncodedBuf, Encoder};
     //TODO: move out of h1::io
    pub(crate) use self::io::MINIMUM_MAX_BUFFER_SIZE;

    mod conn;
    mod decode;
    pub(crate) mod dispatch;
    mod encode;
    mod io;
    mod role;

    cfg_client! {
        pub(crate) type ClientTransaction = role::Client;
    }

    cfg_server! {
        pub(crate) type ServerTransaction = role::Server;
    }

    pub(crate) trait Http1Transaction {
        type Incoming;
        type Outgoing: Default;
        const LOG: &'static str;
        fn parse(bytes: &mut BytesMut, ctx: ParseContext<'_>) -> ParseResult<Self::Incoming>;
        fn encode(enc: Encode<'_, Self::Outgoing>, dst: &mut Vec<u8>) -> crate::Result<Encoder>;

        fn on_error(err: &crate::Error) -> Option<MessageHead<Self::Outgoing>>;

        fn is_client() -> bool {
            !Self::is_server()
        }

        fn is_server() -> bool {
            !Self::is_client()
        }

        fn should_error_on_parse_eof() -> bool {
            Self::is_client()
        }

        fn should_read_first() -> bool {
            Self::is_server()
        }

        fn update_date() {}
    }

    /// Result newtype for Http1Transaction::parse.
    pub(crate) type ParseResult<T> = Result<Option<ParsedMessage<T>>, crate::error::Parse>;

    #[derive(Debug)]
    pub(crate) struct ParsedMessage<T> {
        head: MessageHead<T>,
        decode: DecodedLength,
        expect_continue: bool,
        keep_alive: bool,
        wants_upgrade: bool,
    }

    pub(crate) struct ParseContext<'a> {
        cached_headers: &'a mut Option<HeaderMap>,
        req_method: &'a mut Option<Method>,
        #[cfg(feature = "ffi")]
        preserve_header_case: bool,
    }

    /// Passed to Http1Transaction::encode
    pub(crate) struct Encode<'a, T> {
        head: &'a mut MessageHead<T>,
        body: Option<BodyLength>,
        #[cfg(feature = "server")]
        keep_alive: bool,
        req_method: &'a mut Option<Method>,
        title_case_headers: bool,
    }

    /// Extra flags that a request "wants", like expect-continue or upgrades.
    #[derive(Clone, Copy, Debug)]
    struct Wants(u8);

    impl Wants {
        const EMPTY: Wants = Wants(0b00);
        const EXPECT: Wants = Wants(0b01);
        const UPGRADE: Wants = Wants(0b10);

        #[must_use]
        fn add(self, other: Wants) -> Wants {
            Wants(self.0 | other.0)
        }

        fn contains(&self, other: Wants) -> bool {
            (self.0 & other.0) == other.0
        }
    }