package com.example.demo.model;

import io.swagger.v3.oas.annotations.media.Schema;
import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;

import java.util.List;

/**
 * 统一 API 响应结果封装。
 *
 * <p>所有 RESTful 接口统一使用此类包装返回结果，包含状态码、提示信息和数据载荷。</p>
 *
 * @param <T> 数据类型
 */
@Data
@NoArgsConstructor
@AllArgsConstructor
@Schema(description = "统一 API 响应结果")
public class ApiResult<T> {

    /** 业务状态码，200 表示成功 */
    @Schema(description = "业务状态码，200 表示成功")
    private int code;

    /** 提示信息 */
    @Schema(description = "提示信息")
    private String message;

    /** 数据载荷 */
    @Schema(description = "数据载荷")
    private T data;

    /**
     * 返回成功响应（无数据）。
     *
     * @param <T> 数据类型
     * @return 成功响应
     */
    public static <T> ApiResult<T> success() {
        return new ApiResult<>(200, "操作成功", null);
    }

    /**
     * 返回成功响应（含数据）。
     *
     * @param data 数据
     * @param <T>  数据类型
     * @return 成功响应
     */
    public static <T> ApiResult<T> success(T data) {
        return new ApiResult<>(200, "操作成功", data);
    }

    /**
     * 返回成功响应（含自定义消息和数据）。
     *
     * @param message 提示信息
     * @param data    数据
     * @param <T>     数据类型
     * @return 成功响应
     */
    public static <T> ApiResult<T> success(String message, T data) {
        return new ApiResult<>(200, message, data);
    }

    /**
     * 返回失败响应。
     *
     * @param code    状态码
     * @param message 提示信息
     * @param <T>     数据类型
     * @return 失败响应
     */
    public static <T> ApiResult<T> error(int code, String message) {
        return new ApiResult<>(code, message, null);
    }
}
