Struct SaulHandler

pub struct SaulHandler {
    prefix: &'static [&'static str],
}

Available on crate feature saul only.

A handler for SAUL requests, using SAUL_MATCH_SUBTREE to manage its resources.

The path this is registered at must be passed in as the prefix, as link-format responses necessitate knowing one’s own path, and the prefix needs to be stripped off when processing the Uri-Path options.

As the link-format handler is bad, the name must be simple.

Fields

prefix: &'static [&'static str]

Implementations

impl SaulHandler

pub fn new(prefix: &'static [&'static str]) -> Self

Create a SaulHandler

The prefix needs to be passed in in order to produce proper link-format responses which can not be path-relative, and should thus be equal to the prefix assigned in the tree.

fn put_value( &self, entry: RegistryEntry, content_format: ContentFormat, body: &[u8], ) -> Result<(), Error>

Trait Implementations

impl Handler for SaulHandler

type RequestData = SaulRequest

Type constructed in extract_request_data() passed on to build_response().

type ExtractRequestError = Error

Error type for extract_request_data().

type BuildResponseError<M: MinimalWritableMessage> = Error

Error type for writing response data.

fn extract_request_data<M: ReadableMessage>( &mut self, request: &M, ) -> Result<SaulRequest, Error>

Process an incoming request.

fn estimate_length(&mut self, _: &<Self as Handler>::RequestData) -> usize

Estimate an upper bound for the number of bytes in the response

fn build_response<M: MutableWritableMessage>( &mut self, response: &mut M, request: Self::RequestData, ) -> Result<(), Self::BuildResponseError<M>>

Build a response for the request

impl Reporting for SaulHandler

A SaulHandler lists all its SAUL devices in /.well-known/core. This is especially useful when registering at a Resource Directory using simple registration and lookup clients try to discover sensors.

type Record<'res> = Record

type Reporter<'res> = Chain<Once<Record>, Map<Filter<Enumerate<MapWhile<Map<RangeFrom<usize>, fn(_: usize) -> Option<RegistryEntry>>, fn(_: Option<RegistryEntry>) -> Option<RegistryEntry>>>, fn(_: &(usize, RegistryEntry)) -> bool>, fn(_: (usize, RegistryEntry)) -> Record>>

fn report(&self) -> Self::Reporter<'_>

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: 8 bytes