2dc6202fe7
This introduces the `hyper::service` module, which replaces `tokio-service`. Since the trait is specific to hyper, its associated types have been adjusted. It didn't make sense to need to define `Service<Request=http::Request>`, since we already know the context is HTTP. Instead, the request and response bodies are associated types now, and slightly stricter bounds have been placed on `Error`. The helpers `service_fn` and `service_fn_ok` should be sufficient for now to ease creating `Service`s. The `NewService` trait now allows service creation to also be asynchronous. These traits are similar to `tower` in nature, and possibly will be replaced completely by it in the future. For now, hyper defining its own allows the traits to have better context, and prevents breaking changes in `tower` from affecting hyper. Closes #1461 BREAKING CHANGE: The `Service` trait has changed: it has some changed associated types, and `call` is now bound to `&mut self`. The `NewService` trait has changed: it has some changed associated types, and `new_service` now returns a `Future`. `Client` no longer implements `Service` for now. `hyper::server::conn::Serve` now returns `Connecting` instead of `Connection`s, since `new_service` can now return a `Future`. The `Connecting` is a future wrapping the new service future, returning a `Connection` afterwards. In many cases, `Future::flatten` can be used.
65 lines
1.4 KiB
Rust
65 lines
1.4 KiB
Rust
#![doc(html_root_url = "https://docs.rs/hyper/0.11.22")]
|
|
#![deny(missing_docs)]
|
|
#![deny(warnings)]
|
|
#![deny(missing_debug_implementations)]
|
|
#![cfg_attr(all(test, feature = "nightly"), feature(test))]
|
|
|
|
//! # Hyper
|
|
//!
|
|
//! Hyper is a fast, modern HTTP implementation written in and for Rust. It
|
|
//! is a low-level typesafe abstraction over raw HTTP, providing an elegant
|
|
//! layer over "stringly-typed" HTTP.
|
|
//!
|
|
//! Hyper provides both a [Client](client/index.html) and a
|
|
//! [Server](server/index.html).
|
|
//!
|
|
//! If just starting out, **check out the [Guides](https://hyper.rs/guides)
|
|
//! first.**
|
|
|
|
extern crate bytes;
|
|
#[macro_use] extern crate futures;
|
|
extern crate futures_cpupool;
|
|
extern crate futures_timer;
|
|
extern crate h2;
|
|
extern crate http;
|
|
extern crate httparse;
|
|
extern crate iovec;
|
|
#[macro_use] extern crate log;
|
|
extern crate net2;
|
|
extern crate time;
|
|
extern crate tokio;
|
|
extern crate tokio_executor;
|
|
#[macro_use] extern crate tokio_io;
|
|
extern crate want;
|
|
|
|
#[cfg(all(test, feature = "nightly"))]
|
|
extern crate test;
|
|
|
|
pub use http::{
|
|
HeaderMap,
|
|
Method,
|
|
Request,
|
|
Response,
|
|
StatusCode,
|
|
Uri,
|
|
Version,
|
|
};
|
|
|
|
pub use client::Client;
|
|
pub use error::{Result, Error};
|
|
pub use body::{Body};
|
|
pub use chunk::Chunk;
|
|
pub use server::Server;
|
|
|
|
mod common;
|
|
#[cfg(test)]
|
|
mod mock;
|
|
pub mod body;
|
|
mod chunk;
|
|
pub mod client;
|
|
pub mod error;
|
|
mod headers;
|
|
mod proto;
|
|
pub mod server;
|
|
pub mod service;
|