Struct ApiResponseData 

pub struct ApiResponseData<T> {
    pub data: T,
    pub success: bool,
    pub message: Option<String>,
    pub request_id: String,
    pub timestamp: Option<i64>,
    pub extra: HashMap<String, Value>,
}

📄 API响应包装器

统一的API响应格式

Fields

data: T

📊 响应数据

success: bool

✅ 请求是否成功

message: Option<String>

📝 响应消息

request_id: String

🏷️ 请求ID

timestamp: Option<i64>

⏱️ 响应时间戳

extra: HashMap<String, Value>

📋 额外的元数据

Implementations

impl<T> ApiResponseData<T>

pub fn success(data: T) -> Self

🆕 创建成功响应

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

where T: Default,

🆕 创建错误响应（需要 T: Default）

注意：

• 旧实现曾使用 mem::zeroed() 为泛型 T 构造占位值，这是不安全且可能导致 UB 的。
• 若 T 无法提供默认值，请使用 error_with_data 显式传入 data。

pub fn error_with_data(data: T, message: impl Into<String>) -> Self

🆕 创建错误响应（显式传入 data，避免对 T 施加额外约束）

pub fn is_success(&self) -> bool

🔍 检查响应是否成功

pub fn error_message(&self) -> Option<&String>

📝 获取错误消息

pub fn into_result(self) -> Result<T, Error>

🔄 转换为Result类型

Trait Implementations

impl<T: DeserializeOwned + Send + Sync + 'static> ApiResponse for ApiResponseData<T>

fn is_success(&self) -> bool

🔍 检查响应是否成功

fn error_message(&self) -> Option<&String>

📝 获取错误消息

fn into_result(self) -> Result<Self, Error>

🔄 转换为Result类型

impl<T: Clone> Clone for ApiResponseData<T>

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

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T: Debug> Debug for ApiResponseData<T>

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

Formats the value using the given formatter.

impl<'de, T> Deserialize<'de> for ApiResponseData<T>

where T: Deserialize<'de>,

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<T> Serialize for ApiResponseData<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.