概述
后台运营需要查看某个用户发布了哪些动态,这条链路要跨两次存储:动态在 MongoDB,发布人资料在 MySQL,最后还要把实体转成带用户信息的 MovementsVo 再返回,这正是它和视频列表「直接返回实体」最大的差别。
纲要
- 业务场景:内容管理中的动态查看,与动态审核共用同一接口
- state 状态字段:动态审核状态机(0 未审核 / 1 通过 / 2 驳回)
- 接口设计:
GET /manage/messages,uid 与 state 均为可选条件 - 完整代码链路(四层):
ManagerController#messages:接口入口ManagerService#findAllMovements:Dubbo 调用 + VO 转换 + 用户资料批查MovementApi#findByUserId:接口重载(新增 4 参版本)MovementApiImpl#findByUserId:MongoDB 动态条件查询 + 分页- 核心对照:动态列表转 MovementsVo vs 视频列表直接返回实体
- 异常与边界、验证要点、常见误解
业务场景:为什么动态列表接口比较特殊
这个接口除了在用户资料页面使用,还会被动态审核页面复用,已审核、待审核、已驳回的动态,查的都是同一个接口。
这就解释了两个设计:
- state 参数存在的原因。动态发布时并不直接对外可见,
Movement实体里有一个state字段(mf-model 的com.mf.model.mongo.Movement,实读确认):
private Integer state = 0;//状态 0:未审(默认),1:通过,2:驳回
发布动态时默认落库为 0(未审核),审核通过改成 1,驳回改成 2。动态审核页面按 state 过滤,用户管理页面按 uid 过滤,同一个接口两种用法。
- uid 与 state 都是可选参数。查某用户的动态传 uid;审核页看全部动态则两个都不传。所以查询条件必须动态拼接,不能写死。
接口文档与参数
接口文档中给出的路径是「杠 manager 杠 messages」,但工程实读 ManagerController 上的类级注解是 @RequestMapping("/manage"),实际路径为 /manage/messages,接口文档与代码不一致时,以代码为准。
| 项目 | 内容 |
|---|---|
| 请求路径 | GET /manage/messages(文档写 /manager/messages,与代码不符) |
| 请求方式 | GET |
| page | 页码,默认 1 |
| pagesize | 每页条数,默认 10 |
| uid | 用户 ID,可选;传了就按发布人过滤 |
| state | 动态状态,可选;0 未审核 / 1 通过 / 2 驳回 |
| 返回 | PageResult,items 为 MovementsVo 列表 |
请求与响应示例:
// 请求:GET /manage/messages?uid=106&page=1&pagesize=10
{
"page": 1,
"pagesize": 10,
"counts": 10,
"pages": 1,
"items": [
{
"id": "5f4c9a6e2b3e4a1f8c7d9e01",
"userId": 106,
"avatar": "https://mf.com/avatar/106.png",
"nickname": "黑逗",
"gender": "woman",
"age": 24,
"tags": ["健身", "旅行"],
"textContent": "今天天气不错~",
"imageContent": ["https://mf.com/img/106_1.png"],
"distance": "500米",
"createDate": "2020-09-01 12:30:00",
"likeCount": 0,
"commentCount": 0,
"loveCount": 0,
"hasLiked": 0,
"hasLoved": 0
}
]
}
注意 items 里同时有动态内容(textContent、imageContent)和发布人资料(avatar、nickname、gender、age、tags),这就是转 VO 的直接动机。
完整代码链路
后台系统涉及模块如下(实读 09-后台系统/01-代码/mf/mf):
mf
├── mf-admin # 管理后台(本篇的 Controller/Service)
│ └── src/main/java/com/mf/admin
│ ├── controller/ManagerController.java # GET /manage/messages
│ └── service/ManagerService.java # Dubbo 调用 + VO 转换
├── mf-dubbo
│ ├── mf-dubbo-interface
│ │ └── com/mf/dubbo/api/MovementApi.java # 接口定义(含 4 参重载)
│ └── mf-dubbo-mongo
│ └── com/mf/dubbo/api/MovementApiImpl.java # MongoDB 实现
└── mf-model
├── com/mf/model/mongo/Movement.java # 动态实体(MongoDB)
└── com/mf/model/vo/MovementsVo.java # 动态 VO(含用户资料)
Controller:动态列表接口
实读 mf-admin/src/main/java/com/mf/admin/controller/ManagerController.java:
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("/messages")
public ResponseEntity messages(@RequestParam(defaultValue = "1") Integer page,
@RequestParam(defaultValue = "10") Integer pagesize,
Long uid,Integer state) {
PageResult result = managerService.findAllMovements(page,pagesize,uid,state);
return ResponseEntity.ok(result);
}
}
(文件里还有 /users、/users/{userId}、/videos 三个兄弟接口,此处省略。)
参数上只有一个细节:page 和 pagesize 用 @RequestParam(defaultValue = ...) 给了默认值,uid 和 state 则保持可选,不传就是 null,交给下层判断。
Service:Dubbo 查动态 + 转 MovementsVo
实读 mf-admin/src/main/java/com/mf/admin/service/ManagerService.java 的 findAllMovements:
package com.mf.admin.service;
import cn.hutool.core.collection.CollUtil;
import com.mf.dubbo.api.MovementApi;
import com.mf.dubbo.api.UserInfoApi;
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 MovementApi movementApi;
//查询动态
public PageResult findAllMovements(Integer page, Integer pagesize, Long uid, Integer state) {
//1、调用API查询数据 :Movement对象
PageResult result = movementApi.findByUserId(uid,state,page,pagesize);
//2、解析PageResult,获取Movement对象列表
List<Movement> items = (List<Movement>) result.getItems();
//3、一个Movement对象转化为一个Vo
if(CollUtil.isEmpty(items)) {
return new PageResult();
}
List<Long> userIds = CollUtil.getFieldValues(items, "userId", Long.class);
Map<Long, UserInfo> map = userInfoApi.findByIds(userIds, null);
List<MovementsVo> vos = new ArrayList<>();
for (Movement movement : items) {
UserInfo userInfo = map.get(movement.getUserId());
if(userInfo != null) {
MovementsVo vo = MovementsVo.init(userInfo, movement);
vos.add(vo);
}
}
//4、构造返回值
result.setItems(vos);
return result;
}
}
这段方法分四步,每步都有值得说的点:
- 第一步通过
@DubboReference注入的movementApi发起 RPC,拿到装着Movement实体的PageResult。 - 第二步把
items强转回List<Movement>。PageResult.items是List类型,泛型信息在序列化传输中丢失,强转是这类通用分页对象的常见代价。 - 第三步是跨存储组装:
CollUtil.getFieldValues(items, "userId", Long.class)一次性提取本页所有发布人 ID(去重前的原始列表),再调userInfoApi.findByIds(userIds, null)批量查 MySQL 里的UserInfo,返回Map<Long, UserInfo>。批查避免了循环内逐条 RPC,这是 N+1 问题的标准解法。 - 第四步把
result.items替换成 VO 列表后返回。注意空判断放的位置:CollUtil.isEmpty(items)成立时直接return new PageResult(),跳过后面所有 Dubbo/DB 交互。
userInfo != null 的判断是防资料缺失(比如用户被删)导致 map.get 返回 null 进 init 抛 NPE,代价是这类「孤儿动态」会从列表里静默消失,总条数 counts 却没减,页数会对不上,边界一节再说。
MovementApi:接口重载
实读 mf-dubbo-interface/src/main/java/com/mf/dubbo/api/MovementApi.java,接口里同时存在两个 findByUserId:
package com.mf.dubbo.api;
import com.mf.model.mongo.Movement;
import com.mf.model.vo.PageResult;
import java.util.List;
public interface MovementApi {
//发布动态
void publish(Movement movement);
//根据用户id,查询此用户发布的动态数据列表
PageResult findByUserId(Long userId, Integer page, Integer pagesize);
//根据用户id,查询用户好友发布的动态列表
List<Movement> findFriendMovements(Integer page, Integer pagesize, Long userId);
//根据pid数组查询动态
List<Movement> findMovementsByPids(List<Long> pids);
//随机获取多条动态数据
List<Movement> randomMovements(Integer counts);
//根据id查询
Movement findById(String movementId);
//根据用户id,查询
PageResult findByUserId(Long uid, Integer state, Integer page, Integer pagesize);
}
3 参版本是 App 端个人主页早先就在用的;后台侧新增了 4 参重载(多出 state),实现时既可以改造旧方法,也可以新建一个方法,为避免影响已有调用,这里选择新建。用重载而非改签名,App 端调用方完全不受影响,这是给已有接口加可选条件的稳妥做法。
MovementApiImpl:MongoDB 动态条件查询
实读 mf-dubbo-mongo/src/main/java/com/mf/dubbo/api/MovementApiImpl.java 的 4 参实现:
package com.mf.dubbo.api;
import com.mf.dubbo.utils.IdWorker;
import com.mf.dubbo.utils.TimeLineService;
import com.mf.model.mongo.Movement;
import com.mf.model.mongo.MovementTimeLine;
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 MovementApiImpl implements MovementApi {
@Autowired
private MongoTemplate mongoTemplate;
@Override
public PageResult findByUserId(Long uid, Integer state, Integer page, Integer pagesize) {
Query query = new Query();
if(uid != null) {
query.addCriteria(Criteria.where("userId").is(uid));
}
if(state != null) {
query.addCriteria(Criteria.where("state").is(state));
}
//查询总数
long count = mongoTemplate.count(query, Movement.class);
//设置分页参数
query.with(Sort.by(Sort.Order.desc("created"))).limit(pagesize).skip((page -1) * pagesize);
List<Movement> list = mongoTemplate.find(query, Movement.class);
return new PageResult(page,pagesize,count,list);
}
}
三个要点:
- 条件动态拼接:
new Query()起手是空条件,uid、state 各自判空后才addCriteria。两个都不传时查全表分页,正好服务动态审核的「查询全部」场景。 - count 在 limit/skip 之前:先用只含条件的 query 查总数,再往同一个 query 上追加排序、limit、skip 去查列表。顺序反了 count 就会被分页参数影响。
- 按 created 倒序:最新动态排前面,符合后台浏览习惯。
MovementsVo:动态 + 用户资料的组装载体
实读 mf-model/src/main/java/com/mf/model/vo/MovementsVo.java(完整文件):
package com.mf.model.vo;
import com.mf.model.domain.UserInfo;
import com.mf.model.mongo.Movement;
import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;
import org.springframework.beans.BeanUtils;
import org.springframework.util.StringUtils;
import java.io.Serializable;
import java.text.SimpleDateFormat;
import java.util.Date;
@Data
@NoArgsConstructor
@AllArgsConstructor
public class MovementsVo implements Serializable {
private String id; //动态id
private Long userId; //用户id
private String avatar; //头像
private String nickname; //昵称
private String gender; //性别 man woman
private Integer age; //年龄
private String[] tags; //标签
private String textContent; //文字动态
private String[] imageContent; //图片动态
private String distance; //距离
private String createDate; //发布时间 如: 10分钟前
private Integer likeCount = 0; //点赞数
private Integer commentCount = 0; //评论数
private Integer loveCount = 0; //喜欢数
private Integer hasLiked; //是否点赞(1是,0否)
private Integer hasLoved; //是否喜欢(1是,0否)
public static MovementsVo init(UserInfo userInfo, Movement item) {
MovementsVo vo = new MovementsVo();
//设置动态数据
BeanUtils.copyProperties(item, vo);
vo.setId(item.getId().toHexString());
//设置用户数据
BeanUtils.copyProperties(userInfo, vo);
if(!StringUtils.isEmpty(userInfo.getTags())) {
vo.setTags(userInfo.getTags().split(","));
}
//图片列表
vo.setImageContent(item.getMedias().toArray(new String[]{}));
//距离
vo.setDistance("500米");
Date date = new Date(item.getCreated());
vo.setCreateDate(new SimpleDateFormat("yyyy-MM-dd HH:mm:ss").format(date));
//设置是否点赞(后续处理)
vo.setHasLoved(0);
vo.setHasLiked(0);
return vo;
}
}
init 静态工厂做了几处实体直出做不到的转换:
Movement.id是 MongoDB 的ObjectId,JSON 序列化会带一堆内部字段,toHexString()转成 24 位十六进制字符串。- 两次
BeanUtils.copyProperties:先拷动态(同名字段 userId、textContent 等自动对齐),再拷用户资料(avatar、nickname、gender、age 覆盖进去)。 tags在UserInfo里是逗号分隔字符串,VO 里拆成数组;medias是List<String>,转成数组。created是毫秒时间戳,格式化成yyyy-MM-dd HH:mm:ss。
后台展示头像、昵称这些发布人信息,只有 VO 能承载,实体 Movement 里没有这些字段。
对照:转 VO vs 不转 VO
上一节视频列表的 Service 实读只有一行:
//查询指定用户发布的所有视频列表
public PageResult findAllVideos(Integer page, Integer pagesize, Long uid) {
return videoApi.findByUserId(page, pagesize, uid);
}
同样是从 MongoDB 查列表,视频直接把实体 Video 塞进 PageResult 返回,动态却多出一整套 VO 组装。两个接口放在一张表里对比:
| 维度 | 视频列表 /manage/videos | 动态列表 /manage/messages |
|---|---|---|
| 查询条件 | uid(必传语义) | uid、state 均可选,动态拼接 |
| API 方法 | videoApi.findByUserId(page, pagesize, uid) | movementApi.findByUserId(uid, state, page, pagesize) |
| 返回内容 | Video 实体直出 | MovementsVo(动态 + 用户资料批查组装) |
| 跨存储 | 无 | Mongo 查动态后还要批查 MySQL 用户资料 |
| 消费场景 | 用户管理页 | 用户管理页 + 动态审核页(共用) |
为什么这里转、那里不转?拆开看有两层原因:
- 展示需求确实不同。
MovementsVo.init里做的 ObjectId 转字符串、时间戳格式化、tags 拆数组,这些是「给前端直接渲染」的准备;动态列表在产品上要展示发布人头像昵称,资料批查不可省。视频列表当时只要「列出这个用户发过哪些视频」,实体字段够用。 - 但更诚实的评价是工程实现不一致。同一个后台、同类列表接口,一个转 VO 一个直出实体,前端拿到的数据契约不一样(id 格式、时间格式都不同),维护成本高。合理推断作者当时是按页面临时驱动:页面要什么补什么。落地时建议统一,要么都走 VO,要么至少抽一个公共转换层,别让每个 Service 自己发明组装逻辑。
流程时序图
一次请求里 Dubbo 走了两次、动了两个存储:Mongo 出动态,MySQL 出资料,在 admin 服务内存里拼成 VO。这是典型的跨存储组装,拼装逻辑放在消费方(admin)而不是提供方(mongo 服务),因为提供方只该管自己的存储。
异常与边界
| 场景 | 实际行为 | 风险与建议 |
|---|---|---|
| 用户无动态 | items 为空,返回 new PageResult()(全空对象) | page/pagesize/count 全部丢失,前端拿到的是「零值」而非「该页为空」。更稳妥是返回带分页参数、items 为空列表的 PageResult |
| 分页越界(page 很大) | skip 超过总数,find 返回空列表,count 仍正确 | 前端据 count 渲染页码即可,不算缺陷;但空列表会走到转 VO 分支并返回 items 为空,行为与「无动态」分支不一致 |
| 用户资料缺失 | map.get 返回 null,该动态被跳过 | counts 包含这条「孤儿动态」,VO 列表却比 counts 少,可能出现空页。审核场景宁可占位展示也别静默丢数据 |
| uid 传 null | 4 参实现里 uid != null 判断后不拼条件,查全部用户动态 | 这是有意设计(审核页查全部)。对比视频列表 3 参实现写的 Criteria.where("userId").in(userId),uid 为 null 时 in(null) 行为依赖驱动版本,是隐患写法;本节用 is(uid) + 判空,才是正确姿势 |
| state 传非法值(如 5) | 条件照常拼接,查不到数据返回空列表 | 后端未做枚举校验;严格做法是 @Min/@Max 或自定义校验注解拦截 |
| Dubbo 调用失败 | 无降级配置,异常直接上抛,接口 500 | 可在 @DubboReference 上配 timeout、retries,必要时加 mock 或 try-catch 返回友好错误 |
验证要点
按机翻稿的实测口径,重启 admin、dubbo-mongo、dubbo-mysql 三个服务后:
- 造数:确保 MongoDB
movement集合有数据(此时库里 state 全是 0,即全部待审核)。 - 按人核对:浏览器访问
/manage/messages?uid=106,106 号用户应显示 10 条动态;换成uid=1应为 2 条。 - 按状态核对:访问
/manage/messages?state=0(待审核)应返回全部;state=1(已审核)、state=2(已驳回)此时应为空,审核功能在后续章节才实现。 - 核对 VO 字段:响应 items 里应能看到 avatar、nickname、age、tags 等用户资料字段,id 为 24 位十六进制字符串,createDate 为
yyyy-MM-dd HH:mm:ss格式;如果这些字段缺失或为 null,说明资料批查或init转换环节有问题。 - 分页核对:counts 应等于该用户动态总数,改 page 后 items 按 created 倒序偏移。
常见误解澄清
| 误解 | 澄清 |
|---|---|
| 「接口路径是 /manager/messages」 | 接口文档/PPT 写的是这个,但实读代码类级注解是 @RequestMapping("/manage"),实际路径 /manage/messages |
| 「state 是动态的可见状态」 | 是审核状态:0 未审核(发布默认值)、1 通过、2 驳回,服务的是内容审核流程 |
| 「uid 不传会报错」 | 不会。uid、state 都可选,都不传就是查全量动态,动态审核页就是这么用的 |
| 「PageResult 里已经是 VO 了」 | 不是。Dubbo 拿回来的 items 是 Movement 实体,转 VO 发生在 admin 的 Service 里,API 层不感知 VO |
| 「转 VO 是因为 MongoDB 实体不能序列化」 | Movement 可正常走 Dubbo(需实现 Serializable)。转 VO 的真实动机是前端要动态+发布人资料的聚合视图 |
| 「视频列表也应该转 VO,代码漏了」 | 不是漏,是按页面临时驱动的实现不一致;是否补齐属于工程规范决策,不是 bug |
总结
GET /manage/messages一个接口服务两个页面:用户管理按 uid 查,动态审核按 state 查,条件动态拼接是关键。- 链路四层:Controller 收参 → Service 通过
@DubboReference调MovementApi4 参重载 → mongo 服务动态条件查 Mongo 并分页 → Service 批查 MySQL 用户资料、MovementsVo.init组装后替换 items。 - 与视频列表的本质差异是 VO 转换:动态列表要ObjectId 转字符串、时间格式化、用户资料聚合;视频列表实体直出。这是展示需求差异,也是工程不一致,建议后续统一。
- 批查资料(
getFieldValues+findByIds)替代循环单查,是跨存储组装里规避 N+1 的标准手法。
下一篇收官用户管理模块:用户管理:总结。
186



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



