Struct SwaggerUiHandler 

pub struct SwaggerUiHandler { /* private fields */ }

Swagger UI 处理器

实现了Silent的Handler trait，可以直接添加到路由中。 负责处理Swagger UI相关的所有请求，包括：

• Swagger UI 静态资源
• OpenAPI 规范JSON
• 重定向到Swagger UI主页

Implementations

impl SwaggerUiHandler

pub fn new(ui_path: &str, openapi: OpenApi) -> Result<Self>

创建新的Swagger UI处理器

参数

• ui_path: Swagger UI的访问路径，如 “/swagger-ui”
• openapi: OpenAPI规范对象

示例

use silent_openapi::SwaggerUiHandler;
use utoipa::OpenApi;

#[derive(OpenApi)]
#[openapi(paths(), components(schemas()))]
struct ApiDoc;

let handler = SwaggerUiHandler::new("/swagger-ui", ApiDoc::openapi());

pub fn with_custom_api_doc_path( ui_path: &str, api_doc_path: &str, openapi: OpenApi, ) -> Result<Self>

使用自定义的API文档路径

参数

• ui_path: Swagger UI的访问路径
• api_doc_path: OpenAPI JSON的访问路径
• openapi: OpenAPI规范对象

pub fn with_options( ui_path: &str, openapi: OpenApi, options: SwaggerUiOptions, ) -> Result<Self>

使用自定义选项创建处理器

pub fn into_route(self) -> Route

将处理器转换为可直接挂载的 Route 树

自动在 <ui_path> 下注册以下路由（GET/HEAD）：

• <ui_path>
• <ui_path>/openapi.json
• <ui_path>/<path:**>

Trait Implementations

impl Clone for SwaggerUiHandler

fn clone(&self) -> SwaggerUiHandler

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Handler for SwaggerUiHandler

fn call<'life0, 'async_trait>( &'life0 self, req: Request, ) -> Pin<Box<dyn Future<Output = Result<Response>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

impl RouterAdapt for SwaggerUiHandler

fn into_router(self) -> Route