1use bytes::BytesMut;
2use http::{HeaderMap, Method};
3use httparse::ParserConfig;
4
5use crate::body::DecodedLength;
6use crate::proto::{BodyLength, MessageHead};
7
8pub(crate) use self::conn::Conn;
9pub(crate) use self::decode::Decoder;
10pub(crate) use self::dispatch::Dispatcher;
11pub(crate) use self::encode::{EncodedBuf, Encoder};
12//TODO: move out of h1::io
13pub(crate) use self::io::MINIMUM_MAX_BUFFER_SIZE;
14
15mod conn;
16mod decode;
17pub(crate) mod dispatch;
18mod encode;
19mod io;
20mod role;
21
22cfg_client! {
23 pub(crate) type ClientTransaction = role::Client;
24}
25
26cfg_server! {
27 pub(crate) type ServerTransaction = role::Server;
28}
29
30pub(crate) trait Http1Transaction {
31 type Incoming;
32 type Outgoing: Default;
33 #[cfg(feature = "tracing")]
34 const LOG: &'static str;
35 fn parse(bytes: &mut BytesMut, ctx: ParseContext<'_>) -> ParseResult<Self::Incoming>;
36 fn encode(enc: Encode<'_, Self::Outgoing>, dst: &mut Vec<u8>) -> crate::Result<Encoder>;
37
38 fn on_error(err: &crate::Error) -> Option<MessageHead<Self::Outgoing>>;
39
40 fn is_client() -> bool {
41 !Self::is_server()
42 }
43
44 fn is_server() -> bool {
45 !Self::is_client()
46 }
47
48 fn should_error_on_parse_eof() -> bool {
49 Self::is_client()
50 }
51
52 fn should_read_first() -> bool {
53 Self::is_server()
54 }
55
56 fn update_date() {}
57}
58
59/// Result newtype for Http1Transaction::parse.
60pub(crate) type ParseResult<T> = Result<Option<ParsedMessage<T>>, crate::error::Parse>;
61
62#[derive(Debug)]
63pub(crate) struct ParsedMessage<T> {
64 head: MessageHead<T>,
65 decode: DecodedLength,
66 expect_continue: bool,
67 keep_alive: bool,
68 wants_upgrade: bool,
69}
70
71pub(crate) struct ParseContext<'a> {
72 cached_headers: &'a mut Option<HeaderMap>,
73 req_method: &'a mut Option<Method>,
74 h1_parser_config: ParserConfig,
75 h1_max_headers: Option<usize>,
76 preserve_header_case: bool,
77 #[cfg(feature = "ffi")]
78 preserve_header_order: bool,
79 h09_responses: bool,
80 #[cfg(feature = "client")]
81 on_informational: &'a mut Option<crate::ext::OnInformational>,
82}
83
84/// Passed to Http1Transaction::encode
85pub(crate) struct Encode<'a, T> {
86 head: &'a mut MessageHead<T>,
87 body: Option<BodyLength>,
88 #[cfg(feature = "server")]
89 keep_alive: bool,
90 req_method: &'a mut Option<Method>,
91 title_case_headers: bool,
92 #[cfg(feature = "server")]
93 date_header: bool,
94}
95
96/// Extra flags that a request "wants", like expect-continue or upgrades.
97#[derive(Clone, Copy, Debug)]
98struct Wants(u8);
99
100impl Wants {
101 const EMPTY: Wants = Wants(0b00);
102 const EXPECT: Wants = Wants(0b01);
103 const UPGRADE: Wants = Wants(0b10);
104
105 #[must_use]
106 fn add(self, other: Wants) -> Wants {
107 Wants(self.0 | other.0)
108 }
109
110 fn contains(&self, other: Wants) -> bool {
111 (self.0 & other.0) == other.0
112 }
113}
114