1
0
mirror of https://github.com/fafhrd91/actix-net synced 2025-03-20 16:05:18 +01:00

update readme

This commit is contained in:
Nikolay Kim 2019-03-11 18:24:31 -07:00
parent 9a9b3e9ca9
commit 8e13ba7bce

View File

@ -1,20 +1,18 @@
# Actix net [![Build Status](https://travis-ci.org/actix/actix-net.svg?branch=master)](https://travis-ci.org/actix/actix-net) [![codecov](https://codecov.io/gh/actix/actix-net/branch/master/graph/badge.svg)](https://codecov.io/gh/actix/actix-net) [![crates.io](https://meritbadge.herokuapp.com/actix-net)](https://crates.io/crates/actix-net) [![Join the chat at https://gitter.im/actix/actix](https://badges.gitter.im/actix/actix.svg)](https://gitter.im/actix/actix?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge) # Actix net [![Build Status](https://travis-ci.org/actix/actix-net.svg?branch=master)](https://travis-ci.org/actix/actix-net) [![codecov](https://codecov.io/gh/actix/actix-net/branch/master/graph/badge.svg)](https://codecov.io/gh/actix/actix-net) [![crates.io](https://meritbadge.herokuapp.com/actix-net)](https://crates.io/crates/actix-net) [![Join the chat at https://gitter.im/actix/actix](https://badges.gitter.im/actix/actix.svg)](https://gitter.im/actix/actix?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
Actix net - framework for composable network services (experimental) Actix net - framework for composable network services
## Documentation & community resources ## Documentation & community resources
* [API Documentation (Development)](https://actix.rs/actix-net/actix_net/) * [API Documentation (Development)](https://actix.rs/actix-net/actix_net/)
* [Chat on gitter](https://gitter.im/actix/actix) * [Chat on gitter](https://gitter.im/actix/actix)
* Cargo package: [actix-net](https://crates.io/crates/actix-net) * Cargo package: [actix-net](https://crates.io/crates/actix-net)
* Minimum supported Rust version: 1.26 or later * Minimum supported Rust version: 1.32 or later
## Example ## Example
```rust ```rust
fn main() { fn main() -> io::Result<()> {
let sys = actix_rt::System::new("test");
// load ssl keys // load ssl keys
let mut builder = SslAcceptor::mozilla_intermediate(SslMethod::tls()).unwrap(); let mut builder = SslAcceptor::mozilla_intermediate(SslMethod::tls()).unwrap();
builder.set_private_key_file("./examples/key.pem", SslFiletype::PEM).unwrap(); builder.set_private_key_file("./examples/key.pem", SslFiletype::PEM).unwrap();
@ -26,7 +24,7 @@ fn main() {
// bind socket address and start workers. By default server uses number of // bind socket address and start workers. By default server uses number of
// available logical cpu as threads count. actix net start separate // available logical cpu as threads count. actix net start separate
// instances of service pipeline in each worker. // instances of service pipeline in each worker.
actix_server::build() Server::build()
.bind( .bind(
// configure service pipeline // configure service pipeline
"basic", "0.0.0.0:8443", "basic", "0.0.0.0:8443",
@ -35,28 +33,23 @@ fn main() {
let acceptor = acceptor.clone(); let acceptor = acceptor.clone();
// service for converting incoming TcpStream to a SslStream<TcpStream> // service for converting incoming TcpStream to a SslStream<TcpStream>
(move |stream| { fn_service(move |stream: Io<tokio_tcp::TcpStream>| {
SslAcceptorExt::accept_async(&acceptor, stream) SslAcceptorExt::accept_async(&acceptor, stream.into_parts().0)
.map_err(|e| println!("Openssl error: {}", e)) .map_err(|e| println!("Openssl error: {}", e))
}) })
// convert closure to a `NewService` // .and_then() combinator uses other service to convert incoming `Request` to a
.into_new_service() // `Response` and then uses that response as an input for next
// service. in this case, on success we use `logger` service
// .and_then() combinator uses other service to convert incoming `Request` to a `Response` .and_then(fn_service(logger))
// and then uses that response as an input for next service. // Next service counts number of connections
// in this case, on success we use `logger` service .and_then(move |_| {
.and_then(logger) let num = num.fetch_add(1, Ordering::Relaxed);
println!("got ssl connection {:?}", num);
// Next service counts number of connections future::ok(())
.and_then(move |req| { })
let num = num.fetch_add(1, Ordering::Relaxed); },
println!("processed {:?} connections", num); )?
future::ok(()) .run()
})
}).unwrap()
.start();
sys.run();
} }
``` ```