Attribute Macro actix_web::route

source ·
#[route]
Available on crate feature macros only.
Expand description

Creates resource handler, allowing multiple HTTP method guards.

§Syntax

#[route("path", method="HTTP_METHOD"[, attributes])]

§Attributes

  • "path": Raw literal string with path for which to register handler.
  • name = "resource_name": Specifies resource name for the handler. If not set, the function name of handler is used.
  • method = "HTTP_METHOD": Registers HTTP method to provide guard for. Upper-case string, “GET”, “POST” for example.
  • guard = "function_name": Registers function as guard using actix_web::guard::fn_guard.
  • wrap = "Middleware": Registers a resource middleware.

§Notes

Function name can be specified as any expression that is going to be accessible to the generate code, e.g my_guard or my_module::my_guard.

§Examples

#[route("/test", method = "GET", method = "HEAD", method = "CUSTOM")]
async fn example() -> HttpResponse {
    HttpResponse::Ok().finish()
}