brec 0.4.0

A flexible binary format for storing and streaming structured data as packets with CRC protection and recoverability from corruption. Built for extensibility and robustness.
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

use crate::java_feat::{
    JavaObject, from_java_object,
    jni::{Env, objects::JObject},
    to_java_object,
};
use crate::*;

impl<B: BlockDef + JavaObject, P: PayloadDef<Inner>, Inner: PayloadInnerDef + JavaObject>
    PacketDef<B, P, Inner>
{
    /// Reads packet bytes and converts to Java object.
    pub fn decode_java<'local>(
        env: &mut Env<'local>,
        bytes: &[u8],
        ctx: &mut <Inner as PayloadSchema>::Context<'_>,
    ) -> Result<JObject<'local>, Error> {
        let mut cursor = std::io::Cursor::new(bytes);
        let packet = <Self as ReadPacketFrom>::read(&mut cursor, ctx)?;
        Ok(to_java_object(
            env,
            &packet.blocks,
            packet.payload.as_ref(),
        )?)
    }

    /// Parses Java object packet and encodes into packet bytes.
    pub fn encode_java<'local>(
        env: &mut Env<'local>,
        value: JObject<'local>,
        out: &mut Vec<u8>,
        ctx: &mut <Inner as PayloadSchema>::Context<'_>,
    ) -> Result<(), Error> {
        let (blocks, payload) = from_java_object::<B, Inner>(env, value)?;
        let mut packet = Self::new(blocks, payload);
        packet.write_all(out, ctx)?;
        Ok(())
    }
}