Trait coap_handler::Handler

pub trait Handler {
    type RequestData;

    fn extract_request_data(
        &mut self,
        request: &impl ReadableMessage
    ) -> Self::RequestData;
    fn estimate_length(&mut self, request: &Self::RequestData) -> usize;
    fn build_response(
        &mut self,
        response: &mut impl MutableWritableMessage,
        request: Self::RequestData
    );
}

A CoAP request handler. This gets called by a CoAP server implementation that the handler is assigned to; the server has the handler digest the request’s data into a RequestData structure, possibly calls estimate_length before allocating a response message, and then asks the handler to populate the allocated response message with data persisted in the RequestData structure.

Required Associated Types

type RequestData

Required Methods

fn extract_request_data(
    &mut self,
    request: &impl ReadableMessage
) -> Self::RequestData

fn estimate_length(&mut self, request: &Self::RequestData) -> usize

fn build_response(
    &mut self,
    response: &mut impl MutableWritableMessage,
    request: Self::RequestData
)

Implementations on Foreign Types

impl<H> Handler for Option<H>where
    H: Handler,

An easy way to have resources that may or may not be there in a tree, considering that Handler is not object safe and thus, if let Some(x) { all = all.at(...) won’t work.

This returns 4.04 Not Found if the inner handler is absent, and otherwise forwards request and response building.

type RequestData = Option<<H as Handler>::RequestData>

fn extract_request_data(
    &mut self,
    request: &impl ReadableMessage
) -> Self::RequestData

fn estimate_length(&mut self, request: &Self::RequestData) -> usize

fn build_response(
    &mut self,
    response: &mut impl MutableWritableMessage,
    request: Self::RequestData
)

Implementors

impl Handler for NeverFound

type RequestData = ()

impl Handler for TypedStaticResponse

type RequestData = u8

impl<'a, RD1, H1, RD2, H2> Handler for ForkingHandler<'a, H1, H2>where
    H1: Handler<RequestData = RD1>,
    H2: Handler<RequestData = RD2>,

type RequestData = ForkingRequestData<RD1, RD2>

impl<H> Handler for SimpleCBORWrapper<H>where
    H: SimpleCBORHandler,
    H::Get: Serialize,
    H::Post: for<'de> Deserialize<'de>,
    H::Put: for<'de> Deserialize<'de>,

type RequestData = SimpleCBORRequestData

impl<T> Handler for SimpleRendered<T>where
    T: SimpleRenderable,

type RequestData = SimpleRenderableData