Skip to main content

parse_wire_id

Function parse_wire_id 

Source
pub fn parse_wire_id(raw: &str, property: &str) -> Result<Id, Box<SetError>>
Expand description

Parse a client-supplied id: a /set update key, a destroy element or an Id-typed property value.

RFC 8620 §1.2: an Id “MUST be at least 1 and a maximum of 255 octets in size, and it MUST only contain characters from the ‘URL and Filename Safe’ base64 alphabet”. Id::from does not check this, so every handler routes wire ids through here instead.

§Errors

A boxed invalidProperties SetError naming property ("id" for an update key or destroy element) whose description says why the value is not an Id. The caller records it in notCreated, notUpdated or notDestroyed for that entry.