这是一个创建于 599 天前的主题，其中的信息可能已经有所发展或是发生改变。
假如有一个博客系统，有用户管理模块，文章模块，评论模块，并且使用 JWT Token （可以解析出 userId ）
那用户的文章列表、文章详情、文章的评论应该怎样设计呢？
第一种：
/users/:userId/postsUserController/users/:userId/posts/:postIdUserController/users/:userId/posts/:postId/commentsUserController/users/:userId/posts/:postId/comments/:commentIdUserController
也就是全都放在 UserController 里
第二种：
/postsPostController/posts/:postIdPostController/posts/:postId/commentsCommentController/posts/:postId/comments/:commentIdCommentController
第二种：
/postsPostController/posts/:postIdPostController/comments?post-id=xxCommentController/comments/:commentIdCommentController
第一种的话，因为 userId 是从用户的 headers.token 中解析出来的，所以我觉得没必要前面加上 /users/:userId，除非需要管理功能，但是管理功能的 api 本来就是要跟用户端的分开来的。而且这样的话所有功能都放在 UserController 里了。
第二种的话在 CommentController 里前缀是 /posts 有点奇怪。
所以个人偏向第三种。
 |
1
AnroZ 2023-04-02 23:12:09 +08:00  1
我们是选择第三种。具体什么原因忘了，应该是为了减少歧义，方便沟通。
|
 |
2
liununu 2023-04-02 23:20:19 +08:00 via iPhone 1
一种划分思路，从 Post / Comment 这两个资源的生命周期，依赖关系，聚合关系出发。
比如一个 Comment 一定仅是出现并关联在一个具体的 Post 上，不能完全创建的话，那就是 /posts/:postId/comments |
 |
3
zapper 2023-04-02 23:24:07 +08:00 1
9 敏，有两个第二种
根据我为数不多的“看过猪跑”的经验来看，/comments?post-id= 这种比较常见,例如 wordpress 的 https://example.com/wp-json/wp/v2/comments 参数可以接 author 可以接 post 前面的看起来是现代化的写法但是看起来总是觉得怪怪的，而且第一种全部在 UserController 里面不太好吧 |
 |
4
iseki 2023-04-02 23:30:31 +08:00 1
如果选用第二种的话考虑下要么每个 post 的 comments 都有独立的序列（比如楼层号），要么考虑下两者冲突时怎么弄；第三种的话，那就是个 id 了，没法在那个地方放楼层号了；
|
 |
5
daweiba 2023-04-02 23:53:11 +08:00 1
非常基础
/posts /posts/:id /posts/:id/comments /comments/:id |
 |
6
leoskey 2023-04-03 10:53:31 +08:00 1
个人经验，在第二种中 /posts/:postId/comments/:commentId 更适合操作在资源里无主键的集合或属性，例如 /posts/:postId/post-name , /posts/:postId/attachments
|
 |
7
jerrry OP @liununu 那这个 /posts/:postId/comments 是放在 PostController 还是 CommentController 呢？
|
|
8
jerrry OP @daweiba 那 /posts/:id/comments 是放在 PostController 还是 CommentController 里好呢？如果放在 PostController 里，那是调用 PostService 还是 CommentService 里来实现 findPostComments 方法呢？不知道哪种设计更好
|
|
9
daweiba 2023-04-03 17:45:23 +08:00
@jerrry
``` class PostsController < ApplicationController # /posts def index end # /posts/:id def show end # /posts/:id/comments def comments end end ``` ``` class CommentsController < ApplicationController # /comments def index end # /comments/:id def show end end ``` |
|
10
liununu 2023-04-03 19:41:12 +08:00 via iPhone
个人觉得 PostController 更合适一点，因为从属上是「某个文章里面的评论」
|
|
11
iseki 2023-04-03 20:52:37 +08:00 via Android 1
各放各的 controller ，不要被路由左右了，你看 ktor 那种写法，你就不会纠结这些有的没的了
|
Select Language