Struct MessageRef 

pub struct MessageRef<'a> { /* private fields */ }

Implementations

impl<'a> MessageRef<'a>

pub fn method(&self) -> StunMethod

message method.

pub fn token(&self) -> &'a [u8]

message transaction id.

pub fn get<T: Attribute<'a>>(&self) -> Option<T::Item>

get attribute.

get attribute from message attribute list.

Test

use std::convert::TryFrom;
use turn_server::stun::attribute::*;
use turn_server::stun::*;

let buffer = [
    0x00u8, 0x01, 0x00, 0x00, 0x21, 0x12, 0xa4, 0x42, 0x72, 0x6d, 0x49,
    0x42, 0x72, 0x52, 0x64, 0x48, 0x57, 0x62, 0x4b, 0x2b,
];

let mut attributes = Attributes::default();
let message = MessageDecoder::decode(&buffer[..], &mut attributes).unwrap();
assert!(message.get::<UserName>().is_none());

pub fn get_all<T: Attribute<'a>>(&self) -> impl Iterator<Item = T::Item>

Gets all the values of an attribute from a list.

Normally a stun message can have multiple attributes with the same name, and this function will all the values of the current attribute.

Test

use std::convert::TryFrom;
use turn_server::stun::attribute::*;
use turn_server::stun::*;

let buffer = [
    0x00u8, 0x01, 0x00, 0x00, 0x21, 0x12, 0xa4, 0x42, 0x72, 0x6d, 0x49,
    0x42, 0x72, 0x52, 0x64, 0x48, 0x57, 0x62, 0x4b, 0x2b,
];

let mut attributes = Attributes::default();
let message = MessageDecoder::decode(&buffer[..], &mut attributes).unwrap();

assert_eq!(message.get_all::<UserName>().next(), None);

pub fn integrity(&self, digest: &[u8; 16]) -> Result<(), StunError>

check MessageRefIntegrity attribute.

return whether the MessageRefIntegrity attribute contained in the message can pass the check.

Test

use std::convert::TryFrom;
use turn_server::stun::*;

let buffer = [
    0x00u8, 0x03, 0x00, 0x50, 0x21, 0x12, 0xa4, 0x42, 0x64, 0x4f, 0x5a,
    0x78, 0x6a, 0x56, 0x33, 0x62, 0x4b, 0x52, 0x33, 0x31, 0x00, 0x19, 0x00,
    0x04, 0x11, 0x00, 0x00, 0x00, 0x00, 0x06, 0x00, 0x05, 0x70, 0x61, 0x6e,
    0x64, 0x61, 0x00, 0x00, 0x00, 0x00, 0x14, 0x00, 0x09, 0x72, 0x61, 0x73,
    0x70, 0x62, 0x65, 0x72, 0x72, 0x79, 0x00, 0x00, 0x00, 0x00, 0x15, 0x00,
    0x10, 0x31, 0x63, 0x31, 0x33, 0x64, 0x32, 0x62, 0x32, 0x34, 0x35, 0x62,
    0x33, 0x61, 0x37, 0x33, 0x34, 0x00, 0x08, 0x00, 0x14, 0xd6, 0x78, 0x26,
    0x99, 0x0e, 0x15, 0x56, 0x15, 0xe5, 0xf4, 0x24, 0x74, 0xe2, 0x3c, 0x26,
    0xc5, 0xb1, 0x03, 0xb2, 0x6d,
];

let mut attributes = Attributes::default();
let message = MessageDecoder::decode(&buffer[..], &mut attributes).unwrap();
let result = message
    .integrity(&util::long_term_credential_digest(
        "panda",
        "panda",
        "raspberry",
    ))
    .is_ok();
assert!(result);

Trait Implementations

impl<'a> Debug for MessageRef<'a>

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

Formats the value using the given formatter.