Struct tide_rustls::TlsListenerBuilder

pub struct TlsListenerBuilder { /* fields omitted */ }

A builder for TlsListeners

This is created with a call to TlsListener::build. This also can be passed directly to tide::Server::listen, skipping the TlsListenerBuilder::finish call.

Examples

let listener = TlsListener::build()
    .addrs("localhost:4433")
    .cert("./tls/localhost-4433.cert")
    .key("./tls/localhost-4433.key")
    .finish();

let listener = TlsListener::build()
    .tcp(std::net::TcpListener::bind("localhost:4433").unwrap())
    .config(rustls::ServerConfig::new(rustls::NoClientAuth::new()))
    .finish();

Implementations

impl TlsListenerBuilder

pub fn key(self, path: impl AsRef<Path>) -> Self

Provide a path to a key file, in either pkcs8 or rsa formats. This is mutually exclusive with providing a server config with TlsListenerBuilder::config, but must be used in conjunction with TlsListenerBuilder::cert

pub fn cert(self, path: impl AsRef<Path>) -> Self

Provide a path to a cert file. This is mutually exclusive with providing a server config with TlsListenerBuilder::config, but must be used in conjunction with TlsListenerBuilder::key

pub fn config(self, config: ServerConfig) -> Self

Provide a prebuilt rustls::ServerConfig with any options. This is mutually exclusive with both TlsListenerBuilder::key and TlsListenerBuilder::cert, but provides the opportunity for more configuration choices.

pub fn tcp(self, tcp: impl Into<TcpListener>) -> Self

Provides a bound tcp listener (either async-std or std) to build this tls listener on. This is mutually exclusive with TlsListenerBuilder::addrs, but one of them is mandatory.

pub fn addrs(self, addrs: impl ToSocketAddrs) -> Self

Provides a std::net::ToSocketAddrs specification for this tls listener. This is mutually exclusive with TlsListenerBuilder::tcp but one of them is mandatory.

pub fn finish(self) -> Result<TlsListener>

finishes building a TlsListener from this TlsListenerBuilder.

Errors

this will return an error unless all of the following conditions are met:

• either of these is provided, but not both
  • TlsListenerBuilder::tcp
  • TlsListenerBuilder::addrs
• either of these is provided, but not both
  • both TlsListenerBuilder::cert AND TlsListenerBuilder::key
  • TlsListenerBuilder::config

Trait Implementations

impl Debug for TlsListenerBuilder

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

Formats the value using the given formatter.

impl Default for TlsListenerBuilder

fn default() -> TlsListenerBuilder

Returns the "default value" for a type.

impl<State: Clone + Send + Sync + 'static> ToListener<State> for TlsListenerBuilder

type Listener = TlsListener

fn to_listener(self) -> Result<Self::Listener>

Transform self into a Listener. Unless self is already bound/connected to the underlying io, converting to a listener does not initiate a connection. An Err return indicates an unsuccessful conversion to a listener, not an unsuccessful bind attempt.