Struct azure_functions::bindings::HttpRequest

pub struct HttpRequest(_);

Represents a HTTP trigger binding.

Examples

A function that responds with a friendly greeting:

use azure_functions::func;
use azure_functions::bindings::{HttpRequest, HttpResponse};

#[func]
#[binding(name = "request", auth_level = "anonymous")]
pub fn greet(request: &HttpRequest) -> HttpResponse {
    format!(
        "Hello, {}!",
        request.query_params().get("name").map_or("stranger", |x| x)
    ).into()
}

Methods

impl HttpRequest

pub fn method(&self) -> &str

Gets the HTTP method (e.g. "GET") for the request.

pub fn url(&self) -> &str

Gets the URL of the request.

pub fn headers(&self) -> &HashMap<String, String>

Gets the headers of the request.

The header keys are lower-cased.

pub fn route_params(&self) -> &HashMap<String, String>

Gets the route parameters of the request.

Route parameters are specified through the route argument of a HttpRequest binding attribute.

See Route Containts for syntax.

Examples

use azure_functions::func;
use azure_functions::bindings::{HttpRequest, HttpResponse};

#[func]
#[binding(name = "request", route = "users/{id:int}")]
pub fn users(request: &HttpRequest) -> HttpResponse {
    format!(
        "User ID requested: {}",
        request.route_params().get("id").unwrap()
    ).into()
}

Invoking the above function as https://<app-name>.azurewebsites.net/api/users/1234 would result in a response of User ID requested: 1234.

pub fn query_params(&self) -> &HashMap<String, String>

Gets the query parameters of the request.

The query parameter keys are case-sensative.

Examples

use azure_functions::func;
use azure_functions::bindings::{HttpRequest, HttpResponse};

#[func]
pub fn users(request: &HttpRequest) -> HttpResponse {
    format!(
        "The 'name' query parameter is: {}",
        request.query_params().get("name").map_or("undefined", |x| x)
    ).into()
}

pub fn body(&self) -> Body

Gets the body of the request.

Trait Implementations

impl From<TypedData> for HttpRequest

fn from(data: TypedData) -> Self

Performs the conversion.

impl Debug for HttpRequest

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

Formats the value using the given formatter.