Struct BoundServer 

pub struct BoundServer { /* private fields */ }

An OssServer with both listeners bound and held live — the eager-bind half of the serve seam. Returned by OssServer::bind. The gRPC + Flight SQL surface and the HTTP side-channel are already listening: Self::flight_addr / Self::health_addr report the ACTUAL bound addresses (the real ports even when the config requested :0), and neither port is released before Self::serve_with_shutdown serves on the very same listeners — there is no release-then-rebind window a concurrent binder could slip into.

Implementations

impl BoundServer

pub fn flight_addr(&self) -> SocketAddr

The ACTUAL address the gRPC + Flight SQL surface is bound to. When the config requested :0, this is the ephemeral port the kernel assigned — resolved at OssServer::bind and held.

pub fn health_addr(&self) -> SocketAddr

The ACTUAL address the HTTP side-channel (/healthz, /readyz, /metrics) is bound to. When the config requested :0, this is the ephemeral port the kernel assigned.

pub async fn serve_with_shutdown( self, shutdown: impl Future<Output = ()> + Send + 'static, ) -> Result<(), ServerError>

Serve both halves on the already-bound listeners until shutdown resolves. The HTTP side-channel and the gRPC surface drain in parallel; the call returns when both have stopped accepting new connections and finished serving in-flight requests.

pub async fn serve(self) -> Result<(), ServerError>

Serve both halves until SIGINT / SIGTERM arrives. The binary entry point (OssServer::run and main) reaches graceful shutdown through this.