[−][src]Struct hyper::server::conn::Http
A lower-level configuration of the HTTP protocol.
This structure is used to configure options for an HTTP server connection.
If you don't have need to manage connections yourself, consider using the higher-level Server API.
Methods
impl Http
[src]
pub fn new() -> Http
[src]
Creates a new instance of the HTTP protocol, ready to spawn a server or start accepting connections.
impl<E> Http<E>
[src]
pub fn http1_only(&mut self, val: bool) -> &mut Self
[src]
Sets whether HTTP1 is required.
Default is false
pub fn http1_half_close(&mut self, val: bool) -> &mut Self
[src]
Set whether HTTP/1 connections should support half-closures.
Clients can chose to shutdown their write-side while waiting
for the server to respond. Setting this to false
will
automatically close any connection immediately if read
detects an EOF.
Default is true
.
pub fn http1_writev(&mut self, val: bool) -> &mut Self
[src]
Set whether HTTP/1 connections should try to use vectored writes, or always flatten into a single buffer.
Note that setting this to false may mean more copies of body data, but may also improve performance when an IO transport doesn't support vectored writes well, such as most TLS implementations.
Default is true
.
pub fn http2_only(&mut self, val: bool) -> &mut Self
[src]
Sets whether HTTP2 is required.
Default is false
pub fn http2_initial_stream_window_size(
&mut self,
sz: impl Into<Option<u32>>
) -> &mut Self
[src]
&mut self,
sz: impl Into<Option<u32>>
) -> &mut Self
Sets the SETTINGS_INITIAL_WINDOW_SIZE
option for HTTP2
stream-level flow control.
Default is 65,535
pub fn http2_initial_connection_window_size(
&mut self,
sz: impl Into<Option<u32>>
) -> &mut Self
[src]
&mut self,
sz: impl Into<Option<u32>>
) -> &mut Self
Sets the max connection-level flow control for HTTP2
Default is 65,535
pub fn http2_max_concurrent_streams(
&mut self,
max: impl Into<Option<u32>>
) -> &mut Self
[src]
&mut self,
max: impl Into<Option<u32>>
) -> &mut Self
Sets the SETTINGS_MAX_CONCURRENT_STREAMS
option for HTTP2
connections.
Default is no limit (None
).
pub fn keep_alive(&mut self, val: bool) -> &mut Self
[src]
Enables or disables HTTP keep-alive.
Default is true.
pub fn max_buf_size(&mut self, max: usize) -> &mut Self
[src]
Set the maximum buffer size for the connection.
Default is ~400kb.
Panics
The minimum value allowed is 8192. This method panics if the passed max
is less than the minimum.
pub fn pipeline_flush(&mut self, enabled: bool) -> &mut Self
[src]
Aggregates flushes to better support pipelined responses.
Experimental, may have bugs.
Default is false.
pub fn with_executor<E2>(self, exec: E2) -> Http<E2>
[src]
Set the executor used to spawn background tasks.
Default uses implicit default (like tokio::spawn
).
pub fn serve_connection<S, I, Bd>(
&self,
io: I,
service: S
) -> Connection<I, S, E> where
S: Service<ReqBody = Body, ResBody = Bd>,
S::Error: Into<Box<dyn StdError + Send + Sync>>,
Bd: Payload,
I: AsyncRead + AsyncWrite,
E: H2Exec<S::Future, Bd>,
[src]
&self,
io: I,
service: S
) -> Connection<I, S, E> where
S: Service<ReqBody = Body, ResBody = Bd>,
S::Error: Into<Box<dyn StdError + Send + Sync>>,
Bd: Payload,
I: AsyncRead + AsyncWrite,
E: H2Exec<S::Future, Bd>,
Bind a connection together with a Service
.
This returns a Future that must be polled in order for HTTP to be driven on the connection.
Example
let http = Http::new(); let conn = http.serve_connection(some_io, some_service); let fut = conn.map_err(|e| { eprintln!("server connection error: {}", e); }); hyper::rt::spawn(fut);
pub fn serve_addr<S, Bd>(
&self,
addr: &SocketAddr,
make_service: S
) -> Result<Serve<AddrIncoming, S, E>> where
S: MakeServiceRef<AddrStream, ReqBody = Body, ResBody = Bd>,
S::Error: Into<Box<dyn StdError + Send + Sync>>,
Bd: Payload,
E: H2Exec<<S::Service as Service>::Future, Bd>,
[src]
&self,
addr: &SocketAddr,
make_service: S
) -> Result<Serve<AddrIncoming, S, E>> where
S: MakeServiceRef<AddrStream, ReqBody = Body, ResBody = Bd>,
S::Error: Into<Box<dyn StdError + Send + Sync>>,
Bd: Payload,
E: H2Exec<<S::Service as Service>::Future, Bd>,
Bind the provided addr
with the default Handle
and return Serve
.
This method will bind the addr
provided with a new TCP listener ready
to accept connections. Each connection will be processed with the
make_service
object provided, creating a new service per
connection.
pub fn serve_addr_handle<S, Bd>(
&self,
addr: &SocketAddr,
handle: &Handle,
make_service: S
) -> Result<Serve<AddrIncoming, S, E>> where
S: MakeServiceRef<AddrStream, ReqBody = Body, ResBody = Bd>,
S::Error: Into<Box<dyn StdError + Send + Sync>>,
Bd: Payload,
E: H2Exec<<S::Service as Service>::Future, Bd>,
[src]
&self,
addr: &SocketAddr,
handle: &Handle,
make_service: S
) -> Result<Serve<AddrIncoming, S, E>> where
S: MakeServiceRef<AddrStream, ReqBody = Body, ResBody = Bd>,
S::Error: Into<Box<dyn StdError + Send + Sync>>,
Bd: Payload,
E: H2Exec<<S::Service as Service>::Future, Bd>,
Bind the provided addr
with the Handle
and return a Serve
This method will bind the addr
provided with a new TCP listener ready
to accept connections. Each connection will be processed with the
make_service
object provided, creating a new service per
connection.
pub fn serve_incoming<I, S, Bd>(
&self,
incoming: I,
make_service: S
) -> Serve<I, S, E> where
I: Stream,
I::Error: Into<Box<dyn StdError + Send + Sync>>,
I::Item: AsyncRead + AsyncWrite,
S: MakeServiceRef<I::Item, ReqBody = Body, ResBody = Bd>,
S::Error: Into<Box<dyn StdError + Send + Sync>>,
Bd: Payload,
E: H2Exec<<S::Service as Service>::Future, Bd>,
[src]
&self,
incoming: I,
make_service: S
) -> Serve<I, S, E> where
I: Stream,
I::Error: Into<Box<dyn StdError + Send + Sync>>,
I::Item: AsyncRead + AsyncWrite,
S: MakeServiceRef<I::Item, ReqBody = Body, ResBody = Bd>,
S::Error: Into<Box<dyn StdError + Send + Sync>>,
Bd: Payload,
E: H2Exec<<S::Service as Service>::Future, Bd>,
Bind the provided stream of incoming IO objects with a MakeService
.
Trait Implementations
Auto Trait Implementations
impl<E> Send for Http<E> where
E: Send,
E: Send,
impl<E> Unpin for Http<E> where
E: Unpin,
E: Unpin,
impl<E> Sync for Http<E> where
E: Sync,
E: Sync,
impl<E> UnwindSafe for Http<E> where
E: UnwindSafe,
E: UnwindSafe,
impl<E> RefUnwindSafe for Http<E> where
E: RefUnwindSafe,
E: RefUnwindSafe,
Blanket Implementations
impl<T> ToOwned for T where
T: Clone,
[src]
T: Clone,
type Owned = T
The resulting type after obtaining ownership.
fn to_owned(&self) -> T
[src]
fn clone_into(&self, target: &mut T)
[src]
impl<T, U> Into<U> for T where
U: From<T>,
[src]
U: From<T>,
impl<T> From<T> for T
[src]
impl<T, U> TryFrom<U> for T where
U: Into<T>,
[src]
U: Into<T>,
type Error = Infallible
The type returned in the event of a conversion error.
fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>
[src]
impl<T, U> TryInto<U> for T where
U: TryFrom<T>,
[src]
U: TryFrom<T>,
type Error = <U as TryFrom<T>>::Error
The type returned in the event of a conversion error.
fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>
[src]
impl<T> BorrowMut<T> for T where
T: ?Sized,
[src]
T: ?Sized,
fn borrow_mut(&mut self) -> &mut T
[src]
impl<T> Borrow<T> for T where
T: ?Sized,
[src]
T: ?Sized,
impl<T> Any for T where
T: 'static + ?Sized,
[src]
T: 'static + ?Sized,