2020-01-30 16:01:47 +01:00
# Actix net [](https://codecov.io/gh/actix/actix-net) [](https://gitter.im/actix/actix?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
2018-09-11 18:03:27 +02:00
2019-03-12 02:24:31 +01:00
Actix net - framework for composable network services
2018-09-11 18:03:27 +02:00
2020-01-30 16:01:47 +01:00
## Build statuses
| Platform | Build Status |
| ---------------- | ------------ |
| Linux | [](https://github.com/actix/actix-net/actions?query=workflow%3A"CI+(Linux)") |
| macOS | [](https://github.com/actix/actix-net/actions?query=workflow%3A"CI+(macOS)") |
| Windows | [](https://github.com/actix/actix-net/actions?query=workflow%3A"CI+(Windows)") |
| Windows (MinGW) | [](https://github.com/actix/actix-net/actions?query=workflow%3A"CI+(Windows-mingw)") |
2018-09-11 18:03:27 +02:00
## Documentation & community resources
2020-08-17 16:37:57 +02:00
* [Chat on Gitter ](https://gitter.im/actix/actix )
2020-12-27 05:36:08 +01:00
* Minimum supported Rust version: 1.46 or later
2018-09-11 18:03:27 +02:00
## Example
```rust
2019-03-12 02:24:31 +01:00
fn main() -> io::Result< ()> {
2018-09-11 18:03:27 +02:00
// load ssl keys
let mut builder = SslAcceptor::mozilla_intermediate(SslMethod::tls()).unwrap();
builder.set_private_key_file("./examples/key.pem", SslFiletype::PEM).unwrap();
builder.set_certificate_chain_file("./examples/cert.pem").unwrap();
let acceptor = builder.build();
let num = Arc::new(AtomicUsize::new(0));
// bind socket address and start workers. By default server uses number of
// available logical cpu as threads count. actix net start separate
// instances of service pipeline in each worker.
2019-03-12 02:24:31 +01:00
Server::build()
2018-09-11 18:03:27 +02:00
.bind(
// configure service pipeline
2018-09-18 05:19:48 +02:00
"basic", "0.0.0.0:8443",
2018-09-11 18:03:27 +02:00
move || {
let num = num.clone();
let acceptor = acceptor.clone();
2019-12-10 16:34:51 +01:00
// construct transformation pipeline
pipeline(
// service for converting incoming TcpStream to a SslStream< TcpStream >
fn_service(move |stream: actix_rt::net::TcpStream| async move {
SslAcceptorExt::accept_async(& acceptor, stream.into_parts().0).await
.map_err(|e| println!("Openssl error: {}", e))
}))
// .and_then() combinator chains result of previos service call to argument
/// for next service calll. in this case, on success we chain
/// ssl stream to the `logger` service.
2019-03-12 02:24:31 +01:00
.and_then(fn_service(logger))
// Next service counts number of connections
.and_then(move |_| {
let num = num.fetch_add(1, Ordering::Relaxed);
println!("got ssl connection {:?}", num);
future::ok(())
})
},
)?
.run()
2018-09-11 18:03:27 +02:00
}
```
## License
This project is licensed under either of
* Apache License, Version 2.0, ([LICENSE-APACHE](LICENSE-APACHE) or [http://www.apache.org/licenses/LICENSE-2.0 ](http://www.apache.org/licenses/LICENSE-2.0 ))
* MIT license ([LICENSE-MIT](LICENSE-MIT) or [http://opensource.org/licenses/MIT ](http://opensource.org/licenses/MIT ))
at your option.
## Code of Conduct
Contribution to the actix-net crate is organized under the terms of the
Contributor Covenant, the maintainer of actix-net, @fafhrd91 , promises to
intervene to uphold that code of conduct.
