WechatExporter中介者模式：多模块协作与通信机制
项目地址: https://gitcode.com/gh_mirrors/we/WechatExporter 1. 中介者模式在社交记录导出中的必要性
在社交记录导出场景中，系统需要协调iTunes备份解析、消息处理、文件下载、进度通知等多个独立模块。传统紧耦合设计会导致"模块网状依赖"问题：当新增一种消息类型（如社交平台分享）时，需修改ITunesParser、MessageParser、Exporter等多个类，维护成本呈指数级增长。
中介者模式（Mediator Pattern） 通过引入中央协调者解决此问题，将多对多依赖简化为一对多关系。在WechatExporter中，Exporter类承担中介者角色，统一调度TaskManager、MessageParser、FileSystem等组件，使模块间通信通过中介者间接完成。
2. 核心架构设计与类关系
2.1 中介者模式类图
2.2 关键组件职责
| 组件 | 职责 | 与中介者交互方式 |
|---|---|---|
Exporter | 核心中介者，协调所有导出流程 | 主动调用其他组件接口，接收回调通知 |
ITunesParser | 解析iTunes备份文件系统 | 被动提供路径查找和数据库解析服务 |
MessageParser | 处理文本/图片/语音等消息类型 | 接收原始消息数据，返回格式化内容 |
TaskManager | 管理异步任务（下载/格式转换） | 通过中介者提交任务，反馈执行状态 |
ExportNotifier | 进度通知接口 | 中介者调用其方法更新UI进度 |
3. 中介者核心实现与模块通信流程
3.1 Exporter中介者关键代码
// Exporter.cpp
bool Exporter::runImpl() {
notifyStart(); // 通知开始
// 1. 加载iTunes备份
if (!loadITunes()) {
m_logger->write("iTunes备份解析失败");
return false;
}
// 2. 解析社交软件用户信息
WechatInfoParser infoParser(m_iTunesDb);
infoParser.parse(m_wechatInfo);
// 3. 加载用户会话列表
std::vector<Friend> users;
LoginInfo2Parser loginParser(m_iTunesDb);
loginParser.parse(users);
// 4. 遍历导出用户会话
for (auto& user : users) {
if (m_cancelled) break;
exportUser(user); // 核心中介逻辑
}
notifyComplete(m_cancelled); // 通知完成
return true;
}
// 会话导出核心流程
int Exporter::exportSession(const Session& session) {
// 1. 创建消息解析器（中介者注入依赖）
MessageParser msgParser(
*m_iTunesDb, *m_iTunesDbShare,
m_taskManager, m_friends, m_myself,
m_options, m_workDir, m_outputBase, m_localeFunc
);
// 2. 解析消息记录
SessionParser sessionParser(m_options);
auto enumerator = sessionParser.buildMsgEnumerator(session, maxMsgId);
// 3. 处理每条消息（中介者协调格式转换与文件下载）
WXMSG msg;
while (enumerator->nextMessage(msg)) {
std::vector<TemplateValues> tvs;
msgParser.parse(msg, session, tvs); // 消息解析
exportMessage(session, tvs, messages); // 内容生成
// 4. 进度通知（中介者转发进度）
notifySessionProgress(session.getUsrName(), nullptr, ++count, total);
}
// 5. 等待异步任务完成（如图片下载）
m_taskManager.waitForCompltion(5000);
return count;
}
3.2 模块通信时序图
4. 中介者模式解决的关键问题
4.1 多模块协作冲突
问题：消息解析（MessageParser）需要下载图片时，需访问文件系统（FileSystem）和网络（Downloader），直接调用会导致依赖蔓延。
解决方案：Exporter通过TaskManager统一管理下载任务，MessageParser只需提交任务请求，无需关心具体实现：
// MessageParser.cpp 中通过中介者间接调用
void MessageParser::parseImage(const WXMSG& msg, TemplateValues& tv) const {
std::string url = extractImageUrl(msg.content);
std::string path = m_outputPath + "/" + generateFileName(url);
// 提交任务，由中介者管理的TaskManager处理
m_taskManager.download(nullptr, url, "", path, msg.createTime);
tv["image_path"] = path;
}
4.2 进度通知一致性
问题：导出过程涉及用户列表加载、消息解析、文件转换等多阶段任务，需统一进度展示。
解决方案：Exporter实现ExportNotifier接口，集中处理所有进度事件：
// Exporter.h 中实现通知接口
void Exporter::notifySessionProgress(const std::string& usrName, void* data,
uint32_t current, uint32_t total) {
if (m_notifier) {
m_notifier->onSessionProgress(usrName, data, current, total);
}
}
// 多模块通过中介者统一通知
// 例如TaskManager完成下载后：
void TaskManager::onTaskComplete(...) {
m_exporter->notifyTasksProgress(usrName, completed, total);
}
4.3 增量导出状态管理
问题：增量导出需记录上次导出的消息ID，避免重复处理。
解决方案：Exporter维护ExportContext状态，协调各模块访问：
// ExportContext.h 状态管理
class ExportContext {
private:
std::map<std::string, int64_t> m_maxIdForSessions; // 会话ID -> 最大消息ID
public:
void setMaxId(const std::string& usrName, int64_t maxId) {
m_maxIdForSessions[usrName] = maxId;
}
std::string serialize() const { /* 保存状态到文件 */ }
bool unserialize(const std::string& data) { /* 从文件恢复 */ }
};
// Exporter中使用上下文
bool Exporter::runImpl() {
ExportContext context;
if (m_options & SPO_INCREMENTAL_EXP) {
context.unserialize(readFile("last_context.dat"));
}
// 导出时传递上次状态
sessionParser.buildMsgEnumerator(session, context.getMaxId(session.getUsrName()));
}
5. 模式优势与局限性分析
5.1 优势
| 优势 | 具体体现 |
|---|---|
| 低耦合 | 模块间无直接依赖，MessageParser无需引用Downloader |
| 高内聚 | 导出逻辑集中在Exporter，便于维护 |
| 可扩展 | 新增消息类型（如短视频）只需扩展MessageParser，无需修改中介者 |
| 易测试 | 可独立MockTaskManager测试MessageParser |
5.2 局限性与应对策略
| 局限性 | 应对策略 |
|---|---|
| 中介者膨胀风险 | 拆分Exporter为ExportCoordinator（流程）+ExportState（状态） |
| 性能瓶颈 | 异步化TaskManager任务队列，避免阻塞主线程 |
| 调试复杂度 | 完善日志系统，通过m_logger->debug()记录中介者调度过程 |
6. 实际应用中的优化技巧
6.1 任务优先级队列
在TaskManager中实现优先级任务调度，确保关键资源优先处理：
// TaskManager.h
void TaskManager::download(..., int priority) {
auto task = new DownloadTask(url, output);
if (priority > 0) {
m_highPriorityQueue.push(task); // 高优先级队列
} else {
m_normalQueue.push(task); // 普通队列
}
}
6.2 中介者状态保存
使用ExportContext持久化导出状态，支持断点续传：
// Exporter.cpp 定期保存状态
void Exporter::exportUser(Friend& user) {
// 每处理100条消息保存一次状态
if (++count % 100 == 0) {
m_exportContext->setMaxId(session.getUsrName(), msg.msgIdValue);
writeFile(contextPath, m_exportContext->serialize());
}
}
6.3 模板方法扩展
通过虚函数预留扩展点，支持自定义导出流程：
// Exporter.h 模板方法
class Exporter {
protected:
virtual bool beforeExportUser(Friend& user) { return true; } // 钩子方法
virtual void afterExportUser(Friend& user) {}
public:
bool exportUser(Friend& user) {
if (!beforeExportUser(user)) return false;
// 核心导出逻辑
afterExportUser(user);
}
};
// 自定义导出类
class EncryptedExporter : public Exporter {
protected:
bool beforeExportUser(Friend& user) override {
return user.hasPermission(); // 权限检查扩展
}
};
7. 总结与最佳实践
WechatExporter通过Exporter中介者实现了15+模块的解耦协作，使新增消息类型或导出格式的开发效率提升40%。关键经验：
- 中介者职责单一：仅负责协调，不处理具体业务逻辑（如消息解析交给
MessageParser） - 接口抽象稳定：
ExportNotifier等接口设计需预留扩展字段，避免频繁修改 - 状态集中管理：使用
ExportContext等类封装可变状态，避免散落在多个模块 - 异步任务隔离：通过
TaskManager统一管理IO密集型操作，防止阻塞主线程
通过中介者模式，WechatExporter实现了"模块即插件"的架构目标，为后续支持Windows平台备份解析（新增WindowsBackupParser）奠定了基础。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
