use std::{ cmp, error::Error as StdError, future::Future, marker::PhantomData, net, pin::Pin, rc::Rc, task::{Context, Poll}, }; use actix_codec::{AsyncRead, AsyncWrite}; use actix_rt::time::{sleep, Sleep}; use actix_service::Service; use actix_utils::future::poll_fn; use bytes::{Bytes, BytesMut}; use futures_core::ready; use h2::{ server::{Connection, SendResponse}, Ping, PingPong, }; use pin_project_lite::pin_project; use tracing::{error, trace, warn}; use crate::{ body::{BodySize, BoxBody, MessageBody}, config::ServiceConfig, header::{ HeaderName, HeaderValue, CONNECTION, CONTENT_LENGTH, DATE, TRANSFER_ENCODING, UPGRADE, }, service::HttpFlow, Extensions, OnConnectData, Payload, Request, Response, ResponseHead, }; const CHUNK_SIZE: usize = 16_384; pin_project! { /// Dispatcher for HTTP/2 protocol. pub struct Dispatcher { flow: Rc>, connection: Connection, conn_data: Option>, config: ServiceConfig, peer_addr: Option, ping_pong: Option, _phantom: PhantomData } } impl Dispatcher where T: AsyncRead + AsyncWrite + Unpin, { pub(crate) fn new( mut conn: Connection, flow: Rc>, config: ServiceConfig, peer_addr: Option, conn_data: OnConnectData, timer: Option>>, ) -> Self { let ping_pong = config.keep_alive().duration().map(|dur| H2PingPong { timer: timer .map(|mut timer| { // reuse timer slot if it was initialized for handshake timer.as_mut().reset((config.now() + dur).into()); timer }) .unwrap_or_else(|| Box::pin(sleep(dur))), on_flight: false, ping_pong: conn.ping_pong().unwrap(), }); Self { flow, config, peer_addr, connection: conn, conn_data: conn_data.0.map(Rc::new), ping_pong, _phantom: PhantomData, } } } struct H2PingPong { timer: Pin>, on_flight: bool, ping_pong: PingPong, } impl Future for Dispatcher where T: AsyncRead + AsyncWrite + Unpin, S: Service, S::Error: Into>, S::Future: 'static, S::Response: Into>, B: MessageBody, { type Output = Result<(), crate::error::DispatchError>; #[inline] fn poll(self: Pin<&mut Self>, cx: &mut Context<'_>) -> Poll { let this = self.get_mut(); loop { match Pin::new(&mut this.connection).poll_accept(cx)? { Poll::Ready(Some((req, tx))) => { let (parts, body) = req.into_parts(); let payload = crate::h2::Payload::new(body); let pl = Payload::H2 { payload }; let mut req = Request::with_payload(pl); let head = req.head_mut(); head.uri = parts.uri; head.method = parts.method; head.version = parts.version; head.headers = parts.headers.into(); head.peer_addr = this.peer_addr; req.conn_data = this.conn_data.as_ref().map(Rc::clone); let fut = this.flow.service.call(req); let config = this.config.clone(); // multiplex request handling with spawn task actix_rt::spawn(async move { // resolve service call and send response. let res = match fut.await { Ok(res) => handle_response(res.into(), tx, config).await, Err(err) => { let res: Response = err.into(); handle_response(res, tx, config).await } }; // log error. if let Err(err) = res { match err { DispatchError::SendResponse(err) => { trace!("Error sending HTTP/2 response: {:?}", err) } DispatchError::SendData(err) => warn!("{:?}", err), DispatchError::ResponseBody(err) => { error!("Response payload stream error: {:?}", err) } } } }); } Poll::Ready(None) => return Poll::Ready(Ok(())), Poll::Pending => match this.ping_pong.as_mut() { Some(ping_pong) => loop { if ping_pong.on_flight { // When have on flight ping pong. poll pong and and keep alive timer. // on success pong received update keep alive timer to determine the next timing of // ping pong. match ping_pong.ping_pong.poll_pong(cx)? { Poll::Ready(_) => { ping_pong.on_flight = false; let dead_line = this.config.keep_alive_deadline().unwrap(); ping_pong.timer.as_mut().reset(dead_line.into()); } Poll::Pending => { return ping_pong.timer.as_mut().poll(cx).map(|_| Ok(())) } } } else { // When there is no on flight ping pong. keep alive timer is used to wait for next // timing of ping pong. Therefore at this point it serves as an interval instead. ready!(ping_pong.timer.as_mut().poll(cx)); ping_pong.ping_pong.send_ping(Ping::opaque())?; let dead_line = this.config.keep_alive_deadline().unwrap(); ping_pong.timer.as_mut().reset(dead_line.into()); ping_pong.on_flight = true; } }, None => return Poll::Pending, }, } } } } enum DispatchError { SendResponse(h2::Error), SendData(h2::Error), ResponseBody(Box), } async fn handle_response( res: Response, mut tx: SendResponse, config: ServiceConfig, ) -> Result<(), DispatchError> where B: MessageBody, { let (res, body) = res.replace_body(()); // prepare response. let mut size = body.size(); let res = prepare_response(config, res.head(), &mut size); let eof = size.is_eof(); // send response head and return on eof. let mut stream = tx .send_response(res, eof) .map_err(DispatchError::SendResponse)?; if eof { return Ok(()); } // poll response body and send chunks to client actix_rt::pin!(body); while let Some(res) = poll_fn(|cx| body.as_mut().poll_next(cx)).await { let mut chunk = res.map_err(|err| DispatchError::ResponseBody(err.into()))?; 'send: loop { let chunk_size = cmp::min(chunk.len(), CHUNK_SIZE); // reserve enough space and wait for stream ready. stream.reserve_capacity(chunk_size); match poll_fn(|cx| stream.poll_capacity(cx)).await { // No capacity left. drop body and return. None => return Ok(()), Some(Err(err)) => return Err(DispatchError::SendData(err)), Some(Ok(cap)) => { // split chunk to writeable size and send to client let len = chunk.len(); let bytes = chunk.split_to(cmp::min(len, cap)); stream .send_data(bytes, false) .map_err(DispatchError::SendData)?; // Current chuck completely sent. break send loop and poll next one. if chunk.is_empty() { break 'send; } } } } } // response body streaming finished. send end of stream and return. stream .send_data(Bytes::new(), true) .map_err(DispatchError::SendData)?; Ok(()) } fn prepare_response( config: ServiceConfig, head: &ResponseHead, size: &mut BodySize, ) -> http::Response<()> { let mut has_date = false; let mut skip_len = size != &BodySize::Stream; let mut res = http::Response::new(()); *res.status_mut() = head.status; *res.version_mut() = http::Version::HTTP_2; // Content length match head.status { http::StatusCode::NO_CONTENT | http::StatusCode::CONTINUE | http::StatusCode::PROCESSING => *size = BodySize::None, http::StatusCode::SWITCHING_PROTOCOLS => { skip_len = true; *size = BodySize::Stream; } _ => {} } let _ = match size { BodySize::None | BodySize::Stream => None, BodySize::Sized(0) => { #[allow(clippy::declare_interior_mutable_const)] const HV_ZERO: HeaderValue = HeaderValue::from_static("0"); res.headers_mut().insert(CONTENT_LENGTH, HV_ZERO) } BodySize::Sized(len) => { let mut buf = itoa::Buffer::new(); res.headers_mut().insert( CONTENT_LENGTH, HeaderValue::from_str(buf.format(*len)).unwrap(), ) } }; // copy headers for (key, value) in head.headers.iter() { match key { // omit HTTP/1.x only headers according to: // https://datatracker.ietf.org/doc/html/rfc7540#section-8.1.2.2 &CONNECTION | &TRANSFER_ENCODING | &UPGRADE => continue, &CONTENT_LENGTH if skip_len => continue, &DATE => has_date = true, // omit HTTP/1.x only headers according to: // https://datatracker.ietf.org/doc/html/rfc7540#section-8.1.2.2 hdr if hdr == HeaderName::from_static("keep-alive") || hdr == HeaderName::from_static("proxy-connection") => { continue } _ => {} } res.headers_mut().append(key, value.clone()); } // set date header if !has_date { let mut bytes = BytesMut::with_capacity(29); config.write_date_header_value(&mut bytes); res.headers_mut().insert( DATE, // SAFETY: serialized date-times are known ASCII strings unsafe { HeaderValue::from_maybe_shared_unchecked(bytes.freeze()) }, ); } res }