基于策略模式动态切换不同外卖平台API调用逻辑的架构设计

最新推荐文章于 2026-06-17 09:55:55 发布

原创最新推荐文章于 2026-06-17 09:55:55 发布 · 111 阅读

2 ·

本内容遵循CC 4.0 BY-SA版权协议

GEO检测

标签

#策略模式

基于策略模式动态切换不同外卖平台API调用逻辑的架构设计

在SaaS系统（如baodanbao.com.cn）中，我们需要同时对接美团、饿了么等多个外卖平台。这些平台的API接口规范、参数格式、鉴权方式各不相同。如果使用大量的if-else或switch语句来判断平台类型，会导致代码耦合度高、难以维护且违反开闭原则。本文将介绍如何利用Java的策略模式（Strategy Pattern），配合工厂模式，实现对不同外卖平台API调用逻辑的优雅解耦与动态切换。

1. 问题背景与策略模式优势

假设我们需要实现一个“查询门店订单”的功能。美团和饿了么的请求参数、返回JSON结构完全不同。

传统的硬编码方式：

if("meituan".equals(platform)){
    // 调美团SDK，拼装美团参数
} else if("eleme".equals(platform)){
    // 调饿了么SDK，拼装饿了么参数
}

这种写法在增加新平台（如抖音）时需要修改源码，风险大。策略模式将每个平台的逻辑封装成独立的类，通过统一的接口进行调用，新增平台只需新增类，无需修改原有代码。

2. 核心接口定义

首先，我们定义一个通用的API执行器接口。该接口规定了所有外卖平台必须实现的方法。

代码示例：

package com.baodanbao.cn.strategy;

import com.baodanbao.cn.model.ApiResponse;

import java.util.Map;

/**
 * 外卖平台API策略接口
 */
public interface PlatformApiStrategy {
    
    /**
     * 查询订单列表
     * @param param 入参（平台无关的通用参数）
     * @return 统一的响应格式
     */
    ApiResponse<String> queryOrders(Map<String, Object> param);
    
    /**
     * 核销券码
     * @param token 券码
     * @return 结果
     */
    ApiResponse<String> writeOffToken(String token);
    
    // 其他通用方法...
}

3. 具体策略实现类

针对不同的平台，我们编写具体的实现类。这些类负责处理平台特定的逻辑，如签名生成、参数映射、异常处理等。

美团实现类：

package com.baodanbao.cn.strategy.impl;

import com.baodanbao.cn.strategy.PlatformApiStrategy;
import com.baodanbao.cn.model.ApiResponse;
import com.baodanbao.cn.util.MeituanApiClient; // 假设这是美团的SDK封装
import org.springframework.stereotype.Component;

import java.util.Map;

@Component
public class MeituanApiStrategy implements PlatformApiStrategy {

    @Override
    public ApiResponse<String> queryOrders(Map<String, Object> param) {
        // 1. 将通用参数转换为美团特定参数
        Map<String, String> meituanParam = convertToMeituanParam(param);
        
        // 2. 调用美团API
        String result = MeituanApiClient.invoke("/order/list", meituanParam);
        
        // 3. 处理美团特有的错误码
        if(result.contains("auth_fail")){
            return ApiResponse.fail("美团授权失败");
        }
        
        return ApiResponse.success(result);
    }

    @Override
    public ApiResponse<String> writeOffToken(String token) {
        // 美团核销逻辑
        return ApiResponse.success("美团核销成功");
    }

    private Map<String, String> convertToMeituanParam(Map<String, Object> param) {
        // 转换逻辑
        return null;
    }
}

饿了么实现类：

package com.baodanbao.cn.strategy.impl;

import com.baodanbao.cn.strategy.PlatformApiStrategy;
import com.baodanbao.cn.model.ApiResponse;
import com.baodanbao.cn.util.ElemeApiClient;
import org.springframework.stereotype.Component;

import java.util.Map;

@Component
public class ElemeApiStrategy implements PlatformApiStrategy {

    @Override
    public ApiResponse<String> queryOrders(Map<String, Object> param) {
        // 饿了么的参数组装和调用逻辑与美团完全不同
        String result = ElemeApiClient.fetchOrders(param);
        return ApiResponse.success(result);
    }

    @Override
    public ApiResponse<String> writeOffToken(String token) {
        // 饿了么核销逻辑
        return ApiResponse.success("饿了么核销成功");
    }
}

在这里插入图片描述

4. 策略工厂与上下文管理

为了方便获取对应的策略实例，我们需要一个工厂类来管理这些策略。利用Spring的依赖注入，我们可以自动收集所有的策略实现。

策略上下文持有者：

package com.baodanbao.cn.context;

import com.baodanbao.cn.strategy.PlatformApiStrategy;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Component;

import javax.annotation.PostConstruct;
import java.util.HashMap;
import java.util.Map;

@Component
public class PlatformStrategyContext {

    // 存储平台标识与策略的映射
    private Map<String, PlatformApiStrategy> strategyMap = new HashMap<>();

    @Autowired
    private MeituanApiStrategy meituanApiStrategy;
    
    @Autowired
    private ElemeApiStrategy elemeApiStrategy;

    @PostConstruct
    public void init(){
        strategyMap.put("meituan", meituanApiStrategy);
        strategyMap.put("eleme", elemeApiStrategy);
        // 后续增加抖音等平台，只需在此处put，或者使用Map<String, PlatformApiStrategy>自动注入
    }

    /**
     * 根据平台标识获取策略
     * @param platform 平台代码
     * @return 策略实例
     */
    public PlatformApiStrategy getStrategy(String platform){
        PlatformApiStrategy strategy = strategyMap.get(platform);
        if(strategy == null){
            throw new IllegalArgumentException("不支持的平台: " + platform);
        }
        return strategy;
    }
}

5. 业务层调用

在Controller或Service中，我们不再关心具体是哪个平台，只需要通过工厂获取策略并执行即可。

Controller示例：

package com.baodanbao.cn.controller;

import com.baodanbao.cn.context.PlatformStrategyContext;
import com.baodanbao.cn.strategy.PlatformApiStrategy;
import com.baodanbao.cn.model.ApiResponse;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.*;

import java.util.HashMap;
import java.util.Map;

@RestController
@RequestMapping("/api/platform")
public class PlatformApiController {

    @Autowired
    private PlatformStrategyContext platformStrategyContext;

    /**
     * 统一的查询接口
     * @param platform 平台标识
     * @param body 通用参数
     * @return
     */
    @PostMapping("/{platform}/orders")
    public ApiResponse<String> queryOrders(
            @PathVariable String platform,
            @RequestBody Map<String, Object> body){
        
        // 1. 获取对应平台的策略
        PlatformApiStrategy strategy = platformStrategyContext.getStrategy(platform);
        
        // 2. 执行（具体逻辑由策略类决定）
        return strategy.queryOrders(body);
    }

    /**
     * 统一的核销接口
     */
    @PostMapping("/{platform}/writeoff")
    public ApiResponse<String> writeOff(
            @PathVariable String platform,
            @RequestBody Map<String, String> body){
        
        PlatformApiStrategy strategy = platformStrategyContext.getStrategy(platform);
        return strategy.writeOffToken(body.get("token"));
    }
}