2018-05-22 23:15:08 +02:00
|
|
|
|
{{ partial "header" . }}
|
|
|
|
|
|
2018-06-23 05:36:37 +02:00
|
|
|
|
<div id="act-home">
|
|
|
|
|
<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>
|
2018-05-22 23:15:08 +02:00
|
|
|
|
</div>
|
|
|
|
|
|
2018-06-23 05:36:37 +02:00
|
|
|
|
<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>
|
2018-05-22 23:15:08 +02:00
|
|
|
|
|
2018-06-23 05:36:37 +02:00
|
|
|
|
<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>
|
2018-05-22 23:15:08 +02:00
|
|
|
|
|
2018-06-23 05:36:37 +02:00
|
|
|
|
<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>
|
2018-05-22 23:15:08 +02:00
|
|
|
|
|
2018-06-23 05:36:37 +02:00
|
|
|
|
<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-r16&hw=ph&test=plaintext">Check yourself</a>.</p>
|
|
|
|
|
</div>
|
2018-05-22 23:15:08 +02:00
|
|
|
|
</div>
|
2018-06-23 05:36:37 +02:00
|
|
|
|
<div class="col-md-8">
|
|
|
|
|
<div class="actix-content">
|
|
|
|
|
{{ highlight `extern crate actix_web;
|
|
|
|
|
use actix_web::{server, App, HttpRequest, Responder};
|
2018-05-22 23:15:08 +02:00
|
|
|
|
|
2018-06-23 05:36:37 +02:00
|
|
|
|
fn greet(req: HttpRequest) -> impl Responder {
|
|
|
|
|
let to = req.match_info().get("name").unwrap_or("World");
|
|
|
|
|
format!("Hello {}!", to)
|
|
|
|
|
}
|
2018-05-22 23:15:08 +02:00
|
|
|
|
|
2018-06-23 05:36:37 +02:00
|
|
|
|
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>
|
2018-05-22 23:15:08 +02:00
|
|
|
|
</div>
|
|
|
|
|
</div>
|
2018-06-23 05:36:37 +02:00
|
|
|
|
<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,
|
|
|
|
|
}
|
2018-05-23 20:15:15 +02:00
|
|
|
|
|
2018-06-23 05:36:37 +02:00
|
|
|
|
fn hello_world() -> impl Responder {
|
|
|
|
|
"Hello World!"
|
|
|
|
|
}
|
2018-05-23 20:15:15 +02:00
|
|
|
|
|
2018-06-23 05:36:37 +02:00
|
|
|
|
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>,
|
|
|
|
|
}
|
2018-05-23 20:15:15 +02:00
|
|
|
|
|
2018-06-23 05:36:37 +02:00
|
|
|
|
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,
|
|
|
|
|
}
|
2018-05-23 20:15:15 +02:00
|
|
|
|
|
2018-06-23 05:36:37 +02:00
|
|
|
|
fn register(data: Form<Register>) -> impl Responder {
|
|
|
|
|
format!("Hello {} from {}!", data.username, data.country)
|
|
|
|
|
}` "rust" "" }}
|
|
|
|
|
</div>
|
|
|
|
|
<div class="actix-feature" id="routing">
|
|
|
|
|
<h2>Request Routing</h2>
|
|
|
|
|
<p>
|
|
|
|
|
An actix app comes with a URL routing system that lets you match on
|
|
|
|
|
URLs and invoke individual handlers. For extra flexibility, scopes
|
|
|
|
|
can be used.
|
|
|
|
|
</p>
|
|
|
|
|
{{ highlight `fn index(req: HttpRequest) -> impl Responder {
|
|
|
|
|
"Hello from the index page"
|
|
|
|
|
}
|
2018-05-26 14:27:55 +02:00
|
|
|
|
|
2018-06-23 05:36:37 +02:00
|
|
|
|
fn hello(path: Path<String>) -> impl Responder {
|
|
|
|
|
format!("Hello {}!", *path)
|
|
|
|
|
}
|
2018-05-26 14:27:55 +02:00
|
|
|
|
|
2018-06-23 05:36:37 +02:00
|
|
|
|
fn main() {
|
|
|
|
|
App::new()
|
|
|
|
|
.resource("/", |r| r.method(Method::Get).with(index))
|
|
|
|
|
.resource("/hello/{name}", |r| r.method(Method::Get).with(hello))
|
|
|
|
|
.finish();
|
|
|
|
|
}` "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>
|
|
|
|
|
<li class="actix-feature-selector"><a href="#routing">request routing</label>
|
|
|
|
|
</ul>
|
2018-05-23 20:15:15 +02:00
|
|
|
|
</div>
|
|
|
|
|
</div>
|
|
|
|
|
</div>
|
2018-05-22 23:15:08 +02:00
|
|
|
|
</div>
|
|
|
|
|
|
2018-06-23 05:58:06 +02:00
|
|
|
|
<div id="act-home-cn">
|
|
|
|
|
<div class="jumbotron">
|
|
|
|
|
<div class="actix-jumbotron">
|
|
|
|
|
<img src="/img/logo-large.png" class="align-middle actix-logo" alt="">
|
2018-06-23 21:14:26 +02:00
|
|
|
|
<p class="lead">Rust强大的actor系统和有趣的web框架</p>
|
2018-06-23 05:58:06 +02:00
|
|
|
|
</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>
|
|
|
|
|
类型安全
|
|
|
|
|
</h2>
|
|
|
|
|
<p>忘记关于字符串类型的对象,从请求到响应,一切都有类型,异步。</p>
|
|
|
|
|
|
|
|
|
|
<h2>
|
|
|
|
|
<i class="fa fa-fw fa-battery-full" aria-hidden="true"></i>
|
|
|
|
|
特性丰富
|
|
|
|
|
</h2>
|
|
|
|
|
<p>Actix提供了丰富的特性开箱即用。WebSockets,HTTP/2,流,管道,SSL,异步HTTTP客户端等一应俱全.</p>
|
|
|
|
|
|
|
|
|
|
<h2>
|
|
|
|
|
<i class="fa fa-fw fa-puzzle-piece" aria-hidden="true"></i>
|
|
|
|
|
扩展性强
|
|
|
|
|
</h2>
|
|
|
|
|
<p>轻松创建任何基于Actix应用的自己的特色库。</p>
|
|
|
|
|
|
|
|
|
|
<h2>
|
|
|
|
|
<i class="fa fa-fw fa-dashboard" aria-hidden="true"></i>
|
|
|
|
|
速度极快
|
|
|
|
|
</h2>
|
|
|
|
|
<p>Actix 具有顶级的速度. <a href="https://www.techempower.com/benchmarks/#section=data-r16&hw=ph&test=plaintext">Check yourself</a>.</p>
|
|
|
|
|
</div>
|
|
|
|
|
</div>
|
|
|
|
|
<div class="col-md-8">
|
|
|
|
|
<div class="actix-content">
|
|
|
|
|
{{ highlight `extern crate actix_web;
|
2018-06-23 09:54:08 +02:00
|
|
|
|
use actix_web::{http::Method, server, App, Path, Responder};
|
2018-06-23 05:58:06 +02:00
|
|
|
|
|
2018-06-23 09:54:08 +02:00
|
|
|
|
fn index(info: Path<(u32, String)>) -> impl Responder {
|
|
|
|
|
format!("Hello {}! id:{}", info.1, info.0)
|
|
|
|
|
}
|
2018-06-23 05:58:06 +02:00
|
|
|
|
|
2018-06-23 09:54:08 +02:00
|
|
|
|
fn main() {
|
|
|
|
|
server::new(
|
|
|
|
|
|| App::new()
|
|
|
|
|
.route("/{id}/{name}/index.html", Method::GET, index))
|
|
|
|
|
.bind("127.0.0.1:8080").unwrap()
|
|
|
|
|
.run();
|
|
|
|
|
}` "rust" "" }}
|
2018-06-23 05:58:06 +02:00
|
|
|
|
</div>
|
|
|
|
|
</div>
|
|
|
|
|
</div>
|
2018-06-23 09:54:08 +02:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<div id="act-cn-tabs">
|
2018-06-23 16:31:17 +02:00
|
|
|
|
|
2018-06-23 09:54:08 +02:00
|
|
|
|
<div id="content">
|
|
|
|
|
<div id="con_one_1">
|
|
|
|
|
<h2>灵活的请求响应</h2>
|
|
|
|
|
<p>
|
|
|
|
|
Actix中的Handler函数可以返回实现该<code>Respondert</code> rait的各种对象。这使得从API返回一致的响应变得轻而易举。
|
|
|
|
|
</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 id="con_one_2" style="display:none;">
|
|
|
|
|
<h2>强大的Extractors</h2>
|
|
|
|
|
<p>
|
|
|
|
|
Actix提供了一个强大的提取器系统,可以从传入的HTTP请求中提取数据并将其传递给您的视图函数。这不仅可以创建方便的API,
|
|
|
|
|
而且还意味着您的视图函数可以是同步代码,并且仍然可以受益于异步IO处理。
|
|
|
|
|
</p>
|
|
|
|
|
{{ highlight `#[derive(Deserialize)]
|
2018-06-23 05:58:06 +02:00
|
|
|
|
struct Event {
|
2018-06-23 09:54:08 +02:00
|
|
|
|
timestamp: f64,
|
|
|
|
|
kind: String,
|
|
|
|
|
tags: Vec<String>,
|
2018-06-23 05:58:06 +02:00
|
|
|
|
}
|
2018-06-23 09:54:08 +02:00
|
|
|
|
|
2018-06-23 05:58:06 +02:00
|
|
|
|
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" "" }}
|
2018-06-23 09:54:08 +02:00
|
|
|
|
</div>
|
|
|
|
|
<div id="con_one_3" style="display:none;">
|
|
|
|
|
<h2>轻松处理表单</h2>
|
2018-06-23 05:58:06 +02:00
|
|
|
|
<p>
|
|
|
|
|
处理multipart/ urlencoded表单数据很容易。只需定义一个可以反序列化的结构,actix就可以处理剩下的部分。
|
|
|
|
|
</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" "" }}
|
2018-06-23 09:54:08 +02:00
|
|
|
|
</div>
|
|
|
|
|
<div id="con_one_4" style="display:none;">
|
|
|
|
|
<h2>请求路由</h2>
|
|
|
|
|
<p>
|
|
|
|
|
一个actix应用程序带有一个URL路由系统,可以让你在URL上匹配并调用单个处理程序。为了获得额外的灵活性,可以使用域。
|
|
|
|
|
</p>
|
|
|
|
|
{{ highlight `fn index(req: HttpRequest) -> impl Responder {
|
|
|
|
|
"Hello from the index page"
|
2018-06-23 05:58:06 +02:00
|
|
|
|
}
|
2018-06-23 09:54:08 +02:00
|
|
|
|
|
2018-06-23 05:58:06 +02:00
|
|
|
|
fn hello(path: Path<String>) -> impl Responder {
|
2018-06-23 09:54:08 +02:00
|
|
|
|
format!("Hello {}!", *path)
|
2018-06-23 05:58:06 +02:00
|
|
|
|
}
|
2018-06-23 09:54:08 +02:00
|
|
|
|
|
2018-06-23 05:58:06 +02:00
|
|
|
|
fn main() {
|
2018-06-23 09:54:08 +02:00
|
|
|
|
App::new()
|
|
|
|
|
.resource("/", |r| r.method(Method::Get).with(index))
|
|
|
|
|
.resource("/hello/{name}", |r| r.method(Method::Get).with(hello))
|
|
|
|
|
.finish();
|
2018-06-23 05:58:06 +02:00
|
|
|
|
}` "rust" "" }}
|
2018-06-23 09:54:08 +02:00
|
|
|
|
</div>
|
|
|
|
|
</div>
|
|
|
|
|
|
2018-06-23 16:31:17 +02:00
|
|
|
|
<ul class="act-menu">
|
|
|
|
|
<li id="one1" onclick="setTab('one',1)">灵活的请求响应</li>
|
|
|
|
|
<li id="one2" onclick="setTab('one',2)">强大的Extractors</li>
|
|
|
|
|
<li id="one3" onclick="setTab('one',3)">轻松处理表单</li>
|
|
|
|
|
<li id="one4" onclick="setTab('one',4)">请求路由</li>
|
|
|
|
|
</ul>
|
|
|
|
|
</div>
|
2018-06-23 09:54:08 +02:00
|
|
|
|
|
2018-06-23 05:58:06 +02:00
|
|
|
|
</div>
|
2018-06-23 09:54:08 +02:00
|
|
|
|
</div>
|
2018-06-23 05:58:06 +02:00
|
|
|
|
|
|
|
|
|
|
2018-05-22 23:15:08 +02:00
|
|
|
|
{{ partial "footer" . }}
|