1
0
mirror of https://github.com/actix/actix-website synced 2024-11-28 18:32:39 +01:00
actix-website/layouts/index.html

305 lines
11 KiB
HTML
Raw Normal View History

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提供了丰富的特性开箱即用。WebSocketsHTTP/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" . }}