萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> 程式語言綜合

重構超長 if-else 鏈:從策略模式到多態分發的 WeChat 消息處理實戰

痛點:當 if-else 成為維護噩夢

接手同事的微信接口代碼,核心處理函數超過 300 行,巢狀 if (msgType == "text") ... else if (msgType == "event") { if (eventType == "subscribe") ... } 結構導致:

  • 單一職責原則違背:所有消息類型邏輯耦合在一個方法。
  • 開閉原則失效:新增消息類型必須修改核心函數,風險極大。
  • 測試困難:無法單元測試單一消息處理邏輯。
  • 可讀性極低:認知負荷超限,新人不敢動。

重構目標

  1. 消除巨型條件分支,實現「新增消息類型 = 新增類,零修改核心流程」。
  2. 統一處理入口,保持對外接口不變。
  3. 預留擴展點,支援插件化、AOP 攔截(日誌、監控、熔斷)。

步驟一:定義領域模型(DTO)

// 基礎消息
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(); // 統一序列化
    }
}

重構收益對比

進階:若需動態註冊處理器(插件化)

@Component
public class DynamicMessageProcessor extends MessageProcessor {
    private final Map, ReplyMessage>> handlers = new ConcurrentHashMap<>();

    @EventListener
    public void onPluginLoaded(PluginLoadedEvent e) {
        handlers.put(e.getMsgType(), e.getHandler());
    }

    @Override
    protected ReplyMessage dispatch(PostMessage msg) {
        return handlers.getOrDefault(msg.MsgType, this::defaultReply).apply(msg, Collections.emptyMap());
    }
}

結語

將「巨石 if-else」重構為「多態分發 + 模板方法」,不僅消除了代碼腐爛根源,更為後續微服務拆分、插件化架構、灰度發布奠定了堅實基礎。記住:**好的重構不是炫技,而是讓業務變更成為「增量添加」而非「存量修改」**。

copyright © 萬盛學電腦網 all rights reserved
指標重構前重構後
核心方法行數300+~30 (調度邏輯)
新增消息類型修改點核心方法 + 多處新增 1 個具體類/方法
單元測試覆蓋率< 20%> 90% (每類獨立測試)
圈複雜度> 50< 5 (單方法)
支持 AOP 攔截極難自然支持 (Spring AOP 切面)