Struct SingleHandlerListener

pub struct SingleHandlerListener<'a, H> {
    _phantom: PhantomData<&'a H>,
    resource: coap_resource_t,
    listener: gcoap_listener_t,
}

Available on riot_module_gcoap only.

A combination of the coap_resource_t and gcoap_listener_t structs with only a single resource (Compared to many resources, this allows easier creation in Rust at the expense of larger memory consumption and slower lookups in Gcoap).

A listener l can be hooked into the global Gcoap registry using scope(|x| { x.register(l) }).

Fields

_phantom: PhantomData<&'a H>

resource: coap_resource_t

listener: gcoap_listener_t

Implementations

impl<'a, H> SingleHandlerListener<'a, H>

where H: 'a + Handler,

pub fn new(path: &'a CStr, methods: u32, handler: &'a mut H) -> Self

fn _new( path: &'a CStr, methods: u32, handler: &'a mut H, encoder: Option<unsafe extern "C" fn(_: *const coap_resource_t, _: *mut c_char, _: size_t, _: *mut coap_link_encoder_ctx_t) -> ssize_t>, ) -> Self

pub fn new_catch_all(handler: &'a mut H) -> Self

Create a listener whose single resource catches all requests and processes them through the handler.

This is equivalent to a new single listener at “/” that takes all methods and matches on subtrees.

Note that the taken Handler is a Gcoap Handler (which is there really only in case anyone wants extremely fine-grained control of what gcoap does); if you have a coap_handler_0_2::Handler, you can wrap it in crate::coap_handler::v0_2::GcoapHandler to for adaptation.

unsafe extern "C" fn call_handler( pkt: *mut coap_pkt_t, buf: *mut u8, len: size_t, context: *mut coap_request_ctx_t, ) -> ssize_t

impl<'a, H> SingleHandlerListener<'a, H>

where H: 'a + Handler + WithLinkEncoder,

pub fn new_with_link_encoder( path: &'a CStr, methods: u32, handler: &'a mut H, ) -> Self

Like Self::new(), but utilizing that the handler is also WithLinkEncoder and can thus influence what is reported when the default .well-known/core handler is queried.

Trait Implementations

impl<'a, H> ListenerProvider for SingleHandlerListener<'a, H>

where H: 'a + Handler,

unsafe fn get_listener(&mut self) -> &mut gcoap_listener_t

Provide an exclusive reference to the underlying gcoap listener. The function is marked unsafe as the returned value contains raw pointers that will later be dereferenced, and returning arbitrary pointers would make RegistratinScope::register() pass bad data on to C.

Layout

Note: Most layout information is completely unstable and may even differ between compilations. The only exception is types with certain repr(...) attributes. Please see the Rust Reference's “Type Layout” chapter for details on type layout guarantees.

Size: 40 bytes