1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66
//! HTTP Server //! //! A `Server` is created to listen on a port, parse HTTP requests, and hand //! them off to a `Service`. //! //! There are two levels of APIs provide for constructing HTTP servers: //! //! - The higher-level [`Server`](Server) type. //! - The lower-level [`conn`](conn) module. //! //! # Server //! //! The [`Server`](Server) is main way to start listening for HTTP requests. //! It wraps a listener with a [`MakeService`](crate::service), and then should //! be executed to start serving requests. //! //! [`Server`](Server) accepts connections in both HTTP1 and HTTP2 by default. //! //! ## Example //! //! ```no_run //! use std::convert::Infallible; //! use std::net::SocketAddr; //! use hyper::{Body, Request, Response, Server}; //! use hyper::service::{make_service_fn, service_fn}; //! //! async fn handle(_req: Request<Body>) -> Result<Response<Body>, Infallible> { //! Ok(Response::new(Body::from("Hello World"))) //! } //! //! # #[cfg(feature = "runtime")] //! #[tokio::main] //! async fn main() { //! // Construct our SocketAddr to listen on... //! let addr = SocketAddr::from(([127, 0, 0, 1], 3000)); //! //! // And a MakeService to handle each connection... //! let make_service = make_service_fn(|_conn| async { //! Ok::<_, Infallible>(service_fn(handle)) //! }); //! //! // Then bind and serve... //! let server = Server::bind(&addr).serve(make_service); //! //! // And run forever... //! if let Err(e) = server.await { //! eprintln!("server error: {}", e); //! } //! } //! # #[cfg(not(feature = "runtime"))] //! # fn main() {} //! ``` pub mod accept; cfg_feature! { #![any(feature = "http1", feature = "http2")] pub use self::server::{Builder, Server}; pub mod conn; mod server; mod shutdown; #[cfg(feature = "tcp")] mod tcp; }