summaryrefslogtreecommitdiffstats
path: root/examples/print_each_packet.rs
diff options
context:
space:
mode:
authorEliza Weisman <eliza@buoyant.io>2019-03-22 15:25:42 -0700
committerGitHub <noreply@github.com>2019-03-22 15:25:42 -0700
commit30330da11a56dfdd11bdbef50dba073a9edc36b2 (patch)
treebf4e8e90293a3c75a2bf5281572e1c01eceab3cb /examples/print_each_packet.rs
parent6e4945025cdc6f2b71d9b30aaa23c5517cca1504 (diff)
chore: Fix examples not working with `cargo run` (#998)
* chore: Fix examples not working with `cargo run` ## Motivation PR #991 moved the `tokio` crate to its own subdirectory, but did not move the `examples` directory into `tokio/examples`. While attempting to use the examples for testing another change, I noticed that #991 had broken the ability to use `cargo run`, as the examples were no longer considered part of a crate that cargo was aware of: ``` tokio on master [$] via 🦀v1.33.0 at ☸️ aks-eliza-dev ➜ cargo run --example chat error: no example target named `chat` Did you mean `echo`? ``` ## Solution This branch moves the examples into the `tokio` directory, so cargo is now once again aware of them: ``` tokio on eliza/fix-examples [$] via 🦀v1.33.0 at ☸️ aks-eliza-dev ➜ cargo run --example chat Compiling tokio-executor v0.1.7 (/Users/eliza/Code/tokio/tokio-executor) Compiling tokio-reactor v0.1.9 Compiling tokio-threadpool v0.1.13 Compiling tokio-current-thread v0.1.6 Compiling tokio-timer v0.2.10 Compiling tokio-uds v0.2.5 Compiling tokio-udp v0.1.3 Compiling tokio-tcp v0.1.3 Compiling tokio-fs v0.1.6 Compiling tokio v0.1.18 (/Users/eliza/Code/tokio/tokio) Finished dev [unoptimized + debuginfo] target(s) in 7.04s Running `target/debug/examples/chat` server running on localhost:6142 ``` Signed-off-by: Eliza Weisman <eliza@buoyant.io> Signed-off-by: Eliza Weisman <eliza@buoyant.io>
Diffstat (limited to 'examples/print_each_packet.rs')
-rw-r--r--examples/print_each_packet.rs150
1 files changed, 0 insertions, 150 deletions
diff --git a/examples/print_each_packet.rs b/examples/print_each_packet.rs
deleted file mode 100644
index 94a60648..00000000
--- a/examples/print_each_packet.rs
+++ /dev/null
@@ -1,150 +0,0 @@
-//! A "print-each-packet" server with Tokio
-//!
-//! This server will create a TCP listener, accept connections in a loop, and
-//! put down in the stdout everything that's read off of each TCP connection.
-//!
-//! Because the Tokio runtime uses a thread pool, each TCP connection is
-//! processed concurrently with all other TCP connections across multiple
-//! threads.
-//!
-//! To see this server in action, you can run this in one terminal:
-//!
-//! cargo run --example print\_each\_packet
-//!
-//! and in another terminal you can run:
-//!
-//! cargo run --example connect 127.0.0.1:8080
-//!
-//! Each line you type in to the `connect` terminal should be written to terminal!
-//!
-//! Minimal js example:
-//!
-//! ```js
-//! var net = require("net");
-//!
-//! var listenPort = 8080;
-//!
-//! var server = net.createServer(function (socket) {
-//! socket.on("data", function (bytes) {
-//! console.log("bytes", bytes);
-//! });
-//!
-//! socket.on("end", function() {
-//! console.log("Socket received FIN packet and closed connection");
-//! });
-//! socket.on("error", function (error) {
-//! console.log("Socket closed with error", error);
-//! });
-//!
-//! socket.on("close", function (with_error) {
-//! if (with_error) {
-//! console.log("Socket closed with result: Err(SomeError)");
-//! } else {
-//! console.log("Socket closed with result: Ok(())");
-//! }
-//! });
-//!
-//! });
-//!
-//! server.listen(listenPort);
-//!
-//! console.log("Listening on:", listenPort);
-//! ```
-//!
-
-#![deny(warnings)]
-
-extern crate tokio;
-extern crate tokio_codec;
-
-use tokio::codec::Decoder;
-use tokio::net::TcpListener;
-use tokio::prelude::*;
-use tokio_codec::BytesCodec;
-
-use std::env;
-use std::net::SocketAddr;
-
-fn main() -> Result<(), Box<std::error::Error>> {
- // Allow passing an address to listen on as the first argument of this
- // program, but otherwise we'll just set up our TCP listener on
- // 127.0.0.1:8080 for connections.
- let addr = env::args().nth(1).unwrap_or("127.0.0.1:8080".to_string());
- let addr = addr.parse::<SocketAddr>()?;
-
- // Next up we create a TCP listener which will listen for incoming
- // connections. This TCP listener is bound to the address we determined
- // above and must be associated with an event loop, so we pass in a handle
- // to our event loop. After the socket's created we inform that we're ready
- // to go and start accepting connections.
- let socket = TcpListener::bind(&addr)?;
- println!("Listening on: {}", addr);
-
- // Here we convert the `TcpListener` to a stream of incoming connections
- // with the `incoming` method. We then define how to process each element in
- // the stream with the `for_each` method.
- //
- // This combinator, defined on the `Stream` trait, will allow us to define a
- // computation to happen for all items on the stream (in this case TCP
- // connections made to the server). The return value of the `for_each`
- // method is itself a future representing processing the entire stream of
- // connections, and ends up being our server.
- let done = socket
- .incoming()
- .map_err(|e| println!("failed to accept socket; error = {:?}", e))
- .for_each(move |socket| {
- // Once we're inside this closure this represents an accepted client
- // from our server. The `socket` is the client connection (similar to
- // how the standard library operates).
- //
- // We're parsing each socket with the `BytesCodec` included in `tokio_io`,
- // and then we `split` each codec into the reader/writer halves.
- //
- // See https://docs.rs/tokio-codec/0.1/src/tokio_codec/bytes_codec.rs.html
- let framed = BytesCodec::new().framed(socket);
- let (_writer, reader) = framed.split();
-
- let processor = reader
- .for_each(|bytes| {
- println!("bytes: {:?}", bytes);
- Ok(())
- })
- // After our copy operation is complete we just print out some helpful
- // information.
- .and_then(|()| {
- println!("Socket received FIN packet and closed connection");
- Ok(())
- })
- .or_else(|err| {
- println!("Socket closed with error: {:?}", err);
- // We have to return the error to catch it in the next ``.then` call
- Err(err)
- })
- .then(|result| {
- println!("Socket closed with result: {:?}", result);
- Ok(())
- });
-
- // And this is where much of the magic of this server happens. We
- // crucially want all clients to make progress concurrently, rather than
- // blocking one on completion of another. To achieve this we use the
- // `tokio::spawn` function to execute the work in the background.
- //
- // This function will transfer ownership of the future (`msg` in this
- // case) to the Tokio runtime thread pool that. The thread pool will
- // drive the future to completion.
- //
- // Essentially here we're executing a new task to run concurrently,
- // which will allow all of our clients to be processed concurrently.
- tokio::spawn(processor)
- });
-
- // And finally now that we've define what our server is, we run it!
- //
- // This starts the Tokio runtime, spawns the server task, and blocks the
- // current thread until all tasks complete execution. Since the `done` task
- // never completes (it just keeps accepting sockets), `tokio::run` blocks
- // forever (until ctrl-c is pressed).
- tokio::run(done);
- Ok(())
-}