mirror of
https://github.com/actix/actix-website
synced 2024-11-27 18:12:57 +01:00
134 lines
4.1 KiB
HTML
134 lines
4.1 KiB
HTML
{{ partial "header" . }}
|
|
|
|
<div class="jumbotron">
|
|
<div class="actix-jumbotron">
|
|
<img src="/img/logo-large.png" class="align-middle actix-logo" alt="">
|
|
<p class="lead">rust's powerful actor system and most fun web framework</p>
|
|
</div>
|
|
</div>
|
|
|
|
<div class="container actix-home">
|
|
<div class="row">
|
|
<div class="col-md-4">
|
|
<div class="actix-features">
|
|
<h2>
|
|
<i class="fa fa-fw fa-shield" aria-hidden="true"></i>
|
|
Type Safe
|
|
</h2>
|
|
<p>Forget about stringly typed objects, from request to response, everything has types.</p>
|
|
|
|
<h2>
|
|
<i class="fa fa-fw fa-battery-full" aria-hidden="true"></i>
|
|
Feature Rich
|
|
</h2>
|
|
<p>Actix provides a lot of features out of box. WebSockets, HTTP/2, pipelining etc.</p>
|
|
|
|
<h2>
|
|
<i class="fa fa-fw fa-puzzle-piece" aria-hidden="true"></i>
|
|
Extensible
|
|
</h2>
|
|
<p>Easily create your own libraries that any Actix application can use.</p>
|
|
|
|
<h2>
|
|
<i class="fa fa-fw fa-dashboard" aria-hidden="true"></i>
|
|
Blazingly Fast
|
|
</h2>
|
|
<p>Actix is blazingly fast. <a href="https://www.techempower.com/benchmarks/#section=data-r15&hw=ph&test=fortune">Check yourself</a>.</p>
|
|
</div>
|
|
</div>
|
|
<div class="col-md-8">
|
|
<div class="actix-content">
|
|
{{ highlight `extern crate actix_web;
|
|
use actix_web::{server, App, HttpRequest, Responder};
|
|
|
|
fn greet(req: HttpRequest) -> impl Responder {
|
|
let to = req.match_info().get("name").unwrap_or("World");
|
|
format!("Hello {}!", to)
|
|
}
|
|
|
|
fn main() {
|
|
server::new(|| {
|
|
App::new()
|
|
.resource("/", |r| r.f(greet))
|
|
.resource("/{name}", |r| r.f(greet))
|
|
})
|
|
.bind("127.0.0.1:8000")
|
|
.expect("Can not bind to port 8000")
|
|
.run();
|
|
}` "rust" "" }}
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="actix-showcase">
|
|
<div class="col-md-9">
|
|
<div class="actix-feature" id="responders">
|
|
<h2>Flexible Responders</h2>
|
|
<p>
|
|
Handler functions in actix can return a wide range of objects that
|
|
implement the <code>Responder</code> trait. This makes it a breeze
|
|
to return consistent responses from your APIs.
|
|
</p>
|
|
{{ highlight `#[derive(Serialize)]
|
|
struct Measurement {
|
|
temperature: f32,
|
|
}
|
|
|
|
fn hello_world() -> impl Responder {
|
|
"Hello World!"
|
|
}
|
|
|
|
fn current_temperature(_req: HttpRequest) -> impl Responder {
|
|
Json(Measurement { temperature: 42.3 })
|
|
}` "rust" "" }}
|
|
</div>
|
|
<div class="actix-feature" id="extractors">
|
|
<h2>Powerful Extractors</h2>
|
|
<p>
|
|
Actix comes with a powerful extractor system that extracts data
|
|
from the incoming HTTP request and passes it to your view functions.
|
|
Not only does this make for a convenient API but it also means that
|
|
your view functions can be synchronous code and still benefit
|
|
from asynchronous IO handling.
|
|
</p>
|
|
{{ highlight `#[derive(Deserialize)]
|
|
struct Event {
|
|
timestamp: f64,
|
|
kind: String,
|
|
tags: Vec<String>,
|
|
}
|
|
|
|
fn capture_event(evt: Json<Event>) -> impl Responder {
|
|
let id = store_event_in_db(evt.timestamp, evt.kind, evt.tags);
|
|
format!("got event {}", id)
|
|
}` "rust" "" }}
|
|
</div>
|
|
<div class="actix-feature" id="forms">
|
|
<h2>Easy Form Handling</h2>
|
|
<p>
|
|
Handling multipart/urlencoded form data is easy. Just define
|
|
a structure that can be deserialized and actix will handle
|
|
the rest.
|
|
</p>
|
|
{{ highlight `#[derive(Deserialize)]
|
|
struct Register {
|
|
username: String,
|
|
country: String,
|
|
}
|
|
|
|
fn register(data: Form<Register>) -> impl Responder {
|
|
format!("Hello {} from {}!", data.username, data.country)
|
|
}` "rust" "" }}
|
|
</div>
|
|
</div>
|
|
<div class="col-md-3 actix-feature-selectors">
|
|
<ul>
|
|
<li class="actix-feature-selector"><a href="#responders">flexible responders</label>
|
|
<li class="actix-feature-selector"><a href="#extractors">powerful extractors</label>
|
|
<li class="actix-feature-selector"><a href="#forms">easy form handling</label>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
|
|
{{ partial "footer" . }}
|