Struct Server 

pub struct Server<I: ReqInterceptor = DummyInterceptor> {
    pub port: u16,
    pub tls_param: Option<TlsParam>,
    pub interceptor: Option<I>,
    pub idle_timeout: Duration,
    /* private fields */
}

HTTP/HTTPS 服务器核心结构

泛型参数

• I: 请求拦截器类型，必须实现 ReqInterceptor trait

字段

• port: 监听端口
• tls_param: TLS 配置参数 (可选)
• router: Axum 路由
• interceptor: 请求拦截器实例 (可选)
• idle_timeout: 连接空闲超时时间
• shutdown_rx: 关闭信号接收器

Fields

port: u16

tls_param: Option<TlsParam>

interceptor: Option<I>

idle_timeout: Duration

Implementations

impl<I> Server<I>

where I: ReqInterceptor + Clone + Send + Sync + 'static,

pub fn with_interceptor<R>(self: Server<I>, interceptor: R) -> Server<R>

where R: ReqInterceptor + Clone + Send + Sync + 'static,

设置请求拦截器

用于将服务器的拦截器类型更改为新的类型

类型参数

• R: 新的拦截器类型

参数

• interceptor: 新的拦截器实例

返回

返回配置了新拦截器的服务器实例

pub fn with_tls_param(self, tls_param: Option<TlsParam>) -> Self

设置 TLS 参数

参数

• tls_param: TLS 配置参数，为 None 时禁用 TLS

返回

返回配置了 TLS 的服务器实例

pub fn with_timeout(self, timeout: Duration) -> Self

设置连接空闲超时时间

参数

• timeout: 超时时长

返回

返回配置了超时的服务器实例

pub async fn run(self) -> Result<(), Error>

启动服务器

根据 TLS 配置启动 HTTP 或 HTTPS 服务器，并监听关闭信号

返回

• Ok(()): 服务器成功启动并正常关闭
• Err(std::io::Error): 启动或运行过程中出现 I/O 错误

错误

• 端口绑定失败
• TLS 证书加载失败
• 网络 I/O 错误