Struct ChannelData 

pub struct ChannelData<'a> {
    pub bytes: &'a [u8],
    pub number: u16,
}

The ChannelData Message

The ChannelData message is used to carry application data between the client and the server.
It has the following format:

0                   1                   2                   3
0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|         Channel Number        |            Length             |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                                                               |
/                       Application Data                        /
/                                                               /
|                                                               |
|                               +-------------------------------+
|                               |
+-------------------------------+

                              Figure 5

The Channel Number field specifies the number of the channel on which the data is traveling, and thus, the address of the peer that is sending or is to receive the data.

The Length field specifies the length in bytes of the application data field (i.e., it does not include the size of the ChannelData header). Note that 0 is a valid length.

The Application Data field carries the data the client is trying to send to the peer, or that the peer is sending to the client.

Fields

bytes: &'a [u8]

channnel data bytes.

number: u16

channel number.

Implementations

impl ChannelData<'_>

pub fn message_size(bytes: &[u8], is_tcp: bool) -> Result<usize, StunError>

Test

use bytes::{BufMut, BytesMut};
use std::convert::TryFrom;
use turn_server::stun::*;

let data: [u8; 4] = [0x40, 0x00, 0x00, 0x40];
let mut bytes = BytesMut::with_capacity(1500);

ChannelData {
    number: 16384,
    bytes: &data[..],
}
.encode(&mut bytes);

let size = ChannelData::message_size(&bytes[..], false).unwrap();
assert_eq!(size, 8);

pub fn encode(self, bytes: &mut BytesMut)

Test

use bytes::{BufMut, BytesMut};
use std::convert::TryFrom;
use turn_server::stun::*;

let data: [u8; 4] = [0x40, 0x00, 0x00, 0x40];
let mut bytes = BytesMut::with_capacity(1500);

ChannelData {
    number: 16384,
    bytes: &data[..],
}
.encode(&mut bytes);

let ret = ChannelData::try_from(&bytes[..]).unwrap();
assert_eq!(ret.number, 16384);
assert_eq!(ret.bytes, &data[..]);

Trait Implementations

impl<'a> Debug for ChannelData<'a>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'a> TryFrom<&'a [u8]> for ChannelData<'a>

fn try_from(bytes: &'a [u8]) -> Result<Self, Self::Error>

Test

use bytes::{BufMut, BytesMut};
use std::convert::TryFrom;
use turn_server::stun::*;

let data: [u8; 4] = [0x40, 0x00, 0x00, 0x40];
let mut bytes = BytesMut::with_capacity(1500);

ChannelData {
    number: 16384,
    bytes: &data[..],
}
.encode(&mut bytes);

let ret = ChannelData::try_from(&bytes[..]).unwrap();
assert_eq!(ret.number, 16384);
assert_eq!(ret.bytes, &data[..]);

type Error = StunError

The type returned in the event of a conversion error.