第6篇实战案例电子面单编排器——模板方法用继承还是组合摘要多平台电子面单取号流程是模板方法的经典场景但我们在真实架构中放弃了继承选择了组合方式。本文从实战出发对比两种实现方式的优劣展示 WaybillFetchTemplate 如何通过注入策略对象固定流程骨架并给出顺丰子母件分支的处理技巧。系列导航上一篇框架里的模板方法HttpServlet、JdbcTemplate、AbstractList下一篇六大设计原则在模板方法中的体现原系列总目录 订阅本专栏不错过每一篇本文是《Java 23 种设计模式从踩坑到精通》模板方法模式长文的扩充短文第6篇帮助你碎片化掌握核心知识点。前面我们用饮品制作和数据同步理解了模板方法的经典用法但在真实的电商WMS系统中多平台电子面单取号流程遇到了一个棘手的选择题模板方法到底该用继承还是组合场景回顾多平台取号的共性流程电子面单取号的流程对所有平台来说都是一样的骨架校验订单 → 构建请求 → 调用API → 判断成功 → 解析响应 → 持久化但每一步的具体实现因平台而异奇门淘宝/天猫请求格式为XML签名算法MD5响应解析需遍历节点抖音请求格式为JSON签名算法HMAC-SHA256响应解析需处理加密字段京东请求格式为自定义协议需调用京东SDK如果每个平台都写一套完整的取号流程代码重复不说一旦流程变更所有实现都要改。我们的选择用组合实现模板方法传统模板方法模式用继承实现——父类定义骨架子类覆写抽象方法。但在我们的电子面单架构中选择了组合方式。核心编排器WaybillFetchTemplate是一个普通的类通过构造函数注入三个策略对象publicclassWaybillFetchTemplate{privatefinalRequestStrategyrequestStrategy;privatefinalParseStrategyparseStrategy;privatefinalExceptionStrategyexceptionStrategy;privatefinalApiInvokerapiInvoker;privatefinalWaybillPersistencepersistence;// 通过构造函数注入策略publicWaybillFetchTemplate(RequestStrategyreq,ParseStrategyparse,ExceptionStrategyex,ApiInvokerinvoker,WaybillPersistencepersist){this.requestStrategyreq;this.parseStrategyparse;this.exceptionStrategyex;this.apiInvokerinvoker;this.persistencepersist;}// 模板方法固定取号流程骨架publicbooleanexecute(WaybillContextctx){// 1. 构建请求策略ObjectrequestrequestStrategy.buildRequest(ctx);// 2. 调用API统一StringresponseapiInvoker.invoke(ctx,request);// 3. 业务异常判断策略if(!exceptionStrategy.isBusinessSuccess(response)){markException(ctx.getTicket(),exceptionStrategy.extractErrorMsg(response));returnfalse;}// 4. 解析响应策略ListDetaildetailsparseStrategy.parseResponse(ctx,response);if(details.isEmpty()){markException(ctx.getTicket(),未获取到运单号);returnfalse;}// 5. 持久化统一persistence.saveAndBind(ctx.getTicket(),details,ctx.isFirst());returntrue;}}使用方式——运行时注入不同平台的策略// 奇门取号RequestStrategyreqnewQiMenRequestStrategy();ParseStrategyparsenewQiMenParseStrategy();ExceptionStrategyexnewQiMenExceptionStrategy();WaybillFetchTemplatetemplatenewWaybillFetchTemplate(req,parse,ex,invoker,persistence);template.execute(ctx);// 抖音取号reqnewDouYinRequestStrategy();parsenewDouYinParseStrategy();exnewDouYinExceptionStrategy();templatenewWaybillFetchTemplate(req,parse,ex,invoker,persistence);template.execute(ctx);为什么用组合而不是继承维度继承方式组合方式类数量N 个平台 → N 个子类1 个模板类 3 个策略接口灵活性编译期绑定运行时动态替换策略测试性需创建子类实例直接 Mock 策略注入复用性子类间无法复用策略策略可跨平台组合关键原因平台差异已经被三个策略接口完美隔离。如果再用一个抽象的AbstractWaybillFetchTemplate让各平台子类去实现等于把同样的差异逻辑在两个地方重复定义——子类既要实现策略接口又要覆写模板的抽象方法这是典型的“过度抽象”。模板层的额外优势顺丰子母件分支组合方式还有一个额外优势——在模板层增加流程分支非常自然。顺丰超过 10 件需要走子母件模式分批调用 API我们直接在模板类中增加一个分支方法publicbooleanexecute(WaybillContextctx){if(isSFMoreTen(ctx)){returnexecuteSFMoreTen(ctx);// 子母件分支多次调用}returnexecuteNormal(ctx);// 普通分支单次调用}如果用继承子母件逻辑要么重复在每个子类中实现要么在父类中增加复杂的分支判断很容易失控。组合方式让模板层成为唯一的流程控制点分支逻辑清晰可维护。一句话总结模板方法的核心是“固定流程骨架差异化具体步骤”。骨架既可以用继承实现也可以用组合实现。当差异点已被策略接口隔离时组合方式更灵活、更简洁。完整长文入口本文是模板方法模式扩充系列的第6篇。如果你想一次性阅读完整内容含UML、完整代码、框架应用、面试追问等请查看原长文 《Java 23 种设计模式从踩坑到精通 | 模板方法模式》系列导航上一篇框架里的模板方法HttpServlet、JdbcTemplate、AbstractList下一篇六大设计原则在模板方法中的体现返回扩充系列目录 订阅本专栏不错过每一篇原系列总目录 订阅本专栏不错过每一篇实战配套本文的电子面单编排器设计在《电商多平台电子面单对接实战》系列中有完整落地代码多平台统一架构设计模板方法的组合与继承抉择
第6篇实战案例电子面单编排器——模板方法用继承还是组合摘要多平台电子面单取号流程是模板方法的经典场景但我们在真实架构中放弃了继承选择了组合方式。本文从实战出发对比两种实现方式的优劣展示 WaybillFetchTemplate 如何通过注入策略对象固定流程骨架并给出顺丰子母件分支的处理技巧。系列导航上一篇框架里的模板方法HttpServlet、JdbcTemplate、AbstractList下一篇六大设计原则在模板方法中的体现原系列总目录 订阅本专栏不错过每一篇本文是《Java 23 种设计模式从踩坑到精通》模板方法模式长文的扩充短文第6篇帮助你碎片化掌握核心知识点。前面我们用饮品制作和数据同步理解了模板方法的经典用法但在真实的电商WMS系统中多平台电子面单取号流程遇到了一个棘手的选择题模板方法到底该用继承还是组合场景回顾多平台取号的共性流程电子面单取号的流程对所有平台来说都是一样的骨架校验订单 → 构建请求 → 调用API → 判断成功 → 解析响应 → 持久化但每一步的具体实现因平台而异奇门淘宝/天猫请求格式为XML签名算法MD5响应解析需遍历节点抖音请求格式为JSON签名算法HMAC-SHA256响应解析需处理加密字段京东请求格式为自定义协议需调用京东SDK如果每个平台都写一套完整的取号流程代码重复不说一旦流程变更所有实现都要改。我们的选择用组合实现模板方法传统模板方法模式用继承实现——父类定义骨架子类覆写抽象方法。但在我们的电子面单架构中选择了组合方式。核心编排器WaybillFetchTemplate是一个普通的类通过构造函数注入三个策略对象publicclassWaybillFetchTemplate{privatefinalRequestStrategyrequestStrategy;privatefinalParseStrategyparseStrategy;privatefinalExceptionStrategyexceptionStrategy;privatefinalApiInvokerapiInvoker;privatefinalWaybillPersistencepersistence;// 通过构造函数注入策略publicWaybillFetchTemplate(RequestStrategyreq,ParseStrategyparse,ExceptionStrategyex,ApiInvokerinvoker,WaybillPersistencepersist){this.requestStrategyreq;this.parseStrategyparse;this.exceptionStrategyex;this.apiInvokerinvoker;this.persistencepersist;}// 模板方法固定取号流程骨架publicbooleanexecute(WaybillContextctx){// 1. 构建请求策略ObjectrequestrequestStrategy.buildRequest(ctx);// 2. 调用API统一StringresponseapiInvoker.invoke(ctx,request);// 3. 业务异常判断策略if(!exceptionStrategy.isBusinessSuccess(response)){markException(ctx.getTicket(),exceptionStrategy.extractErrorMsg(response));returnfalse;}// 4. 解析响应策略ListDetaildetailsparseStrategy.parseResponse(ctx,response);if(details.isEmpty()){markException(ctx.getTicket(),未获取到运单号);returnfalse;}// 5. 持久化统一persistence.saveAndBind(ctx.getTicket(),details,ctx.isFirst());returntrue;}}使用方式——运行时注入不同平台的策略// 奇门取号RequestStrategyreqnewQiMenRequestStrategy();ParseStrategyparsenewQiMenParseStrategy();ExceptionStrategyexnewQiMenExceptionStrategy();WaybillFetchTemplatetemplatenewWaybillFetchTemplate(req,parse,ex,invoker,persistence);template.execute(ctx);// 抖音取号reqnewDouYinRequestStrategy();parsenewDouYinParseStrategy();exnewDouYinExceptionStrategy();templatenewWaybillFetchTemplate(req,parse,ex,invoker,persistence);template.execute(ctx);为什么用组合而不是继承维度继承方式组合方式类数量N 个平台 → N 个子类1 个模板类 3 个策略接口灵活性编译期绑定运行时动态替换策略测试性需创建子类实例直接 Mock 策略注入复用性子类间无法复用策略策略可跨平台组合关键原因平台差异已经被三个策略接口完美隔离。如果再用一个抽象的AbstractWaybillFetchTemplate让各平台子类去实现等于把同样的差异逻辑在两个地方重复定义——子类既要实现策略接口又要覆写模板的抽象方法这是典型的“过度抽象”。模板层的额外优势顺丰子母件分支组合方式还有一个额外优势——在模板层增加流程分支非常自然。顺丰超过 10 件需要走子母件模式分批调用 API我们直接在模板类中增加一个分支方法publicbooleanexecute(WaybillContextctx){if(isSFMoreTen(ctx)){returnexecuteSFMoreTen(ctx);// 子母件分支多次调用}returnexecuteNormal(ctx);// 普通分支单次调用}如果用继承子母件逻辑要么重复在每个子类中实现要么在父类中增加复杂的分支判断很容易失控。组合方式让模板层成为唯一的流程控制点分支逻辑清晰可维护。一句话总结模板方法的核心是“固定流程骨架差异化具体步骤”。骨架既可以用继承实现也可以用组合实现。当差异点已被策略接口隔离时组合方式更灵活、更简洁。完整长文入口本文是模板方法模式扩充系列的第6篇。如果你想一次性阅读完整内容含UML、完整代码、框架应用、面试追问等请查看原长文 《Java 23 种设计模式从踩坑到精通 | 模板方法模式》系列导航上一篇框架里的模板方法HttpServlet、JdbcTemplate、AbstractList下一篇六大设计原则在模板方法中的体现返回扩充系列目录 订阅本专栏不错过每一篇原系列总目录 订阅本专栏不错过每一篇实战配套本文的电子面单编排器设计在《电商多平台电子面单对接实战》系列中有完整落地代码多平台统一架构设计模板方法的组合与继承抉择
