restructure folders

shutdown-server/Cargo.toml

@@ -0,0 +1,11 @@
+[package]
+name = "shutdown-server"
+version = "1.0.0"
+edition = "2021"
+description = "Send a request to the server to shut it down"
+
+[dependencies]
+actix-web = "4.0.0-rc.1"
+env_logger = "0.9"
+futures = "0.3"
+tokio = { version = "1.16", features = ["signal"] }

shutdown-server/README.md

@@ -0,0 +1,27 @@
+# shutdown-server
+
+Demonstrates how to shutdown the web server in a couple of ways:
+
+1. remotely, via http request
+    - Created in response to actix/actix-web#1315
+1. sending a SIGINT signal to the server (control-c)
+    - actix-server natively supports SIGINT
+
+## Usage
+
+### Running The Server
+
+```bash
+cd basics/shutdown-server
+cargo run --bin shutdown-server
+
+# Starting 8 workers
+# Starting "actix-web-service-127.0.0.1:8080" service on 127.0.0.1:8080
+```
+
+### Available Routes
+
+- [GET /hello](http://localhost:8080/hello)
+    - Regular hello world route
+- [POST /stop](http://localhost:8080/stop)
+    - Calling this will shutdown the server and exit

shutdown-server/src/main.rs

@@ -0,0 +1,52 @@
+use actix_web::{get, middleware, post, web, App, HttpResponse, HttpServer};
+use futures::executor;
+use std::{sync::mpsc, thread};
+
+#[get("/hello")]
+async fn hello() -> &'static str {
+    "Hello world!"
+}
+
+#[post("/stop")]
+async fn stop(stopper: web::Data<mpsc::Sender<()>>) -> HttpResponse {
+    // make request that sends message through the Sender
+    stopper.send(()).unwrap();
+
+    HttpResponse::NoContent().finish()
+}
+
+#[actix_web::main]
+async fn main() -> std::io::Result<()> {
+    std::env::set_var("RUST_LOG", "actix_server=debug,actix_web=debug");
+    env_logger::init();
+
+    // create a channel
+    let (tx, rx) = mpsc::channel::<()>();
+
+    let bind = ("127.0.0.1", 8080);
+
+    // start server as normal but don't .await after .run() yet
+    let server = HttpServer::new(move || {
+        // give the server a Sender in .data
+        App::new()
+            .app_data(web::Data::new(tx.clone()))
+            .wrap(middleware::Logger::default())
+            .service(hello)
+            .service(stop)
+    })
+    .bind(&bind)?
+    .run();
+
+    // clone the Server handle
+    let srv = server.handle();
+    thread::spawn(move || {
+        // wait for shutdown signal
+        rx.recv().unwrap();
+
+        // stop server gracefully
+        executor::block_on(srv.stop(true))
+    });
+
+    // run server
+    server.await
+}