Struct JmapUri 

pub struct JmapUri { /* private fields */ }

A parsed jmap:<type>:<accountId>:<objectId> URI.

Build one with JmapUri::new or parse one with str::parse; Display renders it back to the wire string. The URI arrives in peer-supplied values, so parsing validates every segment.

use jmap_types::JmapUri;

let uri: JmapUri = "jmap:calendarevent:a1:e42".parse().unwrap();
assert_eq!(uri.data_type(), "calendarevent");
assert_eq!(uri.account_id().as_ref(), "a1");
assert_eq!(uri.object_id().as_ref(), "e42");
assert_eq!(uri.to_string(), "jmap:calendarevent:a1:e42");

Implementations

impl JmapUri

pub fn new( data_type: impl Into<String>, account_id: Id, object_id: Id, ) -> Result<Self, JmapUriError>

Build a URI from its parts.

Errors

Returns JmapUriError when data_type is not lowercase ASCII alphanumeric or either id fails RFC 8620 §1.2 validation (an unvalidated Id::from could otherwise smuggle a : into the rendered URI).

pub fn data_type(&self) -> &str

The lowercased type name, e.g. calendarevent.

pub fn account_id(&self) -> &Id

The account the object lives on.

pub fn object_id(&self) -> &Id

The referenced object’s id.

Trait Implementations

impl Clone for JmapUri

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for JmapUri

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for JmapUri

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Eq for JmapUri

impl FromStr for JmapUri

fn from_str(s: &str) -> Result<Self, Self::Err>

Parse a jmap: URI. The scheme matches case-insensitively (RFC 3986 §3.1); every other segment is case-sensitive.

type Err = JmapUriError

The associated error which can be returned from parsing.

impl Hash for JmapUri

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for JmapUri

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for JmapUri