**The `Error` is now an opaque struct**, which allows for more variants to be added freely, and the internal representation to change without being breaking changes. For inspecting an `Error`, there are several `is_*` methods to check for certain classes of errors, such as `Error::is_parse()`. The `cause` can also be inspected, like before. This likely seems like a downgrade, but more inspection can be added as needed! The `Error` now knows about more states, which gives much more context around when a certain error occurs. This is also expressed in the description and `fmt` messages. **Most places where a user would provide an error to hyper can now pass any error type** (`E: Into<Box<std::error::Error>>`). This error is passed back in relevant places, and can be useful for logging. This should make it much clearer about what error a user should provide to hyper: any it feels is relevant! Closes #1128 Closes #1130 Closes #1431 Closes #1338 BREAKING CHANGE: `Error` is no longer an enum to pattern match over, or to construct. Code will need to be updated accordingly. For body streams or `Service`s, inference might be unable to determine what error type you mean to return. Starting in Rust 1.26, you could just label that as `!` if you never return an error.
		
			
				
	
	
		
			149 lines
		
	
	
		
			5.6 KiB
		
	
	
	
		
			Rust
		
	
	
	
	
	
			
		
		
	
	
			149 lines
		
	
	
		
			5.6 KiB
		
	
	
	
		
			Rust
		
	
	
	
	
	
| #![deny(warnings)]
 | |
| extern crate futures;
 | |
| extern crate hyper;
 | |
| extern crate pretty_env_logger;
 | |
| extern crate tokio;
 | |
| 
 | |
| use futures::{Future/*, Sink*/};
 | |
| use futures::future::lazy;
 | |
| use futures::sync::oneshot;
 | |
| 
 | |
| use hyper::{Body, /*Chunk,*/ Method, Request, Response, StatusCode};
 | |
| use hyper::server::{Http, Service};
 | |
| 
 | |
| use std::fs::File;
 | |
| use std::io::{self, copy/*, Read*/};
 | |
| use std::thread;
 | |
| 
 | |
| static NOTFOUND: &[u8] = b"Not Found";
 | |
| static INDEX: &str = "examples/send_file_index.html";
 | |
| 
 | |
| fn simple_file_send(f: &str) -> Box<Future<Item = Response<Body>, Error = io::Error> + Send> {
 | |
|     // Serve a file by reading it entirely into memory. As a result
 | |
|     // this is limited to serving small files, but it is somewhat
 | |
|     // simpler with a little less overhead.
 | |
|     //
 | |
|     // On channel errors, we panic with the expect method. The thread
 | |
|     // ends at that point in any case.
 | |
|     let filename = f.to_string(); // we need to copy for lifetime issues
 | |
|     let (tx, rx) = oneshot::channel();
 | |
|     thread::spawn(move || {
 | |
|         let mut file = match File::open(filename) {
 | |
|             Ok(f) => f,
 | |
|             Err(_) => {
 | |
|                 tx.send(Response::builder()
 | |
|                         .status(StatusCode::NOT_FOUND)
 | |
|                         .body(NOTFOUND.into())
 | |
|                         .unwrap())
 | |
|                     .expect("Send error on open");
 | |
|                 return;
 | |
|             },
 | |
|         };
 | |
|         let mut buf: Vec<u8> = Vec::new();
 | |
|         match copy(&mut file, &mut buf) {
 | |
|             Ok(_) => {
 | |
|                 let res = Response::new(buf.into());
 | |
|                 tx.send(res).expect("Send error on successful file read");
 | |
|             },
 | |
|             Err(_) => {
 | |
|                 tx.send(Response::builder()
 | |
|                         .status(StatusCode::INTERNAL_SERVER_ERROR)
 | |
|                         .body(Body::empty())
 | |
|                         .unwrap())
 | |
|                     .expect("Send error on error reading file");
 | |
|             },
 | |
|         };
 | |
|     });
 | |
| 
 | |
|     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();
 | |
| 
 | |
|     tokio::run(lazy(move || {
 | |
|         let server = Http::new().bind(&addr, || Ok(ResponseExamples)).unwrap();
 | |
|         println!("Listening on http://{} with 1 thread.", server.local_addr().unwrap());
 | |
|         server.run().map_err(|err| eprintln!("Server error {}", err))
 | |
|     }));
 | |
| }
 |