Struct ResultBody 

pub struct ResultBody<T> {
    pub code: i32,
    pub msg: String,
    pub data: Option<T>,
}

API 统一响应体

所有 HTTP API 的响应均包装为此格式：

{
  "code": 200,
  "msg": "成功！",
  "data": { ... }
}

构造方法

方法	code	用途
success()	200	无数据成功响应
success_data()	200	带数据成功响应
error()	500	通用失败响应
error_code()	自定义	指定错误码的失败响应

Panics

本结构体及其方法均不 panic。序列化失败时通过 [IntoResponse] 优雅降级为 500 JSON 错误响应。

辅助函数

• permission_denied_response(): 权限不足 403
• download_forbidden(): 下载无权限 403
• download_failed(): 下载失败 500
• json_response(): 任意可序列化类型转 JSON 响应

Fields

code: i32

响应码，200 成功

msg: String

响应消息

data: Option<T>

业务数据

Implementations

impl<T: Serialize> ResultBody<T>

pub fn success() -> Self

构建无数据的成功响应。

返回值

返回 code=200, msg="成功！", data=None 的 ResultBody。

示例

use tdm_server_rust::common::ResultBody;
let res: ResultBody<()> = ResultBody::success();
assert_eq!(res.code, 200);

pub fn success_data(data: T) -> Self

构建带数据的成功响应。

返回值

返回 code=200, msg="成功！", data=Some(data) 的 ResultBody。

示例

use tdm_server_rust::common::ResultBody;
let res = ResultBody::success_data(42);
assert_eq!(res.data, Some(42));

pub fn error(msg: impl Into<String>) -> ResultBody<()>

构建通用失败响应（错误码 500）。

返回值

返回 code=500, msg=<传入消息>, data=None 的 ResultBody<()>。

pub fn error_code(code: i32, msg: impl Into<String>) -> ResultBody<()>

构建指定错误码的失败响应。

参数

• code: 业务错误码，参见 ErrorCode 常量
• msg: 错误描述消息

返回值

返回 code=<指定值>, msg=<传入消息>, data=None 的 ResultBody<()>。

Trait Implementations

impl<T: Clone> Clone for ResultBody<T>

fn clone(&self) -> ResultBody<T>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T: Debug> Debug for ResultBody<T>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<T: Serialize> IntoResponse for ResultBody<T>

将 ResultBody 转为 axum HTTP 响应。

Content-Type 对齐 Java: application/json;charset=UTF-8。

Errors

JSON 序列化失败时返回 500 {"code":500,"msg":"JSON 序列化失败: ...","data":null} 纯文本降级。 此错误不应在正常业务中出现，仅当 T 的 Serialize 实现有 bug 才会触发。

fn into_response(self) -> Response

Create a response.

impl<T> Serialize for ResultBody<T>

where T: Serialize,

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.