pub struct StaticServerConfig { /* private fields */ }Expand description
Configuration for a static server. Construction validates the site root.
Implementations§
Source§impl StaticServerConfig
impl StaticServerConfig
Sourcepub fn with_include_resolver(self, resolver: Arc<dyn IncludeResolver>) -> Self
pub fn with_include_resolver(self, resolver: Arc<dyn IncludeResolver>) -> Self
Install a resolver for [include] placeholders.
Absent by default, and dustnetd never sets one: a server without a
resolver serves authored AML unchanged, so an [include] travels to the
client and renders as nothing. Setting one is what lets a page carry
generated content, and it is the only way this server produces markup it
did not read from a file.
Sourcepub fn with_input_handler(self, handler: Arc<dyn InputHandler>) -> Self
pub fn with_input_handler(self, handler: Arc<dyn InputHandler>) -> Self
Install a handler for form submissions.
Absent by default, and dustnetd never sets one: without a handler
INPUT is refused with 405, which is what this server did before
handlers existed. Installing one is what lets a site accept a
submission, and it is the only way this server changes anything on disk.
Sourcepub fn with_session_resolver(self, resolver: Arc<dyn SessionResolver>) -> Self
pub fn with_session_resolver(self, resolver: Arc<dyn SessionResolver>) -> Self
Install a resolver that turns a session token into an identity.
Without one every request is anonymous, whatever token it carries. Installing one is what makes a site able to know who is asking — and the token goes no further than this resolver: handlers are told the identity.
Sourcepub async fn bind_plaintext_loopback(
root: PathBuf,
address: &str,
port: u16,
) -> Result<Self, ProtocolError>
pub async fn bind_plaintext_loopback( root: PathBuf, address: &str, port: u16, ) -> Result<Self, ProtocolError>
Bind a plaintext development server. The listener enforces loopback-only use.
Sourcepub async fn bind_tls(
root: PathBuf,
address: &str,
port: u16,
certificate: &str,
private_key: &str,
) -> Result<Self, ProtocolError>
pub async fn bind_tls( root: PathBuf, address: &str, port: u16, certificate: &str, private_key: &str, ) -> Result<Self, ProtocolError>
Bind a TLS 1.3 static server using PEM certificate and private-key files.
Sourcepub fn local_addr(&self) -> Result<SocketAddr, ProtocolError>
pub fn local_addr(&self) -> Result<SocketAddr, ProtocolError>
Return the listener address, including an OS-selected port when port zero was requested.
Sourcepub fn with_connection_limits(self, global: usize, per_ip: usize) -> Self
pub fn with_connection_limits(self, global: usize, per_ip: usize) -> Self
Override the connection ceilings.
The right ceiling depends on the operator’s machine — chiefly its
RLIMIT_NOFILE, which this process cannot raise for itself under the
workspace’s forbid(unsafe_code). Both values are clamped to at least
one, and the per-IP ceiling is clamped to the global one: a per-IP limit
above the global limit does not describe a reachable state.