resource文件夹config resource文件夹的作用

转载

hochie 2024-07-31 16:02:56

文章标签 resource文件夹config 中resource文件夹的作用 App 路由配置应用程序 文章分类 架构后端开发

URL 调度提供了简便的方式以进行简单的模式匹配，将 URL 映射到 handler 代码。如果请求相关联的路径信息与一个模式匹配，则调用特定的 handler 对象。

请求 handler 是一个函数，它接受可以从请求中提取的零个或多个参数(即 impl FromRequest)，并返回可以转换为 HttpResponse(即 impl Responder)的类型。

资源配置

资源配置的作用是向应用程序添加新的资源。资源有用于 URL 生成的标识符作为名称，该名称允许开发人员向现有资源添加路由。资源也具有模式，用于匹配 URL 的部分路径(PATH)，即 scheme 和 port 之后的路径部分(如 URL http://localhost:8080/foo/bar?q=value 中的 /foo/bar 部分)。但不匹配路径中的查询(QUERY)，即 ? 后面的部分(如 http://localhost:8080/foo/bar?q=value 中的 q=value)。

App::route() 方法提供了简便的方式以便于注册路由。此方法用于向应用程序的路由表添加路由，并且接受路径模式、HTTP 方法，以及 handler 函数。对于相同的资源路径，可以多次调用 route() 方法，在这种情况下，多个路由注册为同一个资源路径。

use actix_web::{web, App, HttpResponse, HttpServer};async fn index() -> HttpResponse {    HttpResponse::Ok().body("Hello")}#[actix_web::main]async fn main() -> std::io::Result {    HttpServer::new(|| {        App::new()            .route("/", web::get().to(index))            .route("/user", web::post().to(index))    })    .bind("127.0.0.1:8080")?    .run()    .await}

尽管 App::route() 方法提供了简便的方式以便于注册路由，但要访问完整的资源配置，必须使用不同的方法。App::service() 方法将单个资源添加到应用程序的路由表中，该方法接受路径模式、卫语句(guards)，以及一个或多个路由。

use actix_web::{guard, web, App, HttpResponse};fn index() -> HttpResponse {    HttpResponse::Ok().body("Hello")}pub fn main() {    App::new()        .service(web::resource("/prefix").to(index))        .service(            web::resource("/user/{name}")                .name("user_detail")                .guard(guard::Header("content-type", "application/json"))                .route(web::get().to(|| HttpResponse::Ok()))                .route(web::put().to(|| HttpResponse::Ok())),        );}

如果资源不包含任何路由，或没有任何匹配的路由，将返回 NOT FOUND HTTP 响应。

路由配置

资源包含一系列路由。每个路由依次有一组卫语句(guards) 和一个 handler。可以使用 Resource::route() 方法创建新路由，该方法返回对新路由 Route 实例的引用。默认情况下，路由不包含任何卫语句，因此可以匹配所有请求，其默认 handler 为 HttpNotFound。

基于资源注册与路由注册期间定义的路由标准，应用程序的路由传入请求。应用程序根据在资源注册和路由注册期间定义的路由条件路由传入的请求。根据 Resource::route() 方法注册路由的顺序，资源匹配它包含的所有路由。

路由 Route 可含有任意多的卫语句(guards)，但只能有一个 handler。

App::new().service(    web::resource("/path").route(        web::route()            .guard(guard::Get())            .guard(guard::Header("content-type", "text/plain"))            .to(|| HttpResponse::Ok()),    ),)

在这个示例中，如果 GET 请求包含 Content-Type 标头，则返回 HttpResponse::Ok()。此标头的值为 text/plain，路径为 /path。

如果资源无法匹配任何路由，则返回 “NOT FOUND” 响应。

ResourceHandler::route() 返回路由(Route)对象。可以使用类似于 builder 的模式来配置路由。可用配置方法如下：