1
0
mirror of https://github.com/actix/actix-extras.git synced 2024-11-24 16:02:59 +01:00

Expand note about actix.

This commit is contained in:
memoryruins 2018-04-05 19:12:23 -04:00
parent 46e6641528
commit 9f45cfe492

View File

@ -3,7 +3,7 @@
Lets create and run our first actix web application. Well create a new Cargo project Lets create and run our first actix web application. Well create a new Cargo project
that depends on actix web and then run the application. that depends on actix web and then run the application.
In the previous section we already installed the required rust version. Now let's create new cargo projects. In the previous section we already installed the required rust version. Now let's create a new cargo project.
## Hello, world! ## Hello, world!
@ -24,7 +24,7 @@ actix = "0.5"
actix-web = "0.4" actix-web = "0.4"
``` ```
In order to implement a web server, first we need to create a request handler. In order to implement a web server, we first need to create a request handler.
A request handler is a function that accepts an `HttpRequest` instance as its only parameter A request handler is a function that accepts an `HttpRequest` instance as its only parameter
and returns a type that can be converted into `HttpResponse`: and returns a type that can be converted into `HttpResponse`:
@ -64,7 +64,7 @@ connections. The server accepts a function that should return an `HttpHandler` i
.run(); .run();
``` ```
That's it. Now, compile and run the program with `cargo run`. That's it! Now, compile and run the program with `cargo run`.
Head over to ``http://localhost:8088/`` to see the results. Head over to ``http://localhost:8088/`` to see the results.
Here is full source of main.rs file: Here is full source of main.rs file:
@ -80,7 +80,7 @@ fn index(req: HttpRequest) -> &'static str {
fn main() { fn main() {
# // In the doctest suite we can't run blocking code - deliberately leak a thread # // In the doctest suite we can't run blocking code - deliberately leak a thread
# // If copying this example in show-all mode make sure you skip the thread spawn # // If copying this example in show-all mode, make sure you skip the thread spawn
# // call. # // call.
# thread::spawn(|| { # thread::spawn(|| {
HttpServer::new( HttpServer::new(
@ -92,7 +92,11 @@ fn main() {
} }
``` ```
Note on the `actix` crate. Actix web framework is built on top of actix actor library. > **Note**: actix web is built upon [actix](https://github.com/actix/actix),
> an [actor model](https://en.wikipedia.org/wiki/Actor_model) framework in Rust.
`actix::System` initializes actor system, `HttpServer` is an actor and must run within a `actix::System` initializes actor system, `HttpServer` is an actor and must run within a
properly configured actix system. For more information please check properly configured actix system.
[actix documentation](https://actix.github.io/actix/actix/)
> For more information, check out the [actix documentation](https://actix.github.io/actix/actix/)
> and [actix guide](https://actix.github.io/actix/guide/).