rbdc-mysql 4.8.2

The Rust SQL Toolkit and ORM Library. An async, pure Rust SQL crate featuring compile-time Dynamic SQL
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

use bytes::{Buf, Bytes};

use crate::io::MySqlBufExt;
use crate::protocol::Row;
use crate::result_set::MySqlColumn;
use rbdc::io::Decode;
use rbdc::Error;

#[derive(Debug)]
pub struct TextRow(pub Row);

impl<'de> Decode<'de, &'de [MySqlColumn]> for TextRow {
    fn decode_with(mut buf: Bytes, columns: &'de [MySqlColumn]) -> Result<Self, Error> {
        let storage = buf.clone();
        let offset = buf.len();

        let mut values = Vec::with_capacity(columns.len());

        for _ in columns {
            if buf[0] == 0xfb {
                // NULL is sent as 0xfb
                values.push(None);
                buf.advance(1);
            } else {
                let size = buf.get_uint_lenenc() as usize;
                let offset = offset - buf.len();

                // bounds check to avoid panic when server returns non-MySQL-compliant payloads (e.g., ClickHouse MySQL compatibility layer)
                if size > buf.len() {
                    return Err(rbdc::Error::protocol(format!(
                        "text row column length {} exceeds remaining {} bytes (first byte: 0x{:02x})",
                        size,
                        buf.len(),
                        storage[offset] // original first byte of this value in storage snapshot
                    )));
                }

                values.push(Some(offset..(offset + size)));

                buf.advance(size);
            }
        }
        Ok(TextRow(Row::from((values, storage.to_vec()))))
    }
}