Spring项目中获取“我的媒体”的API端点选型咨询

两个选项的优劣分析 #

选项1：/users/me/medias 置于UserController #

• 优势：完全贴合RESTful的资源嵌套语义，清晰表达“当前用户所拥有的媒体资源”，和UserController负责用户及其关联资源的定位完全匹配，逻辑连贯。
• 劣势：如果后续要给“我的媒体”添加复杂过滤、排序或批量操作，可能会让UserController职责范围扩大，偏离原本“用户CRUD”的核心定位。

选项2：/medias/me 置于MediaController #

• 优势：符合单一职责原则，所有媒体相关操作收拢在MediaController中，后续扩展媒体功能时，代码结构统一，便于维护。
• 劣势：语义不够直观，/medias/me需要额外理解才能对应到“当前用户的媒体”，不像嵌套路径那样一眼明确资源归属。

更标准的RESTful方案 #

行业内常用的两种标准实现方式：

1. 优化嵌套路径方案：保留/users/me/medias放在UserController，通过Spring拦截器、切面或自定义参数解析器统一处理me的解析，把当前登录用户ID注入接口方法，避免重复编写获取当前用户的逻辑，既保持语义清晰，又避免代码冗余。
2. 参数过滤方案：使用/medias?owner=me放在MediaController，扩展性更强——后续需要查询其他用户的媒体时，只需把owner参数换成具体用户ID即可，无需新增接口，同时让MediaController专注于媒体资源的全量操作逻辑。

选型建议 #

• 如果用户与媒体是强归属关系，且“我的媒体”是高频核心操作，优先选/users/me/medias，语义清晰符合RESTful设计规范；
• 如果媒体资源需要支持多种过滤场景（比如按标签、时间范围+按所有者过滤），优先选/medias?owner=me，灵活性更高，也能保持控制器职责单一。

内容的提问来源于stack exchange，提问作者KH Eom