Skip to main content

StaticServerConfig

Struct StaticServerConfig 

Source
pub struct StaticServerConfig { /* private fields */ }
Expand description

Configuration for a static server. Construction validates the site root.

Implementations§

Source§

impl StaticServerConfig

Source

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.

Source

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.

Source

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.

Source

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.

Source

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.

Source

pub fn local_addr(&self) -> Result<SocketAddr, ProtocolError>

Return the listener address, including an OS-selected port when port zero was requested.

Source

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.

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T> Instrument for T

Source§

fn instrument(self, span: Span) -> Instrumented<Self> ⓘ

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Source§

fn in_current_span(self) -> Instrumented<Self> ⓘ

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = !

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, !>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<T> WithSubscriber for T

Source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self> ⓘ
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

fn with_current_subscriber(self) -> WithDispatch<Self> ⓘ

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more