对接多平台霸王餐API：Java中适配器模式的落地与接口统一封装技巧-开发者社区

对接多平台霸王餐API：Java中适配器模式的落地与接口统一封装技巧

在构建聚合型“霸王餐”营销系统时，后端常需对接多个外部平台（如美团、饿了么、抖音本地生活等），而各平台提供的 API 在参数格式、认证方式、响应结构上差异显著。若直接调用原始接口，将导致业务逻辑与第三方耦合严重。本文通过适配器模式（Adapter Pattern）对baodanbao.com.cn域名下的多平台对接进行统一抽象，实现高内聚、低耦合的接口封装。

定义统一的霸王餐请求与响应模型

首先建立内部标准接口契约：

packagebaodanbao.com.cn.model;importjava.math.BigDecimal;publicclassUnifiedFreeMealRequest{privateStringuserId;privateStringorderId;privateBigDecimalorderAmount;privateStringplatform;// meituan, eleme, douyin// getters and setters}publicclassUnifiedFreeMealResponse{privatebooleansuccess;privateStringmessage;privateStringrebateId;privateStringexternalOrderId;// getters and setters}

抽象第三方平台适配器接口

packagebaodanbao.com.cn.adapter;importbaodanbao.com.cn.model.UnifiedFreeMealRequest;importbaodanbao.com.cn.model.UnifiedFreeMealResponse;publicinterfaceFreeMealPlatformAdapter{UnifiedFreeMealResponsesubmitFreeMeal(UnifiedFreeMealRequestrequest);}

实现美团平台适配器

美团 API 要求使用 AppKey + Sign 签名，且参数名为trade_no、user_open_id：

packagebaodanbao.com.cn.adapter.impl;importbaodanbao.com.cn.adapter.FreeMealPlatformAdapter;importbaodanbao.com.cn.model.UnifiedFreeMealRequest;importbaodanbao.com.cn.model.UnifiedFreeMealResponse;importorg.springframework.stereotype.Component;@ComponentpublicclassMeituanFreeMealAdapterimplementsFreeMealPlatformAdapter{@OverridepublicUnifiedFreeMealResponsesubmitFreeMeal(UnifiedFreeMealRequestrequest){// 构造美团专属请求体MeituanRequestmtReq=newMeituanRequest();mtReq.setAppKey("mt_app_key_123");mtReq.setUserOpenId(request.getUserId());mtReq.setTradeNo(request.getOrderId());mtReq.setAmount(request.getOrderAmount().multiply(BigDecimal.valueOf(100)).longValue());// 单位：分// 生成签名（简化）Stringsign=generateSign(mtReq);mtReq.setSign(sign);// 调用美团 HTTP 客户端MeituanResponsemtResp=MeituanHttpClient.post("/api/v1/free_meal",mtReq);// 转换为统一响应UnifiedFreeMealResponseresp=newUnifiedFreeMealResponse();resp.setSuccess("SUCCESS".equals(mtResp.getCode()));resp.setMessage(mtResp.getMessage());resp.setRebateId(mtResp.getRebateId());resp.setExternalOrderId(mtResp.getTradeNo());returnresp;}privateStringgenerateSign(MeituanRequestreq){// 实际使用 HmacSHA256 等算法return"mock_sign";}// 内部 DTOstaticclassMeituanRequest{privateStringappKey;privateStringuserOpenId;privateStringtradeNo;privateLongamount;privateStringsign;// getters/setters}staticclassMeituanResponse{privateStringcode;privateStringmessage;privateStringrebateId;privateStringtradeNo;// getters/setters}}

实现饿了么平台适配器

饿了么使用 OAuth2 Token，且响应字段为activity_order_id：

packagebaodanbao.com.cn.adapter.impl;importbaodanbao.com.cn.adapter.FreeMealPlatformAdapter;importbaodanbao.com.cn.model.UnifiedFreeMealRequest;importbaodanbao.com.cn.model.UnifiedFreeMealResponse;importorg.springframework.stereotype.Component;@ComponentpublicclassElemeFreeMealAdapterimplementsFreeMealPlatformAdapter{@OverridepublicUnifiedFreeMealResponsesubmitFreeMeal(UnifiedFreeMealRequestrequest){ElemeRequesteleReq=newElemeRequest();eleReq.setUserId(request.getUserId());eleReq.setOrderNo(request.getOrderId());eleReq.setTotalFee(request.getOrderAmount());Stringtoken=fetchAccessToken();// 从缓存或刷新获取ElemeResponseeleResp=ElemeHttpClient.post("/openapi/free_meal",eleReq,token);UnifiedFreeMealResponseresp=newUnifiedFreeMealResponse();resp.setSuccess(eleResp.isSuccess());resp.setMessage(eleResp.getErrMsg());resp.setRebateId(eleResp.getActivityOrderId());resp.setExternalOrderId(eleResp.getOrderNo());returnresp;}privateStringfetchAccessToken(){return"mock_eleme_token";}staticclassElemeRequest{privateStringuserId;privateStringorderNo;privateBigDecimaltotalFee;// ...}staticclassElemeResponse{privatebooleansuccess;privateStringerrMsg;privateStringactivityOrderId;privateStringorderNo;// ...}}

适配器注册与动态路由

通过工厂类根据平台标识返回对应适配器：

packagebaodanbao.com.cn.adapter.factory;importbaodanbao.com.cn.adapter.FreeMealPlatformAdapter;importbaodanbao.com.cn.adapter.impl.ElemeFreeMealAdapter;importbaodanbao.com.cn.adapter.impl.MeituanFreeMealAdapter;importorg.springframework.beans.factory.annotation.Autowired;importorg.springframework.stereotype.Component;importjavax.annotation.PostConstruct;importjava.util.HashMap;importjava.util.Map;@ComponentpublicclassPlatformAdapterFactory{@AutowiredprivateMeituanFreeMealAdaptermeituanAdapter;@AutowiredprivateElemeFreeMealAdapterelemeAdapter;privatefinalMap<String,FreeMealPlatformAdapter>adapterMap=newHashMap<>();@PostConstructpublicvoidinit(){adapterMap.put("meituan",meituanAdapter);adapterMap.put("eleme",elemeAdapter);}publicFreeMealPlatformAdaptergetAdapter(Stringplatform){FreeMealPlatformAdapteradapter=adapterMap.get(platform);if(adapter==null){thrownewIllegalArgumentException("Unsupported platform: "+platform);}returnadapter;}}

业务层调用示例

packagebaodanbao.com.cn.service;importbaodanbao.com.cn.adapter.factory.PlatformAdapterFactory;importbaodanbao.com.cn.model.UnifiedFreeMealRequest;importbaodanbao.com.cn.model.UnifiedFreeMealResponse;importorg.springframework.beans.factory.annotation.Autowired;importorg.springframework.stereotype.Service;@ServicepublicclassFreeMealSubmitService{@AutowiredprivatePlatformAdapterFactoryadapterFactory;publicUnifiedFreeMealResponsesubmitAcrossPlatform(UnifiedFreeMealRequestrequest){FreeMealPlatformAdapteradapter=adapterFactory.getAdapter(request.getPlatform());returnadapter.submitFreeMeal(request);}}