Struct cocaine::Request

pub struct Request { /* fields omitted */ }

A generic Cocaine request.

Encapsulates all required parameters to be able to perform a service call.

Examples

use cocaine::Request;
use cocaine::hpack::{Header, TraceId, SpanId};

let request = Request::new(0, &["event"]).unwrap()
    .add_headers(vec![TraceId(0).into_raw(), SpanId(42).into_raw()]);

assert_eq!(0, request.ty());

Errors

A serialization error is returned when it's failed to serialize the given arguments into a vector. However, while a vector is grown automatically, it may only fail when there is no memory left for allocation.

Methods

impl Request

fn new<S: Serialize>(ty: u64, args: &S) -> Result<Self, Error>

Constructs a new request object using the given message type and arguments, performing an automatic serialization.

fn ty(&self) -> u64

Returns a request type.

fn data(&self) -> &[u8]

Returns a serialized request arguments as a slice.

fn headers(&self) -> &[RawHeader]

Returns a reference to the request headers.

fn add_header<H: Into<RawHeader>>(self, header: H) -> Self

Adds a header to the request.

fn add_headers<H: IntoIterator<Item = RawHeader>>(self, headers: H) -> Self

Adds an iterable headers object to the request.

Trait Implementations

impl Clone for Request

fn clone(&self) -> Request

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Request

fn fmt(&self, fmt: &mut Formatter) -> Result<(), Error>

Formats the value using the given formatter.