sark-core 0.13.0

the L7 layer for dope
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
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

use http::StatusCode;
use o3::buffer::Shared;

use super::Response;
use super::body::Body;
use super::header::HeaderList;
use super::wire_emit::{CRLF, HeadWrite, ProvenWireWriter, TransferEncodingChunked};
use crate::http::codec::Wire;

#[derive(Clone, Debug)]
pub struct Chunked {
    status: StatusCode,
    headers: HeaderList,
    wire_headers: Shared,
    parts: Vec<Shared>,
}

impl Chunked {
    pub fn status(&self) -> StatusCode {
        self.status
    }

    pub fn into_response(self) -> Response {
        Response {
            status: self.status,
            headers: self.headers,
            wire_headers: self.wire_headers.as_ref().to_vec(),
            body: Body::empty(),
            chunked_parts: Some(self.parts),
        }
    }

    pub(super) fn from_parts(
        status: StatusCode,
        headers: HeaderList,
        wire_headers: Shared,
        parts: Vec<Shared>,
    ) -> Self {
        Self {
            status,
            headers,
            wire_headers,
            parts,
        }
    }

    const ZERO_CHUNK: &'static [u8] = b"0\r\n\r\n";

    fn body_wire_len(&self) -> Option<usize> {
        let mut len = 0usize;
        for part in &self.parts {
            if part.is_empty() {
                continue;
            }
            let mut hex = [0u8; 16];
            let hex_n = Wire::write_hex(part.len(), &mut hex);
            len = len
                .checked_add(hex_n)?
                .checked_add(CRLF.len())?
                .checked_add(part.len())?
                .checked_add(CRLF.len())?;
        }
        len.checked_add(Self::ZERO_CHUNK.len())
    }

    fn write_body(&self, out: &mut ProvenWireWriter<'_>) {
        for part in &self.parts {
            if part.is_empty() {
                continue;
            }
            let mut hex = [0u8; 16];
            let hex_n = Wire::write_hex(part.len(), &mut hex);
            out.put(&hex[..hex_n]);
            out.put(CRLF);
            out.put(part.as_ref());
            out.put(CRLF);
        }
        out.put(Self::ZERO_CHUNK);
    }

    fn head(&self) -> HeadWrite<'_, [u8], TransferEncodingChunked> {
        HeadWrite {
            status: self.status,
            headers: self.wire_headers.as_ref(),
            framing: TransferEncodingChunked,
        }
    }

    pub fn write_into_slice(&self, out: &mut [u8], date: &[u8; 29]) -> Option<usize> {
        let head = self.head();
        let total = head.wire_len().checked_add(self.body_wire_len()?)?;
        let mut out = ProvenWireWriter::new(out, total)?;
        head.emit(&mut out, date);
        self.write_body(&mut out);
        Some(out.finish(total))
    }

    pub fn write_head_split(self, out: &mut [u8], date: &[u8; 29]) -> Option<(usize, Shared)> {
        let head = self.head();
        let head_len = head.wire_len();
        let body_len = self.body_wire_len()?;
        let mut out = ProvenWireWriter::new(out, head_len)?;
        head.emit(&mut out, date);
        let written = out.finish(head_len);

        let mut body = vec![0u8; body_len];
        let mut out = ProvenWireWriter::exact(&mut body);
        self.write_body(&mut out);
        out.finish(body_len);
        Some((written, Shared::from(body)))
    }
}