protocol 0.1.6

Easy protocol definitions
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 {Packet, Error};
use wire::middleware;

use std::io::prelude::*;
use std::io::Cursor;
use std;

/// A datagram-based packet pipeline.
#[derive(Clone, Debug)]
pub struct Pipeline<P: Packet, M: middleware::Pipeline>
{
    pub middleware: M,

    _a: std::marker::PhantomData<P>,
}

impl<P,M> Pipeline<P,M>
    where P: Packet, M: middleware::Pipeline
{
    pub fn new(middleware: M) -> Self {
        Pipeline {
            middleware: middleware,
            _a: std::marker::PhantomData,
        }
    }

    /// Reads a packet from a buffer which contains a single packet.
    pub fn receive_from(&mut self, buffer: &mut Read)
        -> Result<P, Error> {
        let raw_bytes: Result<Vec<u8>, _> = buffer.bytes().collect();
        let raw_bytes = raw_bytes?;

        let mut bytes = Cursor::new(self.middleware.decode_data(raw_bytes)?);
        P::read(&mut bytes)
    }

    /// Writes a packet into a buffer.
    pub fn send_to(&mut self, buffer: &mut Write, packet: &P)
        -> Result<(), Error> {
        let bytes = self.middleware.encode_data(packet.bytes()?)?;
        buffer.write(&bytes)?;
        Ok(())
    }
}