Struct Server

pub struct Server<A = DefaultAcceptor> { /* private fields */ }

HTTP server.

Implementations

impl Server

pub fn bind(addr: SocketAddr) -> Self

Create a server that will bind to provided address.

pub fn from_tcp(listener: TcpListener) -> Self

Create a server from existing std::net::TcpListener.

impl<A> Server<A>

pub fn acceptor<Acceptor>(self, acceptor: Acceptor) -> Server<Acceptor>

Overwrite acceptor.

pub fn map<Acceptor, F>(self, acceptor: F) -> Server<Acceptor>

where F: FnOnce(A) -> Acceptor,

Map acceptor.

pub fn get_ref(&self) -> &A

Returns a reference to the acceptor.

pub fn get_mut(&mut self) -> &mut A

Returns a mutable reference to the acceptor.

pub fn http_builder(&mut self) -> &mut Builder<TokioExecutor>

Returns a mutable reference to the Http builder.

pub fn handle(self, handle: Handle) -> Self

Provide a handle for additional utilities.

pub async fn serve<M>(self, make_service: M) -> Result<()>

where M: MakeService<SocketAddr, Request<Incoming>>, A: Accept<TcpStream, M::Service> + Clone + Send + Sync + 'static, A::Stream: AsyncRead + AsyncWrite + Unpin + Send, A::Service: SendService<Request<Incoming>> + Send, A::Future: Send,

Serve provided MakeService.

To create MakeService easily, Shared from tower can be used.

Errors

An error will be returned when:

• Binding to an address fails.
• make_service returns an error when poll_ready is called. This never happens on axum make services.

Trait Implementations

impl<A> Debug for Server<A>

where A: Debug,

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.