应用

应用

actix-web提供了用Rust构建Web服务器和应用程序的各种基础类型。它提供了路由，中间件，请求的预处理，响应的后处理，websocket协议处理，multipart流，等等。

所有actix web服务器都是围绕该App实例构建的。它用于为资源和中间件注册路由。它还存储同一应用程序中所有处理程序之间共享的应用程序状态.

应用程序充当所有路由的命名空间，即特定应用程序的所有路由具有相同的url路径前缀。应用程序前缀总是包含一个前导的“/”斜杠。如果提供的前缀不包含前导斜杠，则会自动插入。前缀应该由路径值组成。

对于具有前缀的应用程序/app，与任何请求路径中有/app，/app/或/app/test匹配; 然而，路径/application不匹配。

fn index(req: HttpRequest) -> impl Responder {
    "Hello world!"
}
let app = App::new()
    .prefix("/app")
    .resource("/index.html", |r| r.method(Method::GET).f(index))
    .finish()

在此示例中，将创建具有/app前缀和index.html资源的应用。该资源可通过/app/index.html路径获得。

有关更多信息，请查看URL Dispatch部分。

但单服务器服务多个应用：

let server = server::new(|| {
    vec![
        App::new()
            .prefix("/app1")
            .resource("/", |r| r.f(|r| HttpResponse::Ok())),
        App::new()
            .prefix("/app2")
            .resource("/", |r| r.f(|r| HttpResponse::Ok())),
        App::new().resource("/", |r| r.f(|r| HttpResponse::Ok())),
    ]
});

所有/app1请求路由到第一个应用程序，/app2到第二个，所有其他到第三个。应用程序根据注册顺序进行匹配。如果具有更通用的前缀的应用程序在不通用的应用程序之前注册，它将有效地阻止较不通用的应用程序匹配。例如，如果App将前缀”/“注册为第一个应用程序，它将匹配所有传入的请求。

状态

同一应用程序内应用程序状态被所有路由和资源共享。当使用http actor时，状态可以HttpRequest::state()作为只读访问，但内部可变性RefCell可用于实现状态可变性。状态也可用于路由匹配谓词和中间件。

我们来编写一个使用共享状态的简单应用程序。我们打算将请求计数存储在状态中：

use actix_web::{http, App, HttpRequest};
use std::cell::Cell;
// This struct represents state
struct AppState {
    counter: Cell<usize>,
}
fn index(req: HttpRequest<AppState>) -> String {
    let count = req.state().counter.get() + 1; // <- get count
    req.state().counter.set(count); // <- store new count in state
    format!("Request number: {}", count) // <- response with count
}

应用程序需要通过初始化状态来初始化。

App::with_state(AppState { counter: Cell::new(0) })
    .resource("/", |r| r.method(http::Method::GET).f(index))
    .finish()

注意：http服务器接受应用程序工厂而不是应用程序实例。Http服务器为每个线程构造一个应用程序实例，因此应用程序状态必须多次构建。如果你想在不同线程之间共享状态，应该使用共享对象，例如Arc。应用程序状态并不需要是Send和Sync，但应用程序的工厂必须是Send+ Sync。

要启动以前的应用程序，请为其创建闭包：

server::new(|| {
    App::with_state(AppState { counter: Cell::new(0) })
        .resource("/", |r| r.method(http::Method::GET).f(index))
}).bind("127.0.0.1:8080")
    .unwrap()
    .run()

结合不同状态的应用程序

将多个应用程序与不同状态组合也是可能的。

server::new需要handler具有单一类型。

使用App::boxed方法可以轻松解决此限制，该方法可将App转换为boxed trait object。

struct State1;
struct State2;
fn main() {
    server::new(|| {
        vec![
            App::with_state(State1)
                .prefix("/app1")
                .resource("/", |r| r.f(|r| HttpResponse::Ok()))
                .boxed(),
            App::with_state(State2)
                .prefix("/app2")
                .resource("/", |r| r.f(|r| HttpResponse::Ok()))
                .boxed(),
                ]
    }).bind("127.0.0.1:8080")
        .unwrap()
        .run()
}

使用应用程序前缀来组合应用程序

该App::prefix()方法允许设置特定的应用程序前缀。此前缀表示将添加到所有资源模式的资源前缀通过资源配置。这可以用来帮助挂载一组路由在不同的地点比所包含的可调用作者的意图仍保持原样资源名称。

例如：

fn show_users(req: HttpRequest) -> HttpResponse {
    unimplemented!()
}
fn main() {
    App::new()
        .prefix("/users")
        .resource("/show", |r| r.f(show_users))
        .finish();
}

在上面的示例中，show_users路由将具有/users/show的有效路由模式，而不是/ show，因为应用程序的前缀参数将预先添加到该模式。只有当URL路径为/users/show，并且HttpRequest.url_for()路由名称show_users调用该函数时，路由才会匹配，它将生成具有相同路径的URL。

应用程序谓词和虚拟主机

您可以将谓词看作一个接受请求对象引用并返回true或false的简单函数。形式上，谓词是实现Predicate trait的任何对象。Actix提供了几个谓词，你可以检查 API文档的functions section部分。

任何这些谓词都可以用于App::filter()方法。提供的谓词之一是Host，它可以根据请求的主机信息用作应用程序的过滤器。

fn main() {
    let server = server::new(|| {
        vec![
            App::new()
                .filter(pred::Host("www.rust-lang.org"))
                .resource("/", |r| r.f(|r| HttpResponse::Ok())),
            App::new()
                .filter(pred::Host("users.rust-lang.org"))
                .resource("/", |r| r.f(|r| HttpResponse::Ok())),
            App::new().resource("/", |r| r.f(|r| HttpResponse::Ok())),
        ]
    });
    server.run();
}