Struct ApiResponse 

pub struct ApiResponse {
    pub code: i32,
    pub msg: String,
    pub data: Value,
}

标准 API 响应结构体

严格对齐 PHP renderJson 输出格式：{code, msg, data}，字段顺序固定。

用法

use sz_rust_http_facade::response::ApiResponse;
use serde_json::json;

// 成功响应
let resp = ApiResponse::success(json!({"id": 1}), "ok");

// 错误响应
let resp = ApiResponse::error("参数错误");

// 自定义 code
let resp = ApiResponse::new(-1, "未登录", json!({}));

Fields

code: i32

业务状态码（1=成功，0=失败，-1=未登录，与 PHP BaseException 对齐）

msg: String

业务消息

data: Value

业务数据

Implementations

impl ApiResponse

pub fn new(code: i32, msg: impl Into<String>, data: Value) -> Self

创建新的 ApiResponse

pub fn success(data: Value, msg: impl Into<String>) -> Self

创建成功响应（code=1）

对齐 PHP renderSuccess($data = [], $msg = '')。

pub fn success_empty() -> Self

创建成功响应（默认空 data + 空 msg）

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

创建错误响应（code=0）

对齐 PHP renderError($msg = '', $data = [])。

pub fn error_with_data(msg: impl Into<String>, data: Value) -> Self

创建带数据的错误响应（code=0）

pub fn error_with_code(code: i32, msg: impl Into<String>, data: Value) -> Self

创建带自定义错误码的错误响应

对齐 PHP renderError($code, $msg, $data)。

pub fn to_value(&self) -> Value

序列化为 serde_json::Value（保证字段顺序 code → msg → data）

使用 serde_json::Map（启用 preserve_order）保证插入顺序。

pub fn to_json_string(&self) -> String

序列化为 JSON 字符串

pub fn to_json_bytes(&self) -> Bytes

序列化为 bytes::Bytes（零拷贝引用计数字节容器）

P3 优化：替代 to_json_string 的 String 分配， 使用 serde_json::to_vec 序列化到 Vec<u8> 后转为 Bytes， 避免 String 的 UTF-8 验证开销，支持零拷贝传递。

输出与 to_json_string 逐字节一致。

Trait Implementations

impl Clone for ApiResponse

fn clone(&self) -> ApiResponse

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ApiResponse

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

Formats the value using the given formatter.

impl IntoResponse for ApiResponse

让 ApiResponse 可以直接作为 axum handler 返回值

自动设置：

• HTTP 状态码：200（无论业务 code 是 1 还是 0，HTTP 都是 200，对齐 PHP 行为）
• Content-Type: application/json; charset=utf-8

fn into_response(self) -> Response

Create a response.

impl Serialize for ApiResponse

fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>

where S: Serializer,

Serialize this value into the given Serde serializer.