概述
后台管理系统的「用户管理」还剩两类记录没做:视频记录和动态记录。这里先做视频记录,运营在用户详情页点开「视频记录」,就能看到这个用户发布过的所有小视频。它是内容审核的第一步:先定位,再处置。
纲要
- 业务场景:运营在用户详情页查看用户发布的视频,为违规内容处置做前置定位
- 整体链路:mf-admin(MySQL 体系)经 Dubbo 调 mf-dubbo-mongo(MongoDB),管理端复用域服务查 Mongo
- 代码实现(四个文件,一条链路):
ManagerController:GET /manage/videos,参数page/pagesize/uidManagerService:@DubboReference调VideoApi.findByUserId,透传分页参数VideoApi:mf-dubbo-interface中新增按用户查询的方法声明VideoApiImpl:MongoTemplate实现 count + 分页查询,封装PageResult- 设计取舍:视频记录直接返回
Video对象,不做 VO 转换(对比下一篇的动态列表) - 接口设计、调用时序、异常边界、验证步骤
业务场景:这个接口解决什么问题
手机端的小视频功能上线后,用户发布的内容必须有人管。运营的典型工作流是:
- 收到举报,或例行巡检用户列表;
- 进入某个用户的详情页;
- 切到「视频记录」标签页,看这个用户发过哪些视频,封面、文字、点赞评论数一目了然;
- 发现违规内容,走删除/封禁流程。
第 3 步就是这里的接口。它和前面两个接口的区别在存储:用户列表、用户详情查的是 MySQL 的 tb_user_info 表,而视频存在 MongoDB 的 video 集合里。后台系统自己不连 Mongo,而是通过 Dubbo 复用 mf-dubbo-mongo 里现成的 VideoApi,域服务作为统一数据访问层,管理端照单全收,这是项目分层设计最典型的落地场景。
整体链路与工程结构
请求从管理端前端出发,经过网关、鉴权拦截器,最终落到 Mongo:
涉及改动的四个文件分布在不同模块:
mf
├── mf-admin # 后台管理服务(MySQL 体系)
│ └── src/main/java/com/mf/admin
│ ├── controller/ManagerController.java # 新增 videos 接口
│ └── service/ManagerService.java # 新增 findAllVideos
├── mf-dubbo
│ ├── mf-dubbo-interface
│ │ └── src/main/java/com/mf/dubbo/api
│ │ └── VideoApi.java # 新增 findByUserId 声明
│ └── mf-dubbo-mongo
│ └── src/main/java/com/mf/dubbo/api
│ └── VideoApiImpl.java # 实现 findByUserId
└── mf-model
└── src/main/java/com/mf/model
├── mongo/Video.java # 复用,无需改动
└── vo/PageResult.java # 复用,无需改动
管理端只加 Controller 和 Service 两处代码,数据访问全部下沉到已有的 Dubbo 服务里,改动面很小,这正是当初把 Mongo 访问单独抽成 mf-dubbo-mongo 的回报。
代码实现
Controller:接收分页参数和用户 ID
ManagerController 里加一个方法。注意路径是 /manage/videos,用户 ID 不是路径参数而是 uid 请求参数,因为前端是从用户详情页带过来当前用户的 ID:
package com.mf.admin.controller;
import com.mf.admin.service.ManagerService;
import com.mf.model.domain.UserInfo;
import com.mf.model.vo.PageResult;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.*;
@RestController
@RequestMapping("/manage")
public class ManagerController {
@Autowired
private ManagerService managerService;
/**
* 查询指定用户发布的所有视频列表
*/
@GetMapping("/videos")
public ResponseEntity videos(@RequestParam(defaultValue = "1") Integer page,
@RequestParam(defaultValue = "10") Integer pagesize,
Long uid ) {
PageResult result = managerService.findAllVideos(page,pagesize,uid);
return ResponseEntity.ok(result);
}
}
page 和 pagesize 给了 defaultValue,前端不传也有合理默认值;uid 没有默认值,不传就是 null,这一点在后面的边界分析里会用到。
ManagerService:透传给 Dubbo 服务
ManagerService 已经通过 @DubboReference 注入了 VideoApi,补一个方法即可:
package com.mf.admin.service;
import cn.hutool.core.collection.CollUtil;
import com.baomidou.mybatisplus.core.metadata.IPage;
import com.mf.dubbo.api.MovementApi;
import com.mf.dubbo.api.UserInfoApi;
import com.mf.dubbo.api.VideoApi;
import com.mf.model.domain.UserInfo;
import com.mf.model.mongo.Movement;
import com.mf.model.vo.MovementsVo;
import com.mf.model.vo.PageResult;
import org.apache.dubbo.config.annotation.DubboReference;
import org.springframework.stereotype.Service;
import java.util.ArrayList;
import java.util.List;
import java.util.Map;
@Service
public class ManagerService {
@DubboReference
private UserInfoApi userInfoApi;
@DubboReference
private VideoApi videoApi;
@DubboReference
private MovementApi movementApi;
//查询指定用户发布的所有视频列表
public PageResult findAllVideos(Integer page, Integer pagesize, Long uid) {
return videoApi.findByUserId(page, pagesize, uid);
}
}
实读工程时确认:VideoApi 里原本只有 save、findMovementsByVids、queryVideoList 三个方法,没有「按用户 ID 查视频列表」的方法,所以这一步要同时在接口层补声明。这个方法体只有一行透传,连参数都不用加工,管理端在整条链路里就是个「转发员」。
VideoApi:接口声明
mf-dubbo-interface 模块的 VideoApi 中新增方法:
package com.mf.dubbo.api;
import com.mf.model.mongo.Video;
import com.mf.model.vo.PageResult;
import java.util.List;
public interface VideoApi {
//保存视频
String save(Video video);
//根据vid查询数据列表
List<Video> findMovementsByVids(List<Long> vids);
//分页查询数据列表
List<Video> queryVideoList(int page, Integer pagesize);
//根据用户id查询
PageResult findByUserId(Integer page, Integer pagesize, Long userId);
}
最后一个参数命名用 userId 而不是管理端的 uid,语义更明确,接口是给所有消费方看的,别把前端惯用的缩写带进 API 层。
VideoApiImpl:MongoTemplate 实现分页查询
mf-dubbo-mongo 模块的 VideoApiImpl 中实现。MongoDB 的分页套路前面已经用过:先 count 拿总数,再在同一个 Query 上追加 limit/skip 和排序,最后 find:
package com.mf.dubbo.api;
import com.mf.dubbo.utils.IdWorker;
import com.mf.model.mongo.Video;
import com.mf.model.vo.PageResult;
import org.apache.dubbo.config.annotation.DubboService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.data.domain.Sort;
import org.springframework.data.mongodb.core.MongoTemplate;
import org.springframework.data.mongodb.core.query.Criteria;
import org.springframework.data.mongodb.core.query.Query;
import java.util.List;
@DubboService
public class VideoApiImpl implements VideoApi{
@Autowired
private MongoTemplate mongoTemplate;
@Autowired
private IdWorker idWorker;
@Override
public PageResult findByUserId(Integer page, Integer pagesize, Long userId) {
Query query = Query.query(Criteria.where("userId").in(userId));
long count = mongoTemplate.count(query, Video.class);
query.limit(pagesize).skip((page -1) * pagesize)
.with(Sort.by(Sort.Order.desc("created")));
List<Video> list = mongoTemplate.find(query, Video.class);
return new PageResult(page,pagesize,count,list);
}
}
几个实现细节值得说:
- 查询条件写成
Criteria.where("userId").in(userId),单值也能用in,语义上等价于is,这里沿用了工程里已有的写法; - 先 count 再加分页参数,顺序不能反,
count要统计的是全量匹配数,如果先limit了,统计出来的就是当页条数,PageResult里的总页数就错了; - 按
created倒序,最新发的视频排在最前面,符合运营「先看最近发了什么」的直觉。
Video 实体(mf-model 模块,映射 video 集合)的字段决定了列表页能展示什么:
package com.mf.model.mongo;
import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;
import org.bson.types.ObjectId;
import org.springframework.data.mongodb.core.mapping.Document;
@Data
@NoArgsConstructor
@AllArgsConstructor
@Document(collection = "video")
public class Video implements java.io.Serializable {
private static final long serialVersionUID = -3136732836884933873L;
private ObjectId id; //主键id
private Long vid; //自动增长
private Long created; //创建时间
private Long userId;
private String text; //文字
private String picUrl; //视频封面文件,URL
private String videoUrl; //视频文件,URL
private Integer likeCount=0; //点赞数
private Integer commentCount=0; //评论数
private Integer loveCount=0; //喜欢数
}
PageResult 也是复用的老类,构造器里顺手算好了总页数:
package com.mf.model.vo;
import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;
import java.io.Serializable;
import java.util.Collections;
import java.util.List;
@Data
@AllArgsConstructor
@NoArgsConstructor
public class PageResult implements Serializable {
private Long counts = 0l;//总记录数
private Integer pagesize=10;//页大小
private Long pages = 0l;//总页数
private Integer page=1;//当前页码
private List<?> items = Collections.emptyList(); //列表
public PageResult(Integer page,Integer pagesize,
Long counts,List list) {
this.page = page;
this.pagesize = pagesize;
this.items = list;
this.counts = counts;
this.pages = counts % pagesize == 0 ? counts / pagesize : counts / pagesize + 1;
}
}
设计取舍:为什么不转 VO
对比其他接口会发现一个反差:用户列表要拼 UserInfoVo,动态列表要把 Movement 转成 MovementsVo,唯独视频记录直接把 Video 对象塞进了 PageResult。原因有两个:
| 对比项 | 用户列表 / 动态列表 | 视频记录 |
|---|---|---|
| 展示数据来源 | 单表/单集合不够,要关联 UserInfo 补昵称、头像等 | Video 自身字段已够:封面、文字、点赞/评论数都在 |
| 服务端工作量 | 查两份数据 + 逐条拼 VO | 一次查询直接返回 |
| 返回类型 | VO 对象列表 | Video 对象列表 |
Video 当初设计时就带了 text、picUrl、计数器这些冗余字段,列表页要什么它自己全有,再转一层 VO 纯属白写代码。接口文档也明确要求返回的就是 Video 对象。反过来看动态列表:Movement 里没有发布者的昵称头像,必须再调一次 userInfoApi.findByIds 回填,VO 转换躲不掉。要不要转 VO,取决于领域对象自带的信息够不够,不是固定套路。
还要注意一个跨存储细节:Video 的 id 是 ObjectId 类型,经 Dubbo 传输 + JSON 序列化后,前端拿到的是字符串形式,直接拿它当主键用没有问题。
接口设计
| 项目 | 内容 |
|---|---|
| 请求路径 | /manage/videos |
| 请求方式 | GET |
| 请求参数 | page(页码,默认 1)、pagesize(页大小,默认 10)、uid(目标用户 ID,必传) |
| 返回值 | PageResult,items 为 Video 对象列表 |
| 鉴权 | 请求头 Authorization: Bearer <token>,TokenInterceptor 校验 |
请求示例:
GET /manage/videos?page=1&pagesize=10&uid=106
Authorization: Bearer eyJhbGciOiJIUzI1NiJ9...
响应示例(106 号用户发过一条带文字的视频):
{
"counts": 1,
"pagesize": 10,
"pages": 1,
"page": 1,
"items": [
{
"id": "6150b3f4e4b0a1a2b3c4d5e6",
"vid": 1000000000001,
"created": 1632679668000,
"userId": 106,
"text": "我就是我不一样的烟火",
"picUrl": "https://mf-dev.oss-cn-zhangjiakou.aliyuncs.com/images/v/pic.jpg",
"videoUrl": "https://mf-dev.oss-cn-zhangjiakou.aliyuncs.com/images/v/video.mp4",
"likeCount": 12,
"commentCount": 3,
"loveCount": 5
}
]
}
调用时序
从浏览器点击到数据回显的完整过程:
异常与边界
| 场景 | 实际行为 | 说明 |
|---|---|---|
| 用户没发过视频 | count=0,items 空列表,pages=0 | 前端展示「暂无视频记录」,接口层不报错 |
uid 不传 | userId=null,查询条件失效,返回全量视频 | 隐患:本意是分页查全部视频,uid=null 时 Criteria.where("userId").in(null) 的行为依赖驱动版本,建议生产代码里对 uid 做非空校验 |
| 分页越界(page 超过总页数) | 返回空 items,counts 仍是总数 | Mongo 的 skip 越过末尾自然返回空,无需特殊处理 |
| 视频已被删除(管理端删 OSS 文件) | 集合记录若未同步清理,列表仍返回记录,但封面/播放失效 | 删除操作要同时清 Mongo 记录与 OSS 文件,避免「引用失效」的死链 |
| Dubbo 调用失败(mongo 服务未启动) | 抛 RpcException,由 ExceptionAdvice 统一转错误响应 | 管理端可提示「服务繁忙」;查列表类接口重试成本低,前端刷新即可 |
这里最值得展开的是 uid 为空的情况。写代码时 Long uid 没有 @RequestParam 强制注解,Spring 对没值的包装类型就注入 null。课堂演示环境数据量小看不出问题,等集合里有几万条视频,一次「忘传 uid」就是全表分页扫描。稳妥写法是入口处直接拦截:
if (uid == null) {
throw new BusinessException("uid 不能为空");
}
验证步骤
课堂环境的验证路径,照做一遍就能确认链路通:
-
造数:没有现成数据就用手机端 106 号用户发布一条视频;也可以直接往 Mongo 里插一条:
// mongosh,mf 库 db.video.insertOne({ vid: NumberLong("1000000000002"), userId: NumberLong(106), text: "测试视频", picUrl: "https://example.com/pic.jpg", videoUrl: "https://example.com/video.mp4", likeCount: NumberInt(0), commentCount: NumberInt(0), loveCount: NumberInt(0), created: NumberLong(1632679668000) })
注意 userId 的类型要和实体里的 Long 对应,用 NumberLong 包一下,不然 Criteria.where("userId").in(106) 匹配不上。
-
重启服务:改了
mf-admin、mf-dubbo-interface、mf-dubbo-mongo三个模块,Dubbo 服务端(DubboMongoApplication)和消费端(admin)都要重启;接口有变更,interface 所在的提供方必须重新部署,否则消费端找不到新方法。 -
列表核对:浏览器登录后台,进入用户详情页切到「视频记录」,能看到刚发的视频,点开可自动播放。
-
分页验证:给 106 号用户多插几条数据,把
pagesize改成 2 请求,核对pages是否等于ceil(counts/2)、翻页顺序是否按发布时间倒序。 -
对照数据库:在 MongoDB 客户端里定位
video集合,核对text字段内容与页面展示一致,页面上的「文字动态」就来自这个字段。手机端发布视频时如果没填文字,这一列就是空的,属正常现象。
常见误解澄清
| 误解 | 实际情况 |
|---|---|
接口路径是 /manage/users/{id}/videos,ID 在路径里 | 实读工程是 GET /manage/videos,用户 ID 通过 uid 请求参数传递,不在路径中 |
返回值是 VideoVo | 接口约定直接返回 Video 对象,PageResult.items 里就是领域对象,没有 VO 转换这一步 |
| 查视频要同时连 MySQL 和 MongoDB | 管理端全程不碰 Mongo,@DubboReference 远程调用 VideoApi,由 mf-dubbo-mongo 统一访问 |
count 和 find 要用两个不同的 Query 对象 | 同一个 Query 先 count(此时无分页参数),再追加 limit/skip/sort 后 find,复用条件对象 |
| 视频记录要展示发布者昵称头像,得补查 UserInfo | 后台前端在用户详情页里已经拿到用户资料,视频列表只需带 userId 关联,无需回填 |
总结
- 视频记录接口
GET /manage/videos只有十几行业务代码:Controller 收参数,Service 一行透传,真正的分页逻辑在VideoApiImpl里用MongoTemplate完成。 - 这篇最有价值的是链路而非代码:管理端(MySQL 体系)通过 Dubbo 复用域服务查 MongoDB。
mf-dubbo-mongo作为视频数据的唯一访问入口,管理端不用加 Mongo 依赖、不用懂查询语法,域服务的复用价值在这里体现得最直白。 - 「要不要转 VO」由数据自足性决定:
Video字段齐全就直接返回,缺关联信息(如动态列表缺发布者资料)才做转换。 - 留了一个生产级隐患:
uid可空导致查询条件失效,入口校验值得补上。
下一篇用户管理:查看动态列表处理同页签的另一类记录,动态(Movement)的查询要关联用户资料并转 MovementsVo,正好和这里的「不转 VO」形成对照。
1878



被折叠的 条评论
为什么被折叠?



