2017-12-02 07:06:15 +00:00
|
|
|
# Application
|
2017-11-28 20:44:59 +00:00
|
|
|
|
|
|
|
Actix web provides some primitives to build web servers and applications with Rust.
|
|
|
|
It provides routing, middlewares, pre-processing of requests, and post-processing of responses,
|
|
|
|
websocket protcol handling, multipart streams, etc.
|
|
|
|
|
|
|
|
All actix web server is built around `Application` instance.
|
|
|
|
It is used for registering handlers for routes and resources, middlewares.
|
|
|
|
Also it stores applicationspecific state that is shared accross all handlers
|
|
|
|
within same application.
|
|
|
|
|
|
|
|
Application acts as namespace for all routes, i.e all routes for specific application
|
|
|
|
has same url path prefix:
|
|
|
|
|
|
|
|
```rust,ignore
|
|
|
|
let app = Application::default("/prefix")
|
|
|
|
.resource("/index.html", |r| r.handler(Method::GET, index)
|
|
|
|
.finish()
|
|
|
|
```
|
|
|
|
|
|
|
|
In this example application with `/prefix` prefix and `index.html` resource
|
|
|
|
get created. This resource is available as on `/prefix/index.html` url.
|
2017-12-02 07:32:15 +00:00
|
|
|
|
|
|
|
Multiple applications could be served with one server:
|
|
|
|
|
|
|
|
```rust
|
|
|
|
extern crate actix_web;
|
|
|
|
extern crate tokio_core;
|
|
|
|
use std::net::SocketAddr;
|
|
|
|
use actix_web::*;
|
|
|
|
use tokio_core::net::TcpStream;
|
|
|
|
|
|
|
|
fn main() {
|
|
|
|
HttpServer::<TcpStream, SocketAddr, _>::new(vec![
|
|
|
|
Application::default("/app1")
|
|
|
|
.resource("/", |r| r.get(|r| httpcodes::HTTPOk))
|
|
|
|
.finish(),
|
|
|
|
Application::default("/app2")
|
|
|
|
.resource("/", |r| r.get(|r| httpcodes::HTTPOk))
|
|
|
|
.finish(),
|
|
|
|
Application::default("/")
|
|
|
|
.resource("/", |r| r.get(|r| httpcodes::HTTPOk))
|
|
|
|
.finish(),
|
|
|
|
]);
|
|
|
|
}
|
|
|
|
```
|
|
|
|
|
|
|
|
All `/app1` requests route to first application, `/app2` to second and then all other to third.
|