Struct oxide_auth::endpoint::Template

pub struct Template<'a> { /* fields omitted */ }

Modifiable reason for creating a response to the client.

Not all responses indicate failure. A redirect will also occur in the a regular of providing an access token to the third party client. When an error is present (see several methods) it is mostly possible to customize it. This hook provides advanced endpoints with the opportunity to set additional parameters and informational messages before they are encoded.

See the provided methods for more information and examples.

Methods

impl<'a> Template<'a>

pub fn status(&self) -> ResponseStatus

The corresponding status code.

pub fn authorization_error(&mut self) -> Option<&mut AuthorizationError>

Supplementary information about an error in the authorization code flow.

The referenced object can be inspected and manipulated to provided additional information that is specific to this server or endpoint. Such information could be an error page with explanatory information or a customized message.

fn explain(mut template: Template) {
    if let Some(error) = template.authorization_error() {
        eprintln!("[authorization] An error occurred: {:?}", error.kind());
        error.explain("This server is still in its infancy. Sorry.");
        error.explain_uri("/authorization_error.html".parse().unwrap());
    }
}

pub fn access_token_error(&mut self) -> Option<&mut AccessTokenError>

Supplementary information about an error in the access token flow.

The referenced object can be inspected and manipulated to provided additional information that is specific to this server or endpoint. Such information could be an error page with explanatory information or a customized message.

fn explain(mut template: Template) {
    if let Some(error) = template.access_token_error() {
        eprintln!("[access_code] An error occurred: {:?}", error.kind());
        error.explain("This server is still in its infancy. Sorry.");
        error.explain_uri("/access_token_error.html".parse().unwrap());
    }
}

Trait Implementations

impl<'a> Debug for Template<'a>

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

Formats the value using the given formatter.