forked/hyper
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Merge pull request #1490 from hyperium/service2

Browse Source 
feat(service): introduce hyper-specific `Service`
This commit is contained in:
Sean McArthur
2018-04-18 14:11:36 -07:00
committed by GitHub
parent 71a15c25f5 2dc6202fe7
commit d04ca7b21a
24 changed files with 749 additions and 582 deletions
Download Patch File Download Diff File Expand all files Collapse all files

1
Cargo.toml
View File

@@ -34,7 +34,6 @@ net2 = "0.2.32"
time = "0.1" time = "0.1"
tokio = "0.1.5" tokio = "0.1.5"
tokio-executor = "0.1.0" tokio-executor = "0.1.0"
tokio-service = "0.1"
tokio-io = "0.1" tokio-io = "0.1"
want = "0.0.3" want = "0.0.3"

9
benches/end_to_end.rs
View File

@@ -71,20 +71,20 @@ fn post_one_at_a_time(b: &mut test::Bencher) {
static PHRASE: &'static [u8] = include_bytes!("../CHANGELOG.md"); //b"Hello, World!"; static PHRASE: &'static [u8] = include_bytes!("../CHANGELOG.md"); //b"Hello, World!";
fn spawn_hello(rt: &mut Runtime) -> SocketAddr { fn spawn_hello(rt: &mut Runtime) -> SocketAddr {
use hyper::server::{const_service, service_fn, NewService}; use hyper::service::{service_fn};
let addr = "127.0.0.1:0".parse().unwrap(); let addr = "127.0.0.1:0".parse().unwrap();
let listener = TcpListener::bind(&addr).unwrap(); let listener = TcpListener::bind(&addr).unwrap();
let addr = listener.local_addr().unwrap(); let addr = listener.local_addr().unwrap();
let http = Http::new(); let http = Http::new();
let service = const_service(service_fn(|req: Request<Body>| { let service = service_fn(|req: Request<Body>| {
req.into_body() req.into_body()
.concat2() .concat2()
.map(|_| { .map(|_| {
Response::new(Body::from(PHRASE)) Response::new(Body::from(PHRASE))
}) })
})); });
// Specifically only accept 1 connection. // Specifically only accept 1 connection.
let srv = listener.incoming() let srv = listener.incoming()
@@ -92,8 +92,7 @@ fn spawn_hello(rt: &mut Runtime) -> SocketAddr {
.map_err(|(e, _inc)| panic!("accept error: {}", e)) .map_err(|(e, _inc)| panic!("accept error: {}", e))
.and_then(move |(accepted, _inc)| { .and_then(move |(accepted, _inc)| {
let socket = accepted.expect("accepted socket"); let socket = accepted.expect("accepted socket");
http.serve_connection(socket, service.new_service().expect("new_service")) http.serve_connection(socket, service)
.map(|_| ())
.map_err(|_| ()) .map_err(|_| ())
}); });
rt.spawn(srv); rt.spawn(srv);

44
benches/server.rs
View File

@@ -11,11 +11,11 @@ use std::io::{Read, Write};
use std::net::{TcpListener, TcpStream}; use std::net::{TcpListener, TcpStream};
use std::sync::mpsc; use std::sync::mpsc;
use futures::{future, stream, Future, Stream}; use futures::{stream, Future, Stream};
use futures::sync::oneshot; use futures::sync::oneshot;
use hyper::{Body, Request, Response, Server}; use hyper::{Body, Response, Server};
use hyper::server::Service; use hyper::service::service_fn_ok;
macro_rules! bench_server { macro_rules! bench_server {
($b:ident, $header:expr, $body:expr) => ({ ($b:ident, $header:expr, $body:expr) => ({
@@ -26,10 +26,17 @@ macro_rules! bench_server {
::std::thread::spawn(move || { ::std::thread::spawn(move || {
let addr = "127.0.0.1:0".parse().unwrap(); let addr = "127.0.0.1:0".parse().unwrap();
let srv = Server::bind(&addr) let srv = Server::bind(&addr)
.serve(|| Ok(BenchPayload { .serve(|| {
header: $header, let header = $header;
body: $body, let body = $body;
})); service_fn_ok(move |_| {
Response::builder()
.header(header.0, header.1)
.header("content-type", "text/plain")
.body(body())
.unwrap()
})
});
addr_tx.send(srv.local_addr()).unwrap(); addr_tx.send(srv.local_addr()).unwrap();
let fut = srv let fut = srv
.map_err(|e| panic!("server error: {}", e)) .map_err(|e| panic!("server error: {}", e))
@@ -182,26 +189,3 @@ fn raw_tcp_throughput_large_payload(b: &mut test::Bencher) {
tx.send(()).unwrap(); tx.send(()).unwrap();
} }
struct BenchPayload<F> {
header: (&'static str, &'static str),
body: F,
}
impl<F, B> Service for BenchPayload<F>
where
F: Fn() -> B,
{
type Request = Request<Body>;
type Response = Response<B>;
type Error = hyper::Error;
type Future = future::FutureResult<Self::Response, hyper::Error>;
fn call(&self, _req: Self::Request) -> Self::Future {
future::ok(
Response::builder()
.header(self.header.0, self.header.1)
.header("content-type", "text/plain")
.body((self.body)())
.unwrap()
)
}
}

18
examples/hello.rs
View File

@@ -6,8 +6,8 @@ extern crate tokio;
use futures::Future; use futures::Future;
use hyper::{Body, Response}; use hyper::{Body, Response, Server};
use hyper::server::{Server, const_service, service_fn}; use hyper::service::service_fn_ok;
static PHRASE: &'static [u8] = b"Hello World!"; static PHRASE: &'static [u8] = b"Hello World!";
@@ -16,10 +16,16 @@ fn main() {
let addr = ([127, 0, 0, 1], 3000).into(); let addr = ([127, 0, 0, 1], 3000).into();
let new_service = const_service(service_fn(|_| { // new_service is run for each connection, creating a 'service'
//TODO: when `!` is stable, replace error type // to handle requests for that specific connection.
Ok::<_, hyper::Error>(Response::new(Body::from(PHRASE))) let new_service = || {
})); // This is the `Service` that will handle the connection.
// `service_fn_ok` is a helper to convert a function that
// returns a Response into a `Service`.
service_fn_ok(|_| {
Response::new(Body::from(PHRASE))
})
};
let server = Server::bind(&addr) let server = Server::bind(&addr)
.serve(new_service) .serve(new_service)

35
examples/multi_server.rs
View File

@@ -5,39 +5,14 @@ extern crate pretty_env_logger;
extern crate tokio; extern crate tokio;
use futures::{Future}; use futures::{Future};
use futures::future::{FutureResult, lazy}; use futures::future::{lazy};
use hyper::{Body, Method, Request, Response, StatusCode}; use hyper::{Body, Response, Server};
use hyper::server::{Server, Service}; use hyper::service::service_fn_ok;
static INDEX1: &'static [u8] = b"The 1st service!"; static INDEX1: &'static [u8] = b"The 1st service!";
static INDEX2: &'static [u8] = b"The 2nd service!"; static INDEX2: &'static [u8] = b"The 2nd service!";
struct Srv(&'static [u8]);
impl Service for Srv {
type Request = Request<Body>;
type Response = Response<Body>;
type Error = hyper::Error;
type Future = FutureResult<Response<Body>, hyper::Error>;
fn call(&self, req: Request<Body>) -> Self::Future {
futures::future::ok(match (req.method(), req.uri().path()) {
(&Method::GET, "/") => {
Response::new(self.0.into())
},
_ => {
Response::builder()
.status(StatusCode::NOT_FOUND)
.body(Body::empty())
.unwrap()
}
})
}
}
fn main() { fn main() {
pretty_env_logger::init(); pretty_env_logger::init();
@@ -46,11 +21,11 @@ fn main() {
tokio::run(lazy(move || { tokio::run(lazy(move || {
let srv1 = Server::bind(&addr1) let srv1 = Server::bind(&addr1)
.serve(|| Ok(Srv(INDEX1))) .serve(|| service_fn_ok(|_| Response::new(Body::from(INDEX1))))
.map_err(|e| eprintln!("server 1 error: {}", e)); .map_err(|e| eprintln!("server 1 error: {}", e));
let srv2 = Server::bind(&addr2) let srv2 = Server::bind(&addr2)
.serve(|| Ok(Srv(INDEX2))) .serve(|| service_fn_ok(|_| Response::new(Body::from(INDEX2))))
.map_err(|e| eprintln!("server 2 error: {}", e)); .map_err(|e| eprintln!("server 2 error: {}", e));
println!("Listening on http://{} and http://{}", addr1, addr2); println!("Listening on http://{} and http://{}", addr1, addr2);

129
examples/params.rs
View File

@@ -5,10 +5,10 @@ extern crate pretty_env_logger;
extern crate tokio; extern crate tokio;
extern crate url; extern crate url;
use futures::{Future, Stream}; use futures::{future, Future, Stream};
use hyper::{Body, Method, Request, Response, StatusCode}; use hyper::{Body, Method, Request, Response, Server, StatusCode};
use hyper::server::{Server, Service}; use hyper::service::service_fn;
use std::collections::HashMap; use std::collections::HashMap;
use url::form_urlencoded; use url::form_urlencoded;
@@ -17,89 +17,80 @@ static INDEX: &[u8] = b"<html><body><form action=\"post\" method=\"post\">Name:
static MISSING: &[u8] = b"Missing field"; static MISSING: &[u8] = b"Missing field";
static NOTNUMERIC: &[u8] = b"Number field is not numeric"; static NOTNUMERIC: &[u8] = b"Number field is not numeric";
struct ParamExample; // Using service_fn, we can turn this function into a `Service`.
fn param_example(req: Request<Body>) -> Box<Future<Item=Response<Body>, Error=hyper::Error> + Send> {
match (req.method(), req.uri().path()) {
(&Method::GET, "/") | (&Method::GET, "/post") => {
Box::new(future::ok(Response::new(INDEX.into())))
},
(&Method::POST, "/post") => {
Box::new(req.into_body().concat2().map(|b| {
// Parse the request body. form_urlencoded::parse
// always succeeds, but in general parsing may
// fail (for example, an invalid post of json), so
// returning early with BadRequest may be
// necessary.
//
// Warning: this is a simplified use case. In
// principle names can appear multiple times in a
// form, and the values should be rolled up into a
// HashMap<String, Vec<String>>. However in this
// example the simpler approach is sufficient.
let params = form_urlencoded::parse(b.as_ref()).into_owned().collect::<HashMap<String, String>>();
impl Service for ParamExample { // Validate the request parameters, returning
type Request = Request<Body>; // early if an invalid input is detected.
type Response = Response<Body>; let name = if let Some(n) = params.get("name") {
type Error = hyper::Error; n
type Future = Box<Future<Item = Self::Response, Error = Self::Error> + Send>; } else {
return Response::builder()
fn call(&self, req: Request<Body>) -> Self::Future { .status(StatusCode::UNPROCESSABLE_ENTITY)
match (req.method(), req.uri().path()) { .body(MISSING.into())
(&Method::GET, "/") | (&Method::GET, "/post") => { .unwrap();
Box::new(futures::future::ok(Response::new(INDEX.into()))) };
}, let number = if let Some(n) = params.get("number") {
(&Method::POST, "/post") => { if let Ok(v) = n.parse::<f64>() {
Box::new(req.into_body().concat2().map(|b| { v
// Parse the request body. form_urlencoded::parse
// always succeeds, but in general parsing may
// fail (for example, an invalid post of json), so
// returning early with BadRequest may be
// necessary.
//
// Warning: this is a simplified use case. In
// principle names can appear multiple times in a
// form, and the values should be rolled up into a
// HashMap<String, Vec<String>>. However in this
// example the simpler approach is sufficient.
let params = form_urlencoded::parse(b.as_ref()).into_owned().collect::<HashMap<String, String>>();
// Validate the request parameters, returning
// early if an invalid input is detected.
let name = if let Some(n) = params.get("name") {
n
} else { } else {
return Response::builder() return Response::builder()
.status(StatusCode::UNPROCESSABLE_ENTITY) .status(StatusCode::UNPROCESSABLE_ENTITY)
.body(MISSING.into()) .body(NOTNUMERIC.into())
.unwrap(); .unwrap();
}; }
let number = if let Some(n) = params.get("number") { } else {
if let Ok(v) = n.parse::<f64>() { return Response::builder()
v .status(StatusCode::UNPROCESSABLE_ENTITY)
} else { .body(MISSING.into())
return Response::builder() .unwrap();
.status(StatusCode::UNPROCESSABLE_ENTITY) };
.body(NOTNUMERIC.into())
.unwrap();
}
} else {
return Response::builder()
.status(StatusCode::UNPROCESSABLE_ENTITY)
.body(MISSING.into())
.unwrap();
};
// Render the response. This will often involve // Render the response. This will often involve
// calls to a database or web service, which will // calls to a database or web service, which will
// require creating a new stream for the response // require creating a new stream for the response
// body. Since those may fail, other error // body. Since those may fail, other error
// responses such as InternalServiceError may be // responses such as InternalServiceError may be
// needed here, too. // needed here, too.
let body = format!("Hello {}, your number is {}", name, number); let body = format!("Hello {}, your number is {}", name, number);
Response::new(body.into()) Response::new(body.into())
})) }))
}, },
_ => { _ => {
Box::new(futures::future::ok(Response::builder() Box::new(future::ok(Response::builder()
.status(StatusCode::NOT_FOUND) .status(StatusCode::NOT_FOUND)
.body(Body::empty()) .body(Body::empty())
.unwrap())) .unwrap()))
}
} }
} }
} }
fn main() { fn main() {
pretty_env_logger::init(); pretty_env_logger::init();
let addr = ([127, 0, 0, 1], 1337).into(); let addr = ([127, 0, 0, 1], 1337).into();
let server = Server::bind(&addr) let server = Server::bind(&addr)
.serve(|| Ok(ParamExample)) .serve(|| service_fn(param_example))
.map_err(|e| eprintln!("server error: {}", e)); .map_err(|e| eprintln!("server error: {}", e));
tokio::run(server); tokio::run(server);

184
examples/send_file.rs
View File

@@ -4,11 +4,11 @@ extern crate hyper;
extern crate pretty_env_logger; extern crate pretty_env_logger;
extern crate tokio; extern crate tokio;
use futures::{Future/*, Sink*/}; use futures::{future, Future};
use futures::sync::oneshot; use futures::sync::oneshot;
use hyper::{Body, /*Chunk,*/ Method, Request, Response, StatusCode}; use hyper::{Body, Method, Request, Response, Server, StatusCode};
use hyper::server::{Server, Service}; use hyper::service::service_fn;
use std::fs::File; use std::fs::File;
use std::io::{self, copy/*, Read*/}; use std::io::{self, copy/*, Read*/};
@@ -17,7 +17,92 @@ use std::thread;
static NOTFOUND: &[u8] = b"Not Found"; static NOTFOUND: &[u8] = b"Not Found";
static INDEX: &str = "examples/send_file_index.html"; static INDEX: &str = "examples/send_file_index.html";
fn simple_file_send(f: &str) -> Box<Future<Item = Response<Body>, Error = io::Error> + Send> {
fn main() {
pretty_env_logger::init();
let addr = "127.0.0.1:1337".parse().unwrap();
let server = Server::bind(&addr)
.serve(|| service_fn(response_examples))
.map_err(|e| eprintln!("server error: {}", e));
println!("Listening on http://{}", addr);
tokio::run(server);
}
type ResponseFuture = Box<Future<Item=Response<Body>, Error=io::Error> + Send>;
fn response_examples(req: Request<Body>) -> ResponseFuture {
match (req.method(), req.uri().path()) {
(&Method::GET, "/") | (&Method::GET, "/index.html") => {
simple_file_send(INDEX)
},
(&Method::GET, "/big_file.html") => {
// Stream a large file in chunks. This requires a
// little more overhead with two channels, (one for
// the response future, and a second for the response
// body), but can handle arbitrarily large files.
//
// We use an artificially small buffer, since we have
// a small test file.
let (tx, rx) = oneshot::channel();
thread::spawn(move || {
let _file = match File::open(INDEX) {
Ok(f) => f,
Err(_) => {
tx.send(Response::builder()
.status(StatusCode::NOT_FOUND)
.body(NOTFOUND.into())
.unwrap())
.expect("Send error on open");
return;
},
};
let (_tx_body, rx_body) = Body::channel();
let res = Response::new(rx_body.into());
tx.send(res).expect("Send error on successful file read");
/* TODO: fix once we have futures 0.2 Sink working
let mut buf = [0u8; 16];
loop {
match file.read(&mut buf) {
Ok(n) => {
if n == 0 {
// eof
tx_body.close().expect("panic closing");
break;
} else {
let chunk: Chunk = buf[0..n].to_vec().into();
match tx_body.send_data(chunk).wait() {
Ok(t) => { tx_body = t; },
Err(_) => { break; }
};
}
},
Err(_) => { break; }
}
}
*/
});
Box::new(rx.map_err(|e| io::Error::new(io::ErrorKind::Other, e)))
},
(&Method::GET, "/no_file.html") => {
// Test what happens when file cannot be be found
simple_file_send("this_file_should_not_exist.html")
},
_ => {
Box::new(future::ok(Response::builder()
.status(StatusCode::NOT_FOUND)
.body(Body::empty())
.unwrap()))
}
}
}
fn simple_file_send(f: &str) -> ResponseFuture {
// Serve a file by reading it entirely into memory. As a result // Serve a file by reading it entirely into memory. As a result
// this is limited to serving small files, but it is somewhat // this is limited to serving small files, but it is somewhat
// simpler with a little less overhead. // simpler with a little less overhead.
@@ -57,94 +142,3 @@ fn simple_file_send(f: &str) -> Box<Future<Item = Response<Body>, Error = io::Er
Box::new(rx.map_err(|e| io::Error::new(io::ErrorKind::Other, e))) Box::new(rx.map_err(|e| io::Error::new(io::ErrorKind::Other, e)))
} }
struct ResponseExamples;
impl Service for ResponseExamples {
type Request = Request<Body>;
type Response = Response<Body>;
type Error = io::Error;
type Future = Box<Future<Item = Self::Response, Error = Self::Error> + Send>;
fn call(&self, req: Request<Body>) -> Self::Future {
match (req.method(), req.uri().path()) {
(&Method::GET, "/") | (&Method::GET, "/index.html") => {
simple_file_send(INDEX)
},
(&Method::GET, "/big_file.html") => {
// Stream a large file in chunks. This requires a
// little more overhead with two channels, (one for
// the response future, and a second for the response
// body), but can handle arbitrarily large files.
//
// We use an artificially small buffer, since we have
// a small test file.
let (tx, rx) = oneshot::channel();
thread::spawn(move || {
let _file = match File::open(INDEX) {
Ok(f) => f,
Err(_) => {
tx.send(Response::builder()
.status(StatusCode::NOT_FOUND)
.body(NOTFOUND.into())
.unwrap())
.expect("Send error on open");
return;
},
};
let (_tx_body, rx_body) = Body::channel();
let res = Response::new(rx_body.into());
tx.send(res).expect("Send error on successful file read");
/* TODO: fix once we have futures 0.2 Sink working
let mut buf = [0u8; 16];
loop {
match file.read(&mut buf) {
Ok(n) => {
if n == 0 {
// eof
tx_body.close().expect("panic closing");
break;
} else {
let chunk: Chunk = buf[0..n].to_vec().into();
match tx_body.send_data(chunk).wait() {
Ok(t) => { tx_body = t; },
Err(_) => { break; }
};
}
},
Err(_) => { break; }
}
}
*/
});
Box::new(rx.map_err(|e| io::Error::new(io::ErrorKind::Other, e)))
},
(&Method::GET, "/no_file.html") => {
// Test what happens when file cannot be be found
simple_file_send("this_file_should_not_exist.html")
},
_ => {
Box::new(futures::future::ok(Response::builder()
.status(StatusCode::NOT_FOUND)
.body(Body::empty())
.unwrap()))
}
}
}
}
fn main() {
pretty_env_logger::init();
let addr = "127.0.0.1:1337".parse().unwrap();
let server = Server::bind(&addr)
.serve(|| Ok(ResponseExamples))
.map_err(|e| eprintln!("server error: {}", e));
println!("Listening on http://{}", addr);
tokio::run(server);
}

44
examples/server.rs
View File

@@ -5,37 +5,27 @@ extern crate pretty_env_logger;
extern crate tokio; extern crate tokio;
use futures::Future; use futures::Future;
use futures::future::{FutureResult};
use hyper::{Body, Method, Request, Response, StatusCode}; use hyper::{Body, Method, Request, Response, Server, StatusCode};
use hyper::server::{Server, Service}; use hyper::service::service_fn_ok;
static INDEX: &'static [u8] = b"Try POST /echo"; static INDEX: &'static [u8] = b"Try POST /echo";
struct Echo; // Using service_fn_ok, we can convert this function into a `Service`.
fn echo(req: Request<Body>) -> Response<Body> {
impl Service for Echo { match (req.method(), req.uri().path()) {
type Request = Request<Body>; (&Method::GET, "/") | (&Method::POST, "/") => {
type Response = Response<Body>; Response::new(INDEX.into())
type Error = hyper::Error; },
type Future = FutureResult<Self::Response, Self::Error>; (&Method::POST, "/echo") => {
Response::new(req.into_body())
fn call(&self, req: Self::Request) -> Self::Future { },
futures::future::ok(match (req.method(), req.uri().path()) { _ => {
(&Method::GET, "/") | (&Method::POST, "/") => { let mut res = Response::new(Body::empty());
Response::new(INDEX.into()) *res.status_mut() = StatusCode::NOT_FOUND;
}, res
(&Method::POST, "/echo") => { }
Response::new(req.into_body())
},
_ => {
let mut res = Response::new(Body::empty());
*res.status_mut() = StatusCode::NOT_FOUND;
res
}
})
} }
} }
@@ -45,7 +35,7 @@ fn main() {
let addr = ([127, 0, 0, 1], 1337).into(); let addr = ([127, 0, 0, 1], 1337).into();
let server = Server::bind(&addr) let server = Server::bind(&addr)
.serve(|| Ok(Echo)) .serve(|| service_fn_ok(echo))
.map_err(|e| eprintln!("server error: {}", e)); .map_err(|e| eprintln!("server error: {}", e));
println!("Listening on http://{}", addr); println!("Listening on http://{}", addr);

109
examples/web_api.rs
View File

@@ -4,12 +4,11 @@ extern crate hyper;
extern crate pretty_env_logger; extern crate pretty_env_logger;
extern crate tokio; extern crate tokio;
use futures::{Future, Stream}; use futures::{future, Future, Stream};
use futures::future::lazy;
use hyper::{Body, Chunk, Client, Method, Request, Response, StatusCode}; use hyper::{Body, Chunk, Client, Method, Request, Response, Server, StatusCode};
use hyper::client::HttpConnector; use hyper::client::HttpConnector;
use hyper::server::{Server, Service}; use hyper::service::service_fn;
#[allow(unused, deprecated)] #[allow(unused, deprecated)]
use std::ascii::AsciiExt; use std::ascii::AsciiExt;
@@ -19,69 +18,70 @@ static URL: &str = "http://127.0.0.1:1337/web_api";
static INDEX: &[u8] = b"<a href=\"test.html\">test.html</a>"; static INDEX: &[u8] = b"<a href=\"test.html\">test.html</a>";
static LOWERCASE: &[u8] = b"i am a lower case string"; static LOWERCASE: &[u8] = b"i am a lower case string";
struct ResponseExamples(Client<HttpConnector>); fn response_examples(req: Request<Body>, client: &Client<HttpConnector>)
-> Box<Future<Item=Response<Body>, Error=hyper::Error> + Send>
{
match (req.method(), req.uri().path()) {
(&Method::GET, "/") | (&Method::GET, "/index.html") => {
let body = Body::from(INDEX);
Box::new(future::ok(Response::new(body)))
},
(&Method::GET, "/test.html") => {
// Run a web query against the web api below
let req = Request::builder()
.method(Method::POST)
.uri(URL)
.body(LOWERCASE.into())
.unwrap();
let web_res_future = client.request(req);
impl Service for ResponseExamples { Box::new(web_res_future.map(|web_res| {
type Request = Request<Body>; let body = Body::wrap_stream(web_res.into_body().map(|b| {
type Response = Response<Body>; Chunk::from(format!("before: '{:?}'<br>after: '{:?}'",
type Error = hyper::Error; std::str::from_utf8(LOWERCASE).unwrap(),
type Future = Box<Future<Item = Self::Response, Error = Self::Error> + Send>; std::str::from_utf8(&b).unwrap()))
fn call(&self, req: Self::Request) -> Self::Future {
match (req.method(), req.uri().path()) {
(&Method::GET, "/") | (&Method::GET, "/index.html") => {
let body = Body::from(INDEX);
Box::new(futures::future::ok(Response::new(body)))
},
(&Method::GET, "/test.html") => {
// Run a web query against the web api below
let req = Request::builder()
.method(Method::POST)
.uri(URL)
.body(LOWERCASE.into())
.unwrap();
let web_res_future = self.0.request(req);
Box::new(web_res_future.map(|web_res| {
let body = Body::wrap_stream(web_res.into_body().map(|b| {
Chunk::from(format!("before: '{:?}'<br>after: '{:?}'",
std::str::from_utf8(LOWERCASE).unwrap(),
std::str::from_utf8(&b).unwrap()))
}));
Response::new(body)
}))
},
(&Method::POST, "/web_api") => {
// A web api to run against. Simple upcasing of the body.
let body = Body::wrap_stream(req.into_body().map(|chunk| {
let upper = chunk.iter().map(|byte| byte.to_ascii_uppercase())
.collect::<Vec<u8>>();
Chunk::from(upper)
})); }));
Box::new(futures::future::ok(Response::new(body))) Response::new(body)
}, }))
_ => { },
let body = Body::from(NOTFOUND); (&Method::POST, "/web_api") => {
Box::new(futures::future::ok(Response::builder() // A web api to run against. Simple upcasing of the body.
.status(StatusCode::NOT_FOUND) let body = Body::wrap_stream(req.into_body().map(|chunk| {
.body(body) let upper = chunk.iter().map(|byte| byte.to_ascii_uppercase())
.unwrap())) .collect::<Vec<u8>>();
} Chunk::from(upper)
}));
Box::new(future::ok(Response::new(body)))
},
_ => {
let body = Body::from(NOTFOUND);
Box::new(future::ok(Response::builder()
.status(StatusCode::NOT_FOUND)
.body(body)
.unwrap()))
} }
} }
} }
fn main() { fn main() {
pretty_env_logger::init(); pretty_env_logger::init();
let addr = "127.0.0.1:1337".parse().unwrap(); let addr = "127.0.0.1:1337".parse().unwrap();
tokio::run(lazy(move || { tokio::run(future::lazy(move || {
// Share a `Client` with all `Service`s
let client = Client::new(); let client = Client::new();
let new_service = move || {
// Move a clone of `client` into the `service_fn`.
let client = client.clone();
service_fn(move |req| {
response_examples(req, &client)
})
};
let server = Server::bind(&addr) let server = Server::bind(&addr)
.serve(move || Ok(ResponseExamples(client.clone()))) .serve(new_service)
.map_err(|e| eprintln!("server error: {}", e)); .map_err(|e| eprintln!("server error: {}", e));
println!("Listening on http://{}", addr); println!("Listening on http://{}", addr);
@@ -89,3 +89,4 @@ fn main() {
server server
})); }));
} }

17
src/client/mod.rs
View File

@@ -11,7 +11,6 @@ use futures::sync::oneshot;
use http::{Method, Request, Response, Uri, Version}; use http::{Method, Request, Response, Uri, Version};
use http::header::{Entry, HeaderValue, HOST}; use http::header::{Entry, HeaderValue, HOST};
use http::uri::Scheme; use http::uri::Scheme;
pub use tokio_service::Service;
use body::{Body, Payload}; use body::{Body, Payload};
use common::Exec; use common::Exec;
@@ -295,22 +294,6 @@ where C: Connect + Sync + 'static,
} }
} }
impl<C, B> Service for Client<C, B>
where C: Connect + 'static,
C::Future: 'static,
B: Payload + Send + 'static,
B::Data: Send,
{
type Request = Request<B>;
type Response = Response<Body>;
type Error = ::Error;
type Future = FutureResponse;
fn call(&self, req: Self::Request) -> Self::Future {
self.request(req)
}
}
impl<C, B> Clone for Client<C, B> { impl<C, B> Clone for Client<C, B> {
fn clone(&self) -> Client<C, B> { fn clone(&self) -> Client<C, B> {
Client { Client {

5
src/common/mod.rs
View File

@@ -1,6 +1,5 @@
mod exec; mod exec;
mod never;
pub(crate) use self::exec::Exec; pub(crate) use self::exec::Exec;
pub use self::never::Never;
#[derive(Debug)]
pub enum Never {}

22
src/common/never.rs Normal file
View File

@@ -0,0 +1,22 @@
//! An uninhabitable type meaning it can never happen.
//!
//! To be replaced with `!` once it is stable.
use std::error::Error;
use std::fmt;
#[derive(Debug)]
pub enum Never {}
impl fmt::Display for Never {
fn fmt(&self, _: &mut fmt::Formatter) -> fmt::Result {
match *self {}
}
}
impl Error for Never {
fn description(&self) -> &str {
match *self {}
}
}

4
src/error.rs
View File

@@ -203,8 +203,8 @@ impl Error {
Error::new(Kind::UnsupportedRequestMethod, None) Error::new(Kind::UnsupportedRequestMethod, None)
} }
pub(crate) fn new_user_new_service(err: io::Error) -> Error { pub(crate) fn new_user_new_service<E: Into<Cause>>(cause: E) -> Error {
Error::new(Kind::NewService, Some(Box::new(err))) Error::new(Kind::NewService, Some(cause.into()))
} }
pub(crate) fn new_user_service<E: Into<Cause>>(cause: E) -> Error { pub(crate) fn new_user_service<E: Into<Cause>>(cause: E) -> Error {

2
src/lib.rs
View File

@@ -30,7 +30,6 @@ extern crate time;
extern crate tokio; extern crate tokio;
extern crate tokio_executor; extern crate tokio_executor;
#[macro_use] extern crate tokio_io; #[macro_use] extern crate tokio_io;
extern crate tokio_service;
extern crate want; extern crate want;
#[cfg(all(test, feature = "nightly"))] #[cfg(all(test, feature = "nightly"))]
@@ -62,3 +61,4 @@ pub mod error;
mod headers; mod headers;
mod proto; mod proto;
pub mod server; pub mod server;
pub mod service;

4
src/proto/h1/dispatch.rs
View File

@@ -2,10 +2,10 @@ use bytes::Bytes;
use futures::{Async, Future, Poll, Stream}; use futures::{Async, Future, Poll, Stream};
use http::{Request, Response, StatusCode}; use http::{Request, Response, StatusCode};
use tokio_io::{AsyncRead, AsyncWrite}; use tokio_io::{AsyncRead, AsyncWrite};
use tokio_service::Service;
use body::{Body, Payload}; use body::{Body, Payload};
use proto::{BodyLength, Conn, Http1Transaction, MessageHead, RequestHead, RequestLine, ResponseHead}; use proto::{BodyLength, Conn, Http1Transaction, MessageHead, RequestHead, RequestLine, ResponseHead};
use service::Service;
pub(crate) struct Dispatcher<D, Bs: Payload, I, T> { pub(crate) struct Dispatcher<D, Bs: Payload, I, T> {
conn: Conn<I, Bs::Data, T>, conn: Conn<I, Bs::Data, T>,
@@ -312,7 +312,7 @@ impl<S> Server<S> where S: Service {
impl<S, Bs> Dispatch for Server<S> impl<S, Bs> Dispatch for Server<S>
where where
S: Service<Request=Request<Body>, Response=Response<Bs>>, S: Service<ReqBody=Body, ResBody=Bs>,
S::Error: Into<Box<::std::error::Error + Send + Sync>>, S::Error: Into<Box<::std::error::Error + Send + Sync>>,
Bs: Payload, Bs: Payload,
{ {

12
src/proto/h2/server.rs
View File

@@ -5,10 +5,10 @@ use tokio_io::{AsyncRead, AsyncWrite};
use ::body::Payload; use ::body::Payload;
use ::common::Exec; use ::common::Exec;
use ::server::Service; use ::service::Service;
use super::{PipeToSendStream, SendBuf}; use super::{PipeToSendStream, SendBuf};
use ::{Body, Request, Response}; use ::{Body, Response};
pub(crate) struct Server<T, S, B> pub(crate) struct Server<T, S, B>
where where
@@ -39,7 +39,7 @@ where
impl<T, S, B> Server<T, S, B> impl<T, S, B> Server<T, S, B>
where where
T: AsyncRead + AsyncWrite, T: AsyncRead + AsyncWrite,
S: Service<Request=Request<Body>, Response=Response<B>>, S: Service<ReqBody=Body, ResBody=B>,
S::Error: Into<Box<::std::error::Error + Send + Sync>>, S::Error: Into<Box<::std::error::Error + Send + Sync>>,
S::Future: Send + 'static, S::Future: Send + 'static,
B: Payload, B: Payload,
@@ -62,7 +62,7 @@ where
impl<T, S, B> Future for Server<T, S, B> impl<T, S, B> Future for Server<T, S, B>
where where
T: AsyncRead + AsyncWrite, T: AsyncRead + AsyncWrite,
S: Service<Request=Request<Body>, Response=Response<B>>, S: Service<ReqBody=Body, ResBody=B>,
S::Error: Into<Box<::std::error::Error + Send + Sync>>, S::Error: Into<Box<::std::error::Error + Send + Sync>>,
S::Future: Send + 'static, S::Future: Send + 'static,
B: Payload, B: Payload,
@@ -96,8 +96,8 @@ where
fn poll_server<S>(&mut self, service: &mut S, exec: &Exec) -> Poll<(), ::Error> fn poll_server<S>(&mut self, service: &mut S, exec: &Exec) -> Poll<(), ::Error>
where where
S: Service< S: Service<
Request=Request<Body>, ReqBody=Body,
Response=Response<B>, ResBody=B,
>, >,
S::Error: Into<Box<::std::error::Error + Send + Sync>>, S::Error: Into<Box<::std::error::Error + Send + Sync>>,
S::Future: Send + 'static, S::Future: Send + 'static,

92
src/server/conn.rs
View File

@@ -23,7 +23,7 @@ use tokio::reactor::Handle;
use common::Exec; use common::Exec;
use proto; use proto;
use body::{Body, Payload}; use body::{Body, Payload};
use super::{HyperService, NewService, Request, Response, Service}; use service::{NewService, Service};
pub use super::tcp::AddrIncoming; pub use super::tcp::AddrIncoming;
@@ -44,7 +44,7 @@ pub struct Http {
/// A stream mapping incoming IOs to new services. /// A stream mapping incoming IOs to new services.
/// ///
/// Yields `Connection`s that are futures that should be put on a reactor. /// Yields `Connecting`s that are futures that should be put on a reactor.
#[must_use = "streams do nothing unless polled"] #[must_use = "streams do nothing unless polled"]
#[derive(Debug)] #[derive(Debug)]
pub struct Serve<I, S> { pub struct Serve<I, S> {
@@ -53,6 +53,18 @@ pub struct Serve<I, S> {
protocol: Http, protocol: Http,
} }
/// A future binding a `Service` to a `Connection`.
///
/// Wraps the future returned from `NewService` into one that returns
/// a `Connection`.
#[must_use = "futures do nothing unless polled"]
#[derive(Debug)]
pub struct Connecting<I, F> {
future: F,
io: Option<I>,
protocol: Http,
}
#[must_use = "futures do nothing unless polled"] #[must_use = "futures do nothing unless polled"]
#[derive(Debug)] #[derive(Debug)]
pub(super) struct SpawnAll<I, S> { pub(super) struct SpawnAll<I, S> {
@@ -65,20 +77,19 @@ pub(super) struct SpawnAll<I, S> {
#[must_use = "futures do nothing unless polled"] #[must_use = "futures do nothing unless polled"]
pub struct Connection<I, S> pub struct Connection<I, S>
where where
S: HyperService, S: Service,
S::ResponseBody: Payload,
{ {
pub(super) conn: Either< pub(super) conn: Either<
proto::h1::Dispatcher< proto::h1::Dispatcher<
proto::h1::dispatch::Server<S>, proto::h1::dispatch::Server<S>,
S::ResponseBody, S::ResBody,
I, I,
proto::ServerTransaction, proto::ServerTransaction,
>, >,
proto::h2::Server< proto::h2::Server<
I, I,
S, S,
S::ResponseBody, S::ResBody,
>, >,
>, >,
} }
@@ -163,7 +174,7 @@ impl Http {
self self
} }
/// Bind a connection together with a `Service`. /// Bind a connection together with a [`Service`](::service::Service).
/// ///
/// This returns a Future that must be polled in order for HTTP to be /// This returns a Future that must be polled in order for HTTP to be
/// driven on the connection. /// driven on the connection.
@@ -177,14 +188,14 @@ impl Http {
/// # extern crate tokio_io; /// # extern crate tokio_io;
/// # use futures::Future; /// # use futures::Future;
/// # use hyper::{Body, Request, Response}; /// # use hyper::{Body, Request, Response};
/// # use hyper::server::Service; /// # use hyper::service::Service;
/// # use hyper::server::conn::Http; /// # use hyper::server::conn::Http;
/// # use tokio_io::{AsyncRead, AsyncWrite}; /// # use tokio_io::{AsyncRead, AsyncWrite};
/// # use tokio::reactor::Handle; /// # use tokio::reactor::Handle;
/// # fn run<I, S>(some_io: I, some_service: S) /// # fn run<I, S>(some_io: I, some_service: S)
/// # where /// # where
/// # I: AsyncRead + AsyncWrite + Send + 'static, /// # I: AsyncRead + AsyncWrite + Send + 'static,
/// # S: Service<Request=Request<Body>, Response=Response<Body>, Error=hyper::Error> + Send + 'static, /// # S: Service<ReqBody=Body, ResBody=Body> + Send + 'static,
/// # S::Future: Send /// # S::Future: Send
/// # { /// # {
/// let http = Http::new(); /// let http = Http::new();
@@ -200,7 +211,7 @@ impl Http {
/// ``` /// ```
pub fn serve_connection<S, I, Bd>(&self, io: I, service: S) -> Connection<I, S> pub fn serve_connection<S, I, Bd>(&self, io: I, service: S) -> Connection<I, S>
where where
S: Service<Request = Request<Body>, Response = Response<Bd>>, S: Service<ReqBody=Body, ResBody=Bd>,
S::Error: Into<Box<::std::error::Error + Send + Sync>>, S::Error: Into<Box<::std::error::Error + Send + Sync>>,
S::Future: Send + 'static, S::Future: Send + 'static,
Bd: Payload, Bd: Payload,
@@ -235,7 +246,7 @@ impl Http {
/// connection. /// connection.
pub fn serve_addr<S, Bd>(&self, addr: &SocketAddr, new_service: S) -> ::Result<Serve<AddrIncoming, S>> pub fn serve_addr<S, Bd>(&self, addr: &SocketAddr, new_service: S) -> ::Result<Serve<AddrIncoming, S>>
where where
S: NewService<Request=Request<Body>, Response=Response<Bd>>, S: NewService<ReqBody=Body, ResBody=Bd>,
S::Error: Into<Box<::std::error::Error + Send + Sync>>, S::Error: Into<Box<::std::error::Error + Send + Sync>>,
Bd: Payload, Bd: Payload,
{ {
@@ -254,7 +265,7 @@ impl Http {
/// connection. /// connection.
pub fn serve_addr_handle<S, Bd>(&self, addr: &SocketAddr, handle: &Handle, new_service: S) -> ::Result<Serve<AddrIncoming, S>> pub fn serve_addr_handle<S, Bd>(&self, addr: &SocketAddr, handle: &Handle, new_service: S) -> ::Result<Serve<AddrIncoming, S>>
where where
S: NewService<Request = Request<Body>, Response = Response<Bd>>, S: NewService<ReqBody=Body, ResBody=Bd>,
S::Error: Into<Box<::std::error::Error + Send + Sync>>, S::Error: Into<Box<::std::error::Error + Send + Sync>>,
Bd: Payload, Bd: Payload,
{ {
@@ -271,7 +282,7 @@ impl Http {
I: Stream, I: Stream,
I::Error: Into<Box<::std::error::Error + Send + Sync>>, I::Error: Into<Box<::std::error::Error + Send + Sync>>,
I::Item: AsyncRead + AsyncWrite, I::Item: AsyncRead + AsyncWrite,
S: NewService<Request = Request<Body>, Response = Response<Bd>>, S: NewService<ReqBody=Body, ResBody=Bd>,
S::Error: Into<Box<::std::error::Error + Send + Sync>>, S::Error: Into<Box<::std::error::Error + Send + Sync>>,
Bd: Payload, Bd: Payload,
{ {
@@ -288,7 +299,7 @@ impl Http {
impl<I, B, S> Connection<I, S> impl<I, B, S> Connection<I, S>
where where
S: Service<Request=Request<Body>, Response=Response<B>> + 'static, S: Service<ReqBody=Body, ResBody=B> + 'static,
S::Error: Into<Box<::std::error::Error + Send + Sync>>, S::Error: Into<Box<::std::error::Error + Send + Sync>>,
S::Future: Send, S::Future: Send,
I: AsyncRead + AsyncWrite + 'static, I: AsyncRead + AsyncWrite + 'static,
@@ -350,7 +361,7 @@ where
impl<I, B, S> Future for Connection<I, S> impl<I, B, S> Future for Connection<I, S>
where where
S: Service<Request=Request<Body>, Response=Response<B>> + 'static, S: Service<ReqBody=Body, ResBody=B> + 'static,
S::Error: Into<Box<::std::error::Error + Send + Sync>>, S::Error: Into<Box<::std::error::Error + Send + Sync>>,
S::Future: Send, S::Future: Send,
I: AsyncRead + AsyncWrite + 'static, I: AsyncRead + AsyncWrite + 'static,
@@ -366,8 +377,7 @@ where
impl<I, S> fmt::Debug for Connection<I, S> impl<I, S> fmt::Debug for Connection<I, S>
where where
S: HyperService, S: Service,
S::ResponseBody: Payload,
{ {
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result { fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
f.debug_struct("Connection") f.debug_struct("Connection")
@@ -403,24 +413,48 @@ where
I: Stream, I: Stream,
I::Item: AsyncRead + AsyncWrite, I::Item: AsyncRead + AsyncWrite,
I::Error: Into<Box<::std::error::Error + Send + Sync>>, I::Error: Into<Box<::std::error::Error + Send + Sync>>,
S: NewService<Request=Request<Body>, Response=Response<B>>, S: NewService<ReqBody=Body, ResBody=B>,
S::Error: Into<Box<::std::error::Error + Send + Sync>>, S::Error: Into<Box<::std::error::Error + Send + Sync>>,
<S::Instance as Service>::Future: Send + 'static, <S::Service as Service>::Future: Send + 'static,
B: Payload, B: Payload,
{ {
type Item = Connection<I::Item, S::Instance>; type Item = Connecting<I::Item, S::Future>;
type Error = ::Error; type Error = ::Error;
fn poll(&mut self) -> Poll<Option<Self::Item>, Self::Error> { fn poll(&mut self) -> Poll<Option<Self::Item>, Self::Error> {
if let Some(io) = try_ready!(self.incoming.poll().map_err(::Error::new_accept)) { if let Some(io) = try_ready!(self.incoming.poll().map_err(::Error::new_accept)) {
let service = self.new_service.new_service().map_err(::Error::new_user_new_service)?; let new_fut = self.new_service.new_service();
Ok(Async::Ready(Some(self.protocol.serve_connection(io, service)))) Ok(Async::Ready(Some(Connecting {
future: new_fut,
io: Some(io),
protocol: self.protocol.clone(),
})))
} else { } else {
Ok(Async::Ready(None)) Ok(Async::Ready(None))
} }
} }
} }
// ===== impl Connecting =====
impl<I, F, S, B> Future for Connecting<I, F>
where
I: AsyncRead + AsyncWrite,
F: Future<Item=S>,
S: Service<ReqBody=Body, ResBody=B>,
S::Future: Send + 'static,
B: Payload,
{
type Item = Connection<I, S>;
type Error = F::Error;
fn poll(&mut self) -> Poll<Self::Item, Self::Error> {
let service = try_ready!(self.future.poll());
let io = self.io.take().expect("polled after complete");
Ok(self.protocol.serve_connection(io, service).into())
}
}
// ===== impl SpawnAll ===== // ===== impl SpawnAll =====
impl<S> SpawnAll<AddrIncoming, S> { impl<S> SpawnAll<AddrIncoming, S> {
@@ -440,10 +474,11 @@ where
I: Stream, I: Stream,
I::Error: Into<Box<::std::error::Error + Send + Sync>>, I::Error: Into<Box<::std::error::Error + Send + Sync>>,
I::Item: AsyncRead + AsyncWrite + Send + 'static, I::Item: AsyncRead + AsyncWrite + Send + 'static,
S: NewService<Request = Request<Body>, Response = Response<B>> + Send + 'static, S: NewService<ReqBody=Body, ResBody=B> + Send + 'static,
S::Error: Into<Box<::std::error::Error + Send + Sync>>, S::Error: Into<Box<::std::error::Error + Send + Sync>>,
<S as NewService>::Instance: Send, S::Service: Send,
<<S as NewService>::Instance as Service>::Future: Send + 'static, S::Future: Send + 'static,
<S::Service as Service>::Future: Send + 'static,
B: Payload, B: Payload,
{ {
type Item = (); type Item = ();
@@ -451,8 +486,11 @@ where
fn poll(&mut self) -> Poll<Self::Item, Self::Error> { fn poll(&mut self) -> Poll<Self::Item, Self::Error> {
loop { loop {
if let Some(conn) = try_ready!(self.serve.poll()) { if let Some(connecting) = try_ready!(self.serve.poll()) {
let fut = conn let fut = connecting
.map_err(::Error::new_user_new_service)
// flatten basically
.and_then(|conn| conn)
.map_err(|err| debug!("conn error: {}", err)); .map_err(|err| debug!("conn error: {}", err));
self.serve.protocol.exec.execute(fut); self.serve.protocol.exec.execute(fut);
} else { } else {

132
src/server/mod.rs
View File

@@ -7,9 +7,47 @@
//! //!
//! - The higher-level [`Server`](Server). //! - The higher-level [`Server`](Server).
//! - The lower-level [conn](conn) module. //! - 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 [`NewService`](::service), and then should
//! be executed to start serving requests.
//!
//! ## Example
//!
//! ```no_run
//! extern crate futures;
//! extern crate hyper;
//! extern crate tokio;
//!
//! use futures::Future;
//! use hyper::{Body, Response, Server};
//! use hyper::service::service_fn_ok;
//!
//! fn main() {
//! // Construct our SocketAddr to listen on...
//! let addr = ([127, 0, 0, 1], 3000).into();
//!
//! // And a NewService to handle each connection...
//! let new_service = || {
//! service_fn_ok(|_req| {
//! Response::new(Body::from("Hello World"))
//! })
//! };
//!
//! // Then bind and serve...
//! let server = Server::bind(&addr)
//! .serve(new_service);
//!
//! // Finally, spawn `server` onto an Executor...
//! tokio::run(server.map_err(|e| {
//! eprintln!("server error: {}", e);
//! }));
//! }
//! ```
pub mod conn; pub mod conn;
mod service;
mod tcp; mod tcp;
use std::fmt; use std::fmt;
@@ -17,19 +55,16 @@ use std::net::SocketAddr;
use std::time::Duration; use std::time::Duration;
use futures::{Future, Stream, Poll}; use futures::{Future, Stream, Poll};
use http::{Request, Response};
use tokio_io::{AsyncRead, AsyncWrite}; use tokio_io::{AsyncRead, AsyncWrite};
pub use tokio_service::{NewService, Service};
use body::{Body, Payload}; use body::{Body, Payload};
use service::{NewService, Service};
// Renamed `Http` as `Http_` for now so that people upgrading don't see an // Renamed `Http` as `Http_` for now so that people upgrading don't see an
// error that `hyper::server::Http` is private... // error that `hyper::server::Http` is private...
use self::conn::{Http as Http_, SpawnAll}; use self::conn::{Http as Http_, SpawnAll};
use self::hyper_service::HyperService; //use self::hyper_service::HyperService;
use self::tcp::{AddrIncoming}; use self::tcp::{AddrIncoming};
pub use self::service::{const_service, service_fn};
/// A listening HTTP server. /// A listening HTTP server.
/// ///
/// `Server` is a `Future` mapping a bound listener with a set of service /// `Server` is a `Future` mapping a bound listener with a set of service
@@ -93,10 +128,11 @@ where
I: Stream, I: Stream,
I::Error: Into<Box<::std::error::Error + Send + Sync>>, I::Error: Into<Box<::std::error::Error + Send + Sync>>,
I::Item: AsyncRead + AsyncWrite + Send + 'static, I::Item: AsyncRead + AsyncWrite + Send + 'static,
S: NewService<Request = Request<Body>, Response = Response<B>> + Send + 'static, S: NewService<ReqBody=Body, ResBody=B> + Send + 'static,
S::Error: Into<Box<::std::error::Error + Send + Sync>>, S::Error: Into<Box<::std::error::Error + Send + Sync>>,
<S as NewService>::Instance: Send, S::Service: Send,
<<S as NewService>::Instance as Service>::Future: Send + 'static, S::Future: Send + 'static,
<S::Service as Service>::Future: Send + 'static,
B: Payload, B: Payload,
{ {
type Item = (); type Item = ();
@@ -137,15 +173,38 @@ impl<I> Builder<I> {
} }
/// Consume this `Builder`, creating a [`Server`](Server). /// Consume this `Builder`, creating a [`Server`](Server).
///
/// # Example
///
/// ```rust
/// use hyper::{Body, Response, Server};
/// use hyper::service::service_fn_ok;
///
/// // Construct our SocketAddr to listen on...
/// let addr = ([127, 0, 0, 1], 3000).into();
///
/// // And a NewService to handle each connection...
/// let new_service = || {
/// service_fn_ok(|_req| {
/// Response::new(Body::from("Hello World"))
/// })
/// };
///
/// // Then bind and serve...
/// let server = Server::bind(&addr)
/// .serve(new_service);
///
/// // Finally, spawn `server` onto an Executor...
/// ```
pub fn serve<S, B>(self, new_service: S) -> Server<I, S> pub fn serve<S, B>(self, new_service: S) -> Server<I, S>
where where
I: Stream, I: Stream,
I::Error: Into<Box<::std::error::Error + Send + Sync>>, I::Error: Into<Box<::std::error::Error + Send + Sync>>,
I::Item: AsyncRead + AsyncWrite + Send + 'static, I::Item: AsyncRead + AsyncWrite + Send + 'static,
S: NewService<Request = Request<Body>, Response = Response<B>>, S: NewService<ReqBody=Body, ResBody=B> + Send + 'static,
S::Error: Into<Box<::std::error::Error + Send + Sync>>, S::Error: Into<Box<::std::error::Error + Send + Sync>>,
<S as NewService>::Instance: Send, S::Service: Send,
<<S as NewService>::Instance as Service>::Future: Send + 'static, <S::Service as Service>::Future: Send + 'static,
B: Payload, B: Payload,
{ {
let serve = self.protocol.serve_incoming(self.incoming, new_service); let serve = self.protocol.serve_incoming(self.incoming, new_service);
@@ -174,52 +233,3 @@ impl Builder<AddrIncoming> {
} }
} }
mod hyper_service {
use super::{Body, Payload, Request, Response, Service};
/// A "trait alias" for any type that implements `Service` with hyper's
/// Request, Response, and Error types, and a streaming body.
///
/// There is an auto implementation inside hyper, so no one can actually
/// implement this trait. It simply exists to reduce the amount of generics
/// needed.
pub trait HyperService: Service + Sealed {
#[doc(hidden)]
type ResponseBody;
#[doc(hidden)]
type Sealed: Sealed2;
}
pub trait Sealed {}
pub trait Sealed2 {}
#[allow(missing_debug_implementations)]
pub struct Opaque {
_inner: (),
}
impl Sealed2 for Opaque {}
impl<S, B> Sealed for S
where
S: Service<
Request=Request<Body>,
Response=Response<B>,
>,
S::Error: Into<Box<::std::error::Error + Send + Sync>>,
B: Payload,
{}
impl<S, B> HyperService for S
where
S: Service<
Request=Request<Body>,
Response=Response<B>,
>,
S::Error: Into<Box<::std::error::Error + Send + Sync>>,
S: Sealed,
B: Payload,
{
type ResponseBody = B;
type Sealed = Opaque;
}
}

64
src/server/service.rs
View File

@@ -1,64 +0,0 @@
use std::marker::PhantomData;
use std::sync::Arc;
use futures::IntoFuture;
use tokio_service::{NewService, Service};
/// Create a `Service` from a function.
pub fn service_fn<F, R, S>(f: F) -> ServiceFn<F, R>
where
F: Fn(R) -> S,
S: IntoFuture,
{
ServiceFn {
f: f,
_req: PhantomData,
}
}
/// Create a `NewService` by sharing references of `service.
pub fn const_service<S>(service: S) -> ConstService<S> {
ConstService {
svc: Arc::new(service),
}
}
#[derive(Debug)]
pub struct ServiceFn<F, R> {
f: F,
_req: PhantomData<fn() -> R>,
}
impl<F, R, S> Service for ServiceFn<F, R>
where
F: Fn(R) -> S,
S: IntoFuture,
{
type Request = R;
type Response = S::Item;
type Error = S::Error;
type Future = S::Future;
fn call(&self, req: Self::Request) -> Self::Future {
(self.f)(req).into_future()
}
}
#[derive(Debug)]
pub struct ConstService<S> {
svc: Arc<S>,
}
impl<S> NewService for ConstService<S>
where
S: Service,
{
type Request = S::Request;
type Response = S::Response;
type Error = S::Error;
type Instance = Arc<S>;
fn new_service(&self) -> ::std::io::Result<Self::Instance> {
Ok(self.svc.clone())
}
}

35
src/service/mod.rs Normal file
View File

@@ -0,0 +1,35 @@
//! Services and NewServices
//!
//! - A [`Service`](Service) is a trait representing an asynchronous function
//! of a request to a response. It's similar to
//! `async fn(Request) -> Result<Response, Error>`.
//! - A [`NewService`](NewService) is a trait creating specific instances of a
//! `Service`.
//!
//! These types are conceptually similar to those in
//! [tower](https://crates.io/crates/tower), while being specific to hyper.
//!
//! # Service
//!
//! In hyper, especially in the server setting, a `Service` is usually bound
//! to a single connection. It defines how to respond to **all** requests that
//! connection will receive.
//!
//! While it's possible to implement `Service` for a type manually, the helpers
//! [`service_fn`](service_fn) and [`service_fn_ok`](service_fn_ok) should be
//! sufficient for most cases.
//!
//! # NewService
//!
//! Since a `Service` is bound to a single connection, a [`Server`](::Server)
//! needs a way to make them as it accepts connections. This is what a
//! `NewService` does.
//!
//! Resources that need to be shared by all `Service`s can be put into a
//! `NewService`, and then passed to individual `Service`s when `new_service`
//! is called.
mod new_service;
mod service;
pub use self::new_service::{NewService};
pub use self::service::{service_fn, service_fn_ok, Service};

55
src/service/new_service.rs Normal file
View File

@@ -0,0 +1,55 @@
use std::error::Error as StdError;
use futures::{Future, IntoFuture};
use body::Payload;
use super::Service;
/// An asynchronous constructor of `Service`s.
pub trait NewService {
/// The `Payload` body of the `http::Request`.
type ReqBody: Payload;
/// The `Payload` body of the `http::Response`.
type ResBody: Payload;
/// The error type that can be returned by `Service`s.
type Error: Into<Box<StdError + Send + Sync>>;
/// The resolved `Service` from `new_service()`.
type Service: Service<
ReqBody=Self::ReqBody,
ResBody=Self::ResBody,
Error=Self::Error,
>;
/// The future returned from `new_service` of a `Service`.
type Future: Future<Item=Self::Service, Error=Self::InitError>;
/// The error type that can be returned when creating a new `Service.
type InitError: Into<Box<StdError + Send + Sync>>;
/// Create a new `Service`.
fn new_service(&self) -> Self::Future;
}
impl<F, R, S> NewService for F
where
F: Fn() -> R,
R: IntoFuture<Item=S>,
R::Error: Into<Box<StdError + Send + Sync>>,
S: Service,
{
type ReqBody = S::ReqBody;
type ResBody = S::ResBody;
type Error = S::Error;
type Service = S;
type Future = R::Future;
type InitError = R::Error;
fn new_service(&self) -> Self::Future {
(*self)().into_future()
}
}

165
src/service/service.rs Normal file
View File

@@ -0,0 +1,165 @@
use std::error::Error as StdError;
use std::fmt;
use std::marker::PhantomData;
use futures::{future, Future, IntoFuture};
use body::Payload;
use common::Never;
use ::{Request, Response};
/// An asynchronous function from `Request` to `Response`.
pub trait Service {
/// The `Payload` body of the `http::Request`.
type ReqBody: Payload;
/// The `Payload` body of the `http::Response`.
type ResBody: Payload;
/// The error type that can occur within this `Service.
///
/// Note: Returning an `Error` to a hyper server will cause the connection
/// to be abruptly aborted. In most cases, it is better to return a `Response`
/// with a 4xx or 5xx status code.
type Error: Into<Box<StdError + Send + Sync>>;
/// The `Future` returned by this `Service`.
type Future: Future<Item=Response<Self::ResBody>, Error=Self::Error>;
/// Calls this `Service` with a request, returning a `Future` of the response.
fn call(&mut self, req: Request<Self::ReqBody>) -> Self::Future;
}
/// Create a `Service` from a function.
///
/// # Example
///
/// ```rust
/// use hyper::{Body, Request, Response, Version};
/// use hyper::service::service_fn;
///
/// let service = service_fn(|req: Request<Body>| {
/// if req.version() == Version::HTTP_11 {
/// Ok(Response::new(Body::from("Hello World")))
/// } else {
/// // Note: it's usually better to return a Response
/// // with an appropriate StatusCode instead of an Err.
/// Err("not HTTP/1.1, abort connection")
/// }
/// });
/// ```
pub fn service_fn<F, R, S>(f: F) -> ServiceFn<F, R>
where
F: FnMut(Request<R>) -> S,
S: IntoFuture,
{
ServiceFn {
f,
_req: PhantomData,
}
}
/// Create a `Service` from a function that never errors.
///
/// # Example
///
/// ```rust
/// use hyper::{Body, Request, Response};
/// use hyper::service::service_fn_ok;
///
/// let service = service_fn_ok(|req: Request<Body>| {
/// println!("request: {} {}", req.method(), req.uri());
/// Response::new(Body::from("Hello World"))
/// });
/// ```
pub fn service_fn_ok<F, R, S>(f: F) -> ServiceFnOk<F, R>
where
F: FnMut(Request<R>) -> Response<S>,
S: Payload,
{
ServiceFnOk {
f,
_req: PhantomData,
}
}
// Not exported from crate as this will likely be replaced with `impl Service`.
pub struct ServiceFn<F, R> {
f: F,
_req: PhantomData<fn(R)>,
}
impl<F, ReqBody, Ret, ResBody> Service for ServiceFn<F, ReqBody>
where
F: FnMut(Request<ReqBody>) -> Ret,
ReqBody: Payload,
Ret: IntoFuture<Item=Response<ResBody>>,
Ret::Error: Into<Box<StdError + Send + Sync>>,
ResBody: Payload,
{
type ReqBody = ReqBody;
type ResBody = ResBody;
type Error = Ret::Error;
type Future = Ret::Future;
fn call(&mut self, req: Request<Self::ReqBody>) -> Self::Future {
(self.f)(req).into_future()
}
}
impl<F, R> IntoFuture for ServiceFn<F, R> {
type Future = future::FutureResult<Self::Item, Self::Error>;
type Item = Self;
type Error = Never;
fn into_future(self) -> Self::Future {
future::ok(self)
}
}
impl<F, R> fmt::Debug for ServiceFn<F, R> {
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
f.debug_struct("impl Service")
.finish()
}
}
// Not exported from crate as this will likely be replaced with `impl Service`.
pub struct ServiceFnOk<F, R> {
f: F,
_req: PhantomData<fn(R)>,
}
impl<F, ReqBody, ResBody> Service for ServiceFnOk<F, ReqBody>
where
F: FnMut(Request<ReqBody>) -> Response<ResBody>,
ReqBody: Payload,
ResBody: Payload,
{
type ReqBody = ReqBody;
type ResBody = ResBody;
type Error = Never;
type Future = future::FutureResult<Response<ResBody>, Never>;
fn call(&mut self, req: Request<Self::ReqBody>) -> Self::Future {
future::ok((self.f)(req))
}
}
impl<F, R> IntoFuture for ServiceFnOk<F, R> {
type Future = future::FutureResult<Self::Item, Self::Error>;
type Item = Self;
type Error = Never;
fn into_future(self) -> Self::Future {
future::ok(self)
}
}
impl<F, R> fmt::Debug for ServiceFnOk<F, R> {
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
f.debug_struct("impl Service")
.finish()
}
}

80
tests/server.rs
View File

@@ -31,8 +31,8 @@ use tokio_io::{AsyncRead, AsyncWrite};
use hyper::{Body, Request, Response, StatusCode}; use hyper::{Body, Request, Response, StatusCode};
use hyper::server::{Service, NewService, service_fn};
use hyper::server::conn::Http; use hyper::server::conn::Http;
use hyper::service::{service_fn, Service};
fn tcp_bind(addr: &SocketAddr, handle: &Handle) -> ::tokio::io::Result<TcpListener> { fn tcp_bind(addr: &SocketAddr, handle: &Handle) -> ::tokio::io::Result<TcpListener> {
let std_listener = StdTcpListener::bind(addr).unwrap(); let std_listener = StdTcpListener::bind(addr).unwrap();
@@ -95,28 +95,17 @@ fn get_implicitly_empty() {
.map_err(|_| unreachable!()) .map_err(|_| unreachable!())
.and_then(|(item, _incoming)| { .and_then(|(item, _incoming)| {
let socket = item.unwrap(); let socket = item.unwrap();
Http::new().serve_connection(socket, GetImplicitlyEmpty) Http::new().serve_connection(socket, service_fn(|req: Request<Body>| {
req.into_body()
.concat2()
.map(|buf| {
assert!(buf.is_empty());
Response::new(Body::empty())
})
}))
}); });
fut.wait().unwrap(); fut.wait().unwrap();
struct GetImplicitlyEmpty;
impl Service for GetImplicitlyEmpty {
type Request = Request<Body>;
type Response = Response<Body>;
type Error = hyper::Error;
type Future = Box<Future<Item=Self::Response, Error=Self::Error> + Send>;
fn call(&self, req: Request<Body>) -> Self::Future {
Box::new(req.into_body()
.concat2()
.map(|buf| {
assert!(buf.is_empty());
Response::new(Body::empty())
}))
}
}
} }
mod response_body_lengths { mod response_body_lengths {
@@ -1258,24 +1247,9 @@ enum Msg {
End, End,
} }
impl NewService for TestService { impl TestService {
type Request = Request<Body>; // Box is needed until we can return `impl Future` from a fn
type Response = Response<Body>; fn call(&self, req: Request<Body>) -> Box<Future<Item=Response<Body>, Error=hyper::Error> + Send> {
type Error = hyper::Error;
type Instance = TestService;
fn new_service(&self) -> std::io::Result<TestService> {
Ok(self.clone())
}
}
impl Service for TestService {
type Request = Request<Body>;
type Response = Response<Body>;
type Error = hyper::Error;
type Future = Box<Future<Item=Response<Body>, Error=hyper::Error> + Send>;
fn call(&self, req: Request<Body>) -> Self::Future {
let tx1 = self.tx.clone(); let tx1 = self.tx.clone();
let tx2 = self.tx.clone(); let tx2 = self.tx.clone();
@@ -1309,7 +1283,6 @@ impl Service for TestService {
res res
})) }))
} }
} }
const HELLO: &'static str = "hello"; const HELLO: &'static str = "hello";
@@ -1317,12 +1290,12 @@ const HELLO: &'static str = "hello";
struct HelloWorld; struct HelloWorld;
impl Service for HelloWorld { impl Service for HelloWorld {
type Request = Request<Body>; type ReqBody = Body;
type Response = Response<Body>; type ResBody = Body;
type Error = hyper::Error; type Error = hyper::Error;
type Future = FutureResult<Self::Response, Self::Error>; type Future = FutureResult<Response<Body>, Self::Error>;
fn call(&self, _req: Request<Body>) -> Self::Future { fn call(&mut self, _req: Request<Body>) -> Self::Future {
let response = Response::new(HELLO.into()); let response = Response::new(HELLO.into());
future::ok(response) future::ok(response)
} }
@@ -1376,10 +1349,13 @@ fn serve_with_options(options: ServeOptions) -> Serve {
let serve = Http::new() let serve = Http::new()
.keep_alive(keep_alive) .keep_alive(keep_alive)
.pipeline_flush(pipeline) .pipeline_flush(pipeline)
.serve_addr(&addr, TestService { .serve_addr(&addr, move || {
tx: Arc::new(Mutex::new(msg_tx.clone())), let ts = TestService {
_timeout: dur, tx: Arc::new(Mutex::new(msg_tx.clone())),
reply: reply_rx, _timeout: dur,
reply: reply_rx.clone(),
};
service_fn(move |req| ts.call(req))
}) })
.expect("bind to address"); .expect("bind to address");
@@ -1390,10 +1366,12 @@ fn serve_with_options(options: ServeOptions) -> Serve {
).expect("server addr tx"); ).expect("server addr tx");
// spawn_all() is private for now, so just duplicate it here // spawn_all() is private for now, so just duplicate it here
let spawn_all = serve.for_each(|conn| { let spawn_all = serve.for_each(|connecting| {
tokio::spawn(conn.map_err(|e| { let fut = connecting
println!("server error: {}", e); .map_err(|never| -> hyper::Error { match never {} })
})); .flatten()
.map_err(|e| println!("server error: {}", e));
tokio::spawn(fut);
Ok(()) Ok(())
}).map_err(|e| { }).map_err(|e| {
println!("accept error: {}", e) println!("accept error: {}", e)

69
tests/support/mod.rs
View File

@@ -187,7 +187,7 @@ pub fn __run_test(cfg: __TestConfig) {
extern crate pretty_env_logger; extern crate pretty_env_logger;
use hyper::{Body, Client, Request, Response}; use hyper::{Body, Client, Request, Response};
use hyper::client::HttpConnector; use hyper::client::HttpConnector;
use std::sync::Arc; use std::sync::{Arc, Mutex};
let _ = pretty_env_logger::try_init(); let _ = pretty_env_logger::try_init();
let rt = Runtime::new().expect("new rt"); let rt = Runtime::new().expect("new rt");
let handle = rt.reactor().clone(); let handle = rt.reactor().clone();
@@ -198,37 +198,40 @@ pub fn __run_test(cfg: __TestConfig) {
.executor(rt.executor()) .executor(rt.executor())
.build::<_, Body>(connector); .build::<_, Body>(connector);
let serve_handles = ::std::sync::Mutex::new( let serve_handles = Arc::new(Mutex::new(
cfg.server_msgs cfg.server_msgs
); ));
let service = hyper::server::service_fn(move |req: Request<Body>| -> Box<Future<Item=Response<Body>, Error=hyper::Error> + Send> { let new_service = move || {
let (sreq, sres) = serve_handles.lock() // Move a clone into the service_fn
.unwrap() let serve_handles = serve_handles.clone();
.remove(0); hyper::service::service_fn(move |req: Request<Body>| {
let (sreq, sres) = serve_handles.lock()
.unwrap()
.remove(0);
assert_eq!(req.uri().path(), sreq.uri); assert_eq!(req.uri().path(), sreq.uri);
assert_eq!(req.method(), &sreq.method); assert_eq!(req.method(), &sreq.method);
for (name, value) in &sreq.headers { for (name, value) in &sreq.headers {
assert_eq!( assert_eq!(
req.headers()[name], req.headers()[name],
value value
); );
} }
let sbody = sreq.body; let sbody = sreq.body;
Box::new(req.into_body() req.into_body()
.concat2() .concat2()
.map(move |body| { .map(move |body| {
assert_eq!(body.as_ref(), sbody.as_slice()); assert_eq!(body.as_ref(), sbody.as_slice());
let mut res = Response::builder() let mut res = Response::builder()
.status(sres.status) .status(sres.status)
.body(sres.body.into()) .body(Body::from(sres.body))
.expect("Response::build"); .expect("Response::build");
*res.headers_mut() = sres.headers; *res.headers_mut() = sres.headers;
res res
})) })
}); })
let new_service = hyper::server::const_service(service); };
let serve = hyper::server::conn::Http::new() let serve = hyper::server::conn::Http::new()
.http2_only(cfg.server_version == 2) .http2_only(cfg.server_version == 2)
@@ -246,8 +249,12 @@ pub fn __run_test(cfg: __TestConfig) {
let (success_tx, success_rx) = oneshot::channel(); let (success_tx, success_rx) = oneshot::channel();
let expected_connections = cfg.connections; let expected_connections = cfg.connections;
let server = serve let server = serve
.fold(0, move |cnt, conn| { .fold(0, move |cnt, connecting| {
exe.spawn(conn.map_err(|e| panic!("server connection error: {}", e))); let fut = connecting
.map_err(|never| -> hyper::Error { match never {} })
.flatten()
.map_err(|e| panic!("server connection error: {}", e));
exe.spawn(fut);
Ok::<_, hyper::Error>(cnt + 1) Ok::<_, hyper::Error>(cnt + 1)
}) })
.map(move |cnt| { .map(move |cnt| {