Spring MVC 打造手機客戶端 RESTful API 完整指南

需求場景

使用 Spring + SpringMVC + MyBatis 技術棧，MySQL 資料庫，Eclipse 開發環境，需為手機 App 提供註冊、登錄等 REST 接口。

核心實現步驟

1. 控制器層：使用 @RestController 與 @RequestMapping 定義接口路徑，自動將返回物件序列化為 JSON。

   @RestController
   @RequestMapping("/api/user")
   public class UserController {
       @PostMapping("/register")
       public Result register(@RequestBody UserDTO dto) { ... }
   
       @PostMapping("/login")
       public Result login(@RequestBody LoginDTO dto) { ... }
   }

2. 服務層：處理業務邏輯，調用 MyBatis Mapper 進行資料庫操作，密碼務必加密存儲（BCrypt/Argon2）。
3. 統一響應格式：定義通用 Result<T> 封裝狀態碼、訊息、數據，便於前端統一處理。
4. 跨域與安全：配置 CORS 允許手機域名；整合 Spring Security 或 JWT 實現無狀態認證。
5. 參數校驗：啟用 @Valid + Hibernate Validator 進行 DTO 校驗，減少無效請求。

測試與部署

使用 Postman 或 Swagger UI 進行接口測試；打包為 WAR/JAR 部署至 Tomcat，配置 Nginx 反向代理與 HTTPS。