接手同事的微信接口代碼,核心處理函數超過 300 行,巢狀 if (msgType == "text") ... else if (msgType == "event") { if (eventType == "subscribe") ... } 結構導致:
// 基礎消息
public abstract class PostMessage {
public String ToUserName, FromUserName, CreateTime, MsgType;
public static PostMessage FromXml(String xml) { /* 統一解析 */ }
}
// 具體消息類型
public class TextMessage extends PostMessage { public String Content; }
public class ImageMessage extends PostMessage { public String PicUrl, MediaId; }
public class EventMessage extends PostMessage { public String Event, EventKey; }
// ... Voice, Video, Location, Link 等
public abstract class MessageProcessor {
// 統一入口:雙重分發(MsgType → EventType)
public ReplyMessage process(String xml) {
PostMessage msg = PostMessage.FromXml(xml);
return dispatch(msg);
}
protected ReplyMessage dispatch(PostMessage msg) {
switch (msg.MsgType) {
case "text": return processText((TextMessage) msg);
case "image": return processImage((ImageMessage) msg);
case "event": return dispatchEvent((EventMessage) msg);
// ... 其他類型
default: return unhandled(msg);
}
}
// 事件二級分發
protected ReplyMessage dispatchEvent(EventMessage msg) {
switch (msg.Event.toLowerCase()) {
case "subscribe": return processSubscribe((SubscribeEvent) msg);
case "unsubscribe": return processUnsubscribe((UnsubscribeEvent) msg);
case "click": return processClick((ClickEvent) msg);
case "scan": return processScan((ScanEvent) msg);
case "location": return processLocation((LocationEvent) msg);
default: return unhandledEvent(msg);
}
}
// ── 受保護的擴展點:子類按需重寫 ──
protected ReplyMessage processText(TextMessage msg) { return defaultReply(msg); }
protected ReplyMessage processImage(ImageMessage msg) { return defaultReply(msg); }
protected ReplyMessage processSubscribe(SubscribeEvent msg) { return defaultReply(msg); }
// ... 其他具體處理方法
protected ReplyMessage defaultReply(PostMessage msg) {
String tip = (msg instanceof EventMessage)
? ((EventMessage) msg).Event + " event not processed"
: msg.MsgType + " message not processed";
return new TextReply(msg, tip);
}
protected ReplyMessage unhandled(PostMessage msg) { return defaultReply(msg); }
protected ReplyMessage unhandledEvent(EventMessage msg) { return defaultReply(msg); }
}
public class WeChatMessageProcessor extends MessageProcessor {
@Override
protected ReplyMessage processText(TextMessage msg) {
String content = msg.Content;
// 業務邏輯:關鍵字回覆、客服轉發、NLP 意圖識別...
return new TextReply(msg, "收到文本:" + content);
}
@Override
protected ReplyMessage processSubscribe(SubscribeEvent msg) {
String key = msg.EventKey; // 掃碼場景值
String welcome = "歡迎關注";
if (key != null && !key.isEmpty()) {
// 解析場景值,查詢門店名等
welcome += " " + outletService.getNameBySceneId(key);
}
return new TextReply(msg, welcome);
}
@Override
protected ReplyMessage processClick(ClickEvent msg) {
return menuService.handleClick(msg.EventKey, msg.FromUserName);
}
// 其他具體實現...
}
@RestController
@RequestMapping("/wechat")
public class WeChatController {
@Autowired
private WeChatMessageProcessor processor; // 單例 Bean
@PostMapping
public String handle(@RequestBody String xml) {
ReplyMessage reply = processor.process(xml);
return reply.toXml(); // 統一序列化
}
}
| 指標 | 重構前 | 重構後 |
|---|---|---|
| 核心方法行數 | 300+ | ~30 (調度邏輯) |
| 新增消息類型修改點 | 核心方法 + 多處 | 新增 1 個具體類/方法 |
| 單元測試覆蓋率 | < 20% | > 90% (每類獨立測試) |
| 圈複雜度 | > 50 | < 5 (單方法) |
| 支持 AOP 攔截 | 極難 | 自然支持 (Spring AOP 切面) |