hickory_proto/xfer/
serial_message.rs

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
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
// Copyright 2015-2018 Benjamin Fry <benjaminfry@me.com>
//
// Licensed under the Apache License, Version 2.0, <LICENSE-APACHE or
// https://apache.org/licenses/LICENSE-2.0> or the MIT license <LICENSE-MIT or
// https://opensource.org/licenses/MIT>, at your option. This file may not be
// copied, modified, or distributed except according to those terms.

use std::net::SocketAddr;

use crate::error::ProtoResult;
use crate::op::Message;

/// A DNS message in serialized form, with either the target address or source address
pub struct SerialMessage {
    // TODO: change to Bytes? this would be more compatible with some underlying libraries
    message: Vec<u8>,
    addr: SocketAddr,
}

impl SerialMessage {
    /// Construct a new SerialMessage and the source or destination address
    pub fn new(message: Vec<u8>, addr: SocketAddr) -> Self {
        Self { message, addr }
    }

    /// Get a reference to the bytes
    pub fn bytes(&self) -> &[u8] {
        &self.message
    }

    /// Get the source or destination address (context dependent)
    pub fn addr(&self) -> SocketAddr {
        self.addr
    }

    /// Unwrap the Bytes and address
    pub fn into_parts(self) -> (Vec<u8>, SocketAddr) {
        self.into()
    }

    /// Build a `SerialMessage` from some bytes and an address
    pub fn from_parts(message: Vec<u8>, addr: SocketAddr) -> Self {
        (message, addr).into()
    }

    /// Deserializes the inner data into a Message
    pub fn to_message(&self) -> ProtoResult<Message> {
        Message::from_vec(&self.message)
    }
}

impl From<(Vec<u8>, SocketAddr)> for SerialMessage {
    fn from((message, addr): (Vec<u8>, SocketAddr)) -> Self {
        Self { message, addr }
    }
}

impl From<SerialMessage> for (Vec<u8>, SocketAddr) {
    fn from(msg: SerialMessage) -> Self {
        let SerialMessage { message, addr } = msg;
        (message, addr)
    }
}