API Design Contract

使用 @RestController 和 @RequestMapping。

HTTP Method 语义要准确：

• GET: 查询
• POST: 新增/复杂查询
• PUT: 全量修改
• DELETE: 删除

如果之前的 Controller 接口中有使用 @Log 来标记日志，则需要模仿之前的进行添加；如果没有则无需添加。

所有接口必须返回统一包装类 HttpResult。

字段包含：code (int), msg (String), data (T)。

需要查看 HttpResult 实体中具体的成功和失败的方法来使用。

禁止在 Controller 中 try-catch。

异常统一抛出，由 @RestControllerAdvice 全局异常处理器捕获并转换输出。