private boolean success;
private String message;
private T data;
private List<String> errors;
private int errorCode;
private long timestamp; // Adding timestamp for tracking
private String path; // Adding path to identify the API endpoint

// Constructors, getters, and setters
}

了解每個字段：

成功：

類型： boolean
描述：指示 API 調用是否成功。
為什么使用它 ：快速確定請求的結果，簡化客戶端邏輯。

2.消息 ：

類型： String
描述：提供有關 API 調用結果的人性化消息。
為什么使用它 ：有助于向客戶提供上下文反饋，對于成功和錯誤情況都有用。

3.數據：

類型： T
描述：包含響應的有效負載，可以是任何數據類型。
為什么使用它 ：提供客戶端請求的實際數據。

4.錯誤 ：

類型： List<String>
描述：API 調用不成功時顯示的錯誤消息列表。
為什么使用它 ：提供有關出現問題的詳細信息，對于調試和用戶反饋很有用。

5. 錯誤代碼 ：

類型： int
描述：代表錯誤類型的特定代碼。
為什么使用它 ：幫助以編程方式對錯誤進行分類并做出適當的響應。

6.時間戳 ：

類型： long
描述：生成響應的時間戳。
為什么使用它 ：對于記錄和跟蹤響應時間很有用，這有助于調試和監控。

7.路徑 ：

類型： String
描述：調用的 API 端點。
為什么使用它 ：幫助識別哪個 API 端點生成了響應，這對于調試和日志記錄很有用。

2. 創建響應的實用方法

讓我們創建實用的方法來生成響應，以保持不重復。這樣做既可以確保一致性，又能減少樣板代碼。

public class ResponseUtil {



    public static <T> ApiResponse<T> success(T data, String message, String path) {

        ApiResponse<T> response = new ApiResponse<>();

        response.setSuccess(true);

        response.setMessage(message);

        response.setData(data);

        response.setErrors(null);

        response.setErrorCode(0); // No error

        response.setTimestamp(System.currentTimeMillis());

        response.setPath(path);

        return response;

    }



    public static <T> ApiResponse<T> error(List<String> errors, String message, int errorCode, String path) {

        ApiResponse<T> response = new ApiResponse<>();

        response.setSuccess(false);

        response.setMessage(message);

        response.setData(null);

        response.setErrors(errors);

        response.setErrorCode(errorCode);

        response.setTimestamp(System.currentTimeMillis());

        response.setPath(path);

        return response;

    }



    public static <T> ApiResponse<T> error(String error, String message, int errorCode, String path) {

        return error(Arrays.asList(error), message, errorCode, path);

    }

}

3. 實現全局異常處理

我們可以使用 @ControllerAdvice 和 @ExceptionHandler 注解來全局處理異常，確保捕獲任何未處理的錯誤并以標準響應格式返回。

@RestControllerAdvice

public class GlobalExceptionHandler {



    @ExceptionHandler(Exception.class)

    public ResponseEntity<ApiResponse<Void>> handleException(HttpServletRequest request, Exception ex) {

        List<String> errors = Arrays.asList(ex.getMessage());

        ApiResponse<Void> response = ResponseUtil.error(errors, "An error occurred", 1000, request.getRequestURI()); // General error

        return new ResponseEntity<>(response, HttpStatus.INTERNAL_SERVER_ERROR);

    }



    @ExceptionHandler(ResourceNotFoundException.class)

    public ResponseEntity<ApiResponse<Void>> handleResourceNotFoundException(HttpServletRequest request, ResourceNotFoundException ex) {

        ApiResponse<Void> response = ResponseUtil.error(ex.getMessage(), "Resource not found", 1001, request.getRequestURI()); // Resource not found error

        return new ResponseEntity<>(response, HttpStatus.NOT_FOUND);

    }



    @ExceptionHandler(ValidationException.class)

    public ResponseEntity<ApiResponse<Void>> handleValidationException(HttpServletRequest request, ValidationException ex) {

        ApiResponse<Void> response = ResponseUtil.error(ex.getErrors(), "Validation failed", 1002, request.getRequestURI()); // Validation error

        return new ResponseEntity<>(response, HttpStatus.BAD_REQUEST);

    }



    // Handle other specific exceptions similarly

}

4. 在控制器中使用響應格式

現在，讓我們在示例控制器中使用標準化響應結構。

@RestController

@RequestMapping("/api/products")

public class ProductController {



    @GetMapping("/{id}")

    public ResponseEntity<ApiResponse<Product>> getProductById(@PathVariable Long id, HttpServletRequest request) {

        // Fetch product by id (dummy code)

        Product product = productService.findById(id);

        if (product == null) {

            throw new ResourceNotFoundException("Product not found with id " + id);

        }

        ApiResponse<Product> response = ResponseUtil.success(product, "Product fetched successfully", request.getRequestURI());

        return new ResponseEntity<>(response, HttpStatus.OK);

    }



    @PostMapping

    public ResponseEntity<ApiResponse<Product>> createProduct(@RequestBody Product product, HttpServletRequest request) {

        // Create new product (dummy code)

        Product createdProduct = productService.save(product);

        ApiResponse<Product> response = ResponseUtil.success(createdProduct, "Product created successfully", request.getRequestURI());

        return new ResponseEntity<>(response, HttpStatus.CREATED);

    }



    // More endpoints...

}