Struct onc_rpc::RpcMessage

pub struct RpcMessage<T, P>
where
    T: AsRef<[u8]>,
    P: AsRef<[u8]>,
{ /* private fields */ }

An Open Network Computing RPC message, generic over a source of bytes (T) and a payload buffer (P).

Implementations

impl<'a> RpcMessage<&'a [u8], &'a [u8]>

pub fn from_bytes(buf: &'a [u8]) -> Result<Self, Error>

👎Deprecated since 0.3.0: prefer the TryFrom impl instead

Deserialises a new RpcMessage from buf.

Buf must contain exactly 1 message - if buf contains an incomplete message, or buf contains trailing bytes after the message Error::IncompleteMessage is returned.

impl<T, P> RpcMessage<T, P>

where T: AsRef<[u8]>, P: AsRef<[u8]>,

pub fn new(xid: u32, message_type: MessageType<T, P>) -> Self

Construct a new RpcMessage with the specified transaction ID and message body.

pub fn serialise_into<W: Write>(&self, buf: W) -> Result<(), Error>

Write this RpcMessage into buf, advancing the cursor to the end of the serialised message. buf must have capacity for at least RpcMessage::serialised_len() bytes from the current cursor position.

This method allows the caller to specify the underlying buffer used to hold the serialised message to enable reuse and pooling.

pub fn serialise(&self) -> Result<Vec<u8>, Error>

Serialise this RpcMessage into a new Vec.

The returned vec will be sized exactly to contain this message. Calling this method is the equivalent of:

let mut buf = Vec::with_capacity(msg.serialised_len() as usize);
let mut c = Cursor::new(buf);
msg.serialise_into(&mut c);

pub fn serialised_len(&self) -> u32

Returns the on-wire length of this message once serialised, including the message header.

pub fn xid(&self) -> u32

The transaction ID for this request.

pub fn message(&self) -> &MessageType<T, P>

The MessageType contained in this request.

pub fn call_body(&self) -> Option<&CallBody<T, P>>

Returns the CallBody in this request, or None if this message is not a RPC call request.

pub fn reply_body(&self) -> Option<&ReplyBody<T, P>>

Returns the ReplyBody in this request, or None if this message is not a RPC response.

Trait Implementations

impl<T, P> Debug for RpcMessage<T, P>

where T: AsRef<[u8]> + Debug, P: AsRef<[u8]> + Debug,

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

Formats the value using the given formatter.

impl<T, P> PartialEq for RpcMessage<T, P>

where T: AsRef<[u8]> + PartialEq, P: AsRef<[u8]> + PartialEq,

fn eq(&self, other: &RpcMessage<T, P>) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<'a> TryFrom<&'a [u8]> for RpcMessage<&'a [u8], &'a [u8]>

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

Deserialises a new RpcMessage from buf.

Buf must contain exactly 1 message - if buf contains an incomplete message, or buf contains trailing bytes after the message Error::IncompleteMessage is returned.

type Error = Error

The type returned in the event of a conversion error.

impl TryFrom<Bytes> for RpcMessage<Bytes, Bytes>

type Error = Error

The type returned in the event of a conversion error.

fn try_from(v: Bytes) -> Result<Self, Self::Error>

Performs the conversion.

impl<T, P> StructuralPartialEq for RpcMessage<T, P>

where T: AsRef<[u8]>, P: AsRef<[u8]>,