tobytcp

TobyTcp是一个协议，它允许使用原始tcp流进行双向消息通信。它使用长度前缀来划分消息。此库提供编码/解码该消息前缀的方法，同时也提供async发送和接收方法。

注意：可能已准备好用于生产。请参阅下面的免责声明部分。

文档

编写

请参阅/examples和单元测试来编译示例！

let prefix = protocol::tobytcp_prefix(data.len());

stream.write_all(&prefix)?;
stream.write_all(&data)?;

// OR use the send method in lib, which does almost exactly ^
send(&mut data, &mut stream).await?;

阅读

请参阅/examples和单元测试来编译示例！

let mut len_buf = [0; 8];
stream.read_exact(&mut len_buf)?;
let length = protocol::tobytcp_len(len_buf);

let mut msg_buf = [0; length as usize];
stream.read_exact(&mut msg_buf)?; // Done, we have received the message into msg_buf

// OR use the receive method in lib which does almost exactly ^
let data = receive(&mut buf, &mut stream).await?;;

TobyTcp协议

TobyTcp协议使用长度前缀进行消息划分。

规范

消息必须以八个（8）字节为前缀，总共有64位。每个消息的这8字节/64位段必须包含发送消息中存在的字节数（不包括用于描述大小的8个字节）。长度前缀必须是big-endian。

示例

您可以使用protocol模块来检索前缀，它具有您数据的长度。

以下是一个编码消息的示例。该消息有18字节的数据，最后发送了18 + 8 = 26字节，其中前8字节代表长度。

00 00 00 00 00 00 00 12 74 6f 62 79 20 69 73 20 61 20 67 6f 6f 64 20 64 6f 67