Struct LinkBuilder

Source

pub struct LinkBuilder { /* private fields */ }

Expand description

A builder for a WebFinger link.

This is used to construct a Link with the desired fields.

Implementations§

Source §

impl LinkBuilder

Source

pub fn new<R: Into<Rel>>(rel: R) -> Self

Create a new link builder with the given relation type.

Source

pub fn type<S: Into<String>>(self, type: S) -> Self

Set the media type of the link.

Defined in RFC 7033 Section 4.4.4.2

Source

pub fn href<S: Into<String>>(self, href: S) -> Self

Set the target URI of the link.

Defined in RFC 7033 Section 4.4.4.3

Examples found in repository ?

examples/actix.rs (line 56)

47async fn webfinger(request: WebFingerRequest) -> actix_web::Result<WebFingerResponse> {
48    info!("fetching webfinger resource: {:?}", request);
49    let subject = request.resource.to_string();
50    if subject != SUBJECT {
51        let message = format!("{subject} does not exist");
52        return Err(actix_web::error::ErrorNotFound(message))?;
53    }
54    let rel = Rel::new("http://webfinger.net/rel/profile-page");
55    let response = if request.rels.is_empty() || request.rels.contains(&rel) {
56        let link = Link::builder(rel).href(format!("https://example.com/profile/{subject}"));
57        WebFingerResponse::builder(subject).link(link).build()
58    } else {
59        WebFingerResponse::builder(subject).build()
60    };
61    Ok(response)
62}

More examples

Hide additional examples

examples/axum.rs (line 56)

47async fn webfinger(request: WebFingerRequest) -> axum::response::Result<WebFingerResponse> {
48    info!("fetching webfinger resource: {:?}", request);
49    let subject = request.resource.to_string();
50    if subject != SUBJECT {
51        let message = format!("{subject} does not exist");
52        return Err((StatusCode::NOT_FOUND, message).into());
53    }
54    let rel = Rel::new("http://webfinger.net/rel/profile-page");
55    let response = if request.rels.is_empty() || request.rels.contains(&rel) {
56        let link = Link::builder(rel).href(format!("https://example.com/profile/{subject}"));
57        WebFingerResponse::builder(subject).link(link).build()
58    } else {
59        WebFingerResponse::builder(subject).build()
60    };
61    Ok(response)
62}

Source

pub fn title<L: Into<String>, V: Into<String>>( self, language: L, value: V, ) -> Self

Add a single title for the the link.

Defined in RFC 7033 Section 4.4.4.4

Source

pub fn titles(self, titles: Vec<Title>) -> Self

Set the titles of the link.

Defined in RFC 7033 Section 4.4.4.4

Source

pub fn property<K: Into<String>, V: Into<Option<String>>>( self, key: K, value: V, ) -> Self

Add a single property to the link.

Defined in RFC 7033 Section 4.4.4.5

Source

pub fn properties(self, properties: HashMap<String, Option<String>>) -> Self

Set the properties of the link.

Defined in RFC 7033 Section 4.4.4.5

Source

pub fn build(self) -> Link

Build the link.

This can be omitted if the link is being converted to a Link directly from the builder as LinkBuilder also implements From<LinkBuilder> for Link.