Skip to main content

Crate sz_rust_http_facade

Crate sz_rust_http_facade 

Source
Expand description

SZ-Rust HTTP Facade

提取自 sz-rust-core 的 HTTP 基础模块,提供响应、错误、请求三大基础能力。

§模块结构

模块对齐 PHP说明
responseSzController::renderJson/renderSuccess/renderError标准 API 响应结构 + 便捷函数
errorapp\common\exception\BaseException错误码枚举 + 异常类型
request$this->request->post/get/param请求体/查询参数解析

§用法

use sz_rust_http_facade::response::{ApiResponse, respond_html};
use sz_rust_http_facade::error::{BaseException, ErrorCode};
use sz_rust_http_facade::request::fetch_post_data;

§与 sz-rust-core 的关系

sz-rust-core 通过 pub use sz_rust_http_facade as http; 重导出本 crate, 因此 sz_rust_core::http::response 等价于 sz_rust_http_facade::response。 下游业务包推荐直接依赖 sz-rust-http-facade 以减少编译耦合。

Re-exports§

pub use error::BaseException;
pub use error::ErrorCode;
pub use response::auto_respond;
pub use response::is_json_request;
pub use response::render_error;
pub use response::render_error_with_code;
pub use response::render_json;
pub use response::render_success;
pub use response::respond;
pub use response::respond_html;
pub use response::respond_jsonp;
pub use response::respond_text;
pub use response::ApiResponse;
pub use response::JsonResponse;
pub use response::JsonpResponse;

Modules§

error
错误体系 — BaseException + 错误码映射
openapi
OpenAPI 3.0 文档自动生成
request
请求模块 — postData/getData/file/upload
response
响应模块 — renderJson/renderSuccess/renderError + ApiResponse
tls
TLS 配置 + HTTP/2 服务