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

use crate::result;
use crate::server::req::ServerRequest;
use crate::ServerResponse;
use tokio::runtime::Handle;

pub struct ServerHandlerContext {
    pub(crate) loop_handle: Handle,
}

impl ServerHandlerContext {
    // TODO: provide access to executor if there's any
    pub fn loop_remote(&self) -> Handle {
        self.loop_handle.clone()
    }
}

/// Central HTTP/2 service interface.
///
/// This trait can be implemented by handler provided by user.
pub trait ServerHandler: Send + Sync + 'static {
    /// Start HTTP/2 request.
    ///
    /// `headers` param specifies initial request headers.
    /// `req` param contains asynchronous stream of request content,
    /// stream of zero or more `DATA` frames followed by optional
    /// trailer `HEADERS` frame.
    fn start_request(
        &self,
        context: ServerHandlerContext,
        req: ServerRequest,
        resp: ServerResponse,
    ) -> result::Result<()>;
}