Struct Link 

pub struct Link {
    pub id: Option<Url>,
    pub kind: OneOrMany<String>,
    pub href: Option<Url>,
    pub rel: Option<OneOrMany<String>>,
    pub media_type: Option<String>,
    pub name: Option<String>,
    pub name_map: Option<BTreeMap<String, String>>,
    pub hreflang: Option<String>,
    pub height: Option<u64>,
    pub width: Option<u64>,
    pub preview: Option<Box<ObjectRef>>,
    pub extra: BTreeMap<String, Value>,
}

An Activity Streams 2.0 Link.

The kind field distinguishes link subtypes such as Mention and Hashtag.

Examples

let link = Link::new(Url::parse("https://example/note/1").unwrap());
let json = serde_json::to_string(&link).unwrap();
assert!(json.contains(r#""type":"Link""#));

Fields

id: Option<Url>

Optional identifier for this link object.

kind: OneOrMany<String>

Type of this link. Defaults to "Link".

href: Option<Url>

The target URL referenced by this link.

rel: Option<OneOrMany<String>>

Link relation types (RFC 5988).

media_type: Option<String>

MIME type of the referenced resource.

name: Option<String>

Plain-text display name for the link.

name_map: Option<BTreeMap<String, String>>

Localized display names keyed by BCP-47 language tag.

hreflang: Option<String>

BCP-47 language tag describing the language of the referenced resource.

height: Option<u64>

Display height for media links.

width: Option<u64>

Display width for media links.

preview: Option<Box<ObjectRef>>

Preview resource associated with the link target.

extra: BTreeMap<String, Value>

Additional or extension properties preserved verbatim across (de)serialization.

Implementations

impl Link

pub fn new(href: Url) -> Self

Creates a new bare Link pointing at href.

pub fn mention(href: Url) -> Self

Creates a Mention link pointing to an actor.

pub fn hashtag(href: Url, name: impl Into<String>) -> Self

Creates a Hashtag link with the given name.

pub fn is_kind(&self, kind: &str) -> bool

Returns true if this link declares the given type name.

Trait Implementations

impl Clone for Link

fn clone(&self) -> Link

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Link

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Link

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl HasId for Link

fn id(&self) -> Option<&Url>

Returns the id of this object, if set.

impl PartialEq for Link

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for Link

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Link