子资源的REST API约定

以下是一个示例，展示了如何使用子资源的REST API约定：

假设我们有两个资源：用户（users）和评论（comments）。每个用户可以创建和管理自己的评论。

1. 获取用户的所有评论：

   • 请求方法：GET
   • URL路径：/users/{userId}/comments
   • 示例代码：

     @GetMapping("/users/{userId}/comments")
     public List<Comment> getUserComments(@PathVariable("userId") String userId) {
         // 根据userId获取用户的所有评论
         // 返回评论列表
     }
     

2. 创建用户的评论：

   • 请求方法：POST
   • URL路径：/users/{userId}/comments
   • 示例代码：

     @PostMapping("/users/{userId}/comments")
     public Comment createComment(@PathVariable("userId") String userId, @RequestBody Comment comment) {
         // 根据userId创建新的评论
         // 返回创建的评论
     }
     

3. 获取特定用户的特定评论：

   • 请求方法：GET
   • URL路径：/users/{userId}/comments/{commentId}
   • 示例代码：

     @GetMapping("/users/{userId}/comments/{commentId}")
     public Comment getUserComment(@PathVariable("userId") String userId, @PathVariable("commentId") String commentId) {
         // 根据userId和commentId获取特定评论
         // 返回评论
     }
     

4. 更新特定用户的特定评论：

   • 请求方法：PUT
   • URL路径：/users/{userId}/comments/{commentId}
   • 示例代码：

     @PutMapping("/users/{userId}/comments/{commentId}")
     public Comment updateComment(@PathVariable("userId") String userId, @PathVariable("commentId") String commentId, @RequestBody Comment comment) {
         // 根据userId和commentId更新特定评论
         // 返回更新后的评论
     }
     

5. 删除特定用户的特定评论：

   • 请求方法：DELETE
   • URL路径：/users/{userId}/comments/{commentId}
   • 示例代码：

     @DeleteMapping("/users/{userId}/comments/{commentId}")
     public void deleteComment(@PathVariable("userId") String userId, @PathVariable("commentId") String commentId) {
         // 根据userId和commentId删除特定评论
     }
     

这些示例代码展示了如何使用子资源的REST API约定来处理用户和评论之间的关系。你可以根据自己的需求进行修改和扩展。