news 2026/7/24 14:33:15

模板方法模式 (Template Method) 在支付系统中的应用:如何优雅地对接 10+ 个第三方支付通道?

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
模板方法模式 (Template Method) 在支付系统中的应用:如何优雅地对接 10+ 个第三方支付通道?

💸 前言:被if-else支配的恐惧

场景还原:
老板:“小王,今天把微信支付接进来。”
小王:“好勒!” 于是写了一个pay()方法。
老板:“明天把支付宝也接进来。”
小王:“没问题!” 于是把pay()方法改成了:

if(channel==WECHAT){// 微信验签、调用、处理...}elseif(channel==ALIPAY){// 支付宝验签、调用、处理...}

老板:“下周我们要出海,接一下 PayPal 和 Stripe。”
小王看着那坨已经 500 行的if-else代码,陷入了沉思……

这就是典型的“缺乏抽象能力”。
支付业务虽然通道不同,但核心流程是惊人一致的

  1. 参数校验(Validate)
  2. 生成签名(Sign)
  3. 发送 HTTP 请求(Call API)
  4. 处理响应(Handle Response)
  5. 统一记录日志(Log)

针对这种**“流程固定,但细节不同”**的场景,模板方法模式就是唯一的真神。


🧠 核心原理:定义骨架,下放细节

模板方法模式的核心思想是:在父类中定义一个final的主流程方法(骨架),将具体的步骤延迟到子类去实现。

类图设计:

AbstractPaymentChannel
+pay(Request req) : void
#validate(Request req) : void
#sign(Request req) : String
#callApi(Request req, String sign) : Response
#handleResponse(Response resp) : void
-log() : void
WechatChannel
#validate()
#sign()
#callApi()
#handleResponse()
AlipayChannel
#validate()
#sign()
#callApi()
#handleResponse()

🛠️ 代码实战:重构支付网关

1. 定义抽象基类 (The Skeleton)

这是整个模式的灵魂。注意doPay方法必须是final的,防止子类篡改流程。

publicabstractclassAbstractPaymentChannel{// 核心模板方法:定义了支付的标准流程publicfinalPaymentResponsedoPay(PaymentRequestrequest){// 1. 通用日志logInfo("开始处理支付请求",request);// 2. 参数校验 (抽象步骤)if(!validate(request)){thrownewBizException("参数校验失败");}// 3. 加签 (抽象步骤)Stringsignature=sign(request);// 4. 调用三方接口 (抽象步骤)StringrawResponse=callApi(request,signature);// 5. 解析响应 (抽象步骤)PaymentResponseresponse=parseResponse(rawResponse);// 6. 通用后置处理postProcess(response);returnresponse;}// --- 抽象方法,强制子类实现 ---protectedabstractbooleanvalidate(PaymentRequestrequest);protectedabstractStringsign(PaymentRequestrequest);protectedabstractStringcallApi(PaymentRequestrequest,Stringsign);protectedabstractPaymentResponseparseResponse(StringrawResponse);// --- 通用方法,子类复用 ---privatevoidlogInfo(Stringmsg,Objectdata){// 统一的日志记录逻辑System.out.println(msg+": "+data);}// --- 钩子方法 (Hook),子类可选择性覆盖 ---protectedvoidpostProcess(PaymentResponseresponse){// 默认什么都不做}}
2. 实现微信支付通道 (Concrete Class)
@ServicepublicclassWechatPaymentChannelextendsAbstractPaymentChannel{@Overrideprotectedbooleanvalidate(PaymentRequestrequest){System.out.println("✅ 微信渠道:校验 OpenID 是否必填");returnStringUtils.hasText(request.getExtra("openId"));}@OverrideprotectedStringsign(PaymentRequestrequest){System.out.println("🔑 微信渠道:使用 MD5 进行签名");returnSecureUtil.md5(request.toString());}@OverrideprotectedStringcallApi(PaymentRequestrequest,Stringsign){System.out.println("🚀 微信渠道:调用 https://api.mch.weixin.qq.com/...");return"<xml>...SUCCESS...</xml>";}@OverrideprotectedPaymentResponseparseResponse(StringrawResponse){System.out.println("📝 微信渠道:解析 XML 响应");returnnewPaymentResponse("SUCCESS","200");}}
3. 实现支付宝通道 (Concrete Class)
@ServicepublicclassAlipayPaymentChannelextendsAbstractPaymentChannel{@Overrideprotectedbooleanvalidate(PaymentRequestrequest){System.out.println("✅ 支付宝渠道:校验 BuyerId");returntrue;}@OverrideprotectedStringsign(PaymentRequestrequest){System.out.println("🔑 支付宝渠道:使用 RSA2 进行签名");returnSecureUtil.rsa2(request.toString());}// ... 其他步骤实现}
4. 配合工厂模式使用

最后,我们需要一个简单工厂 (Simple Factory)或者策略模式 (Strategy)的 Map 来分发请求。

@ComponentpublicclassPaymentChannelFactory{@AutowiredprivateMap<String,AbstractPaymentChannel>channelMap;publicAbstractPaymentChannelgetChannel(StringchannelCode){// channelMap 会自动注入所有 Bean,key 为 beanName// 例如:wechatPaymentChannel -> WechatPaymentChannelreturnchannelMap.get(channelCode+"PaymentChannel");}}

💥 进阶技巧:钩子方法 (Hook) 的妙用

有时候,某个特定的渠道需要特殊的步骤。
比如:只有银联支付需要在支付完成后,发送短信通知用户。

我们不需要修改doPay主流程,只需要利用钩子方法

在基类中:

// 默认为空实现protectedvoidpostProcess(PaymentResponseresponse){}

在银联子类中:

@OverrideprotectedvoidpostProcess(PaymentResponseresponse){if("SUCCESS".equals(response.getStatus())){smsService.send("您的银联支付已成功!");}}

这就是“开闭原则” (Open-Closed Principle) 的完美体现:对扩展开放,对修改关闭。


📝 总结

if-else模板方法模式,不仅仅是代码行数的变化,更是思维方式的跃迁。

  1. 复用性:公共逻辑(日志、异常处理、埋点)全部收敛在父类,改一处,所有通道生效。
  2. 扩展性:接新通道?新建一个类继承父类即可,老代码一行都不用动,测试风险极低。
  3. 规范性:父类通过final关键字强制定义了业务的标准流程,新人想乱写都难。

写出机器能跑的代码是门槛,写出人能维护的代码才是本事。

版权声明: 本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:809451989@qq.com进行投诉反馈,一经查实,立即删除!
网站建设 2026/7/21 14:17:16

28、实现 SNMP MIB

实现 SNMP MIB 1. 环境准备 在开始实现 SNMP MIB 之前,我们需要对环境进行一些准备工作,主要涉及到 SNMP 代理和 MIB 文件的相关操作。 - SNMP 代理位置 :SNMP 代理 snmpd 位于 /opt/snmp/sbin 目录,同时该目录下还有 snmptrapd 。不过,在我们的设备上, snmp…

作者头像 李华
网站建设 2026/7/22 16:51:16

2025腾讯混元大模型本地部署实战:从零搭建你的私有AI推理引擎

2025腾讯混元大模型本地部署实战&#xff1a;从零搭建你的私有AI推理引擎 【免费下载链接】Hunyuan-7B-Pretrain 腾讯开源大语言模型Hunyuan-7B-Pretrain&#xff0c;支持256K超长上下文&#xff0c;融合快慢思考模式&#xff0c;具备强大推理能力。采用GQA优化推理效率&#x…

作者头像 李华
网站建设 2026/7/22 10:12:03

Rust游戏GUI革命:egui如何重塑跨平台界面开发体验

当你在Rust游戏开发中面临界面设计时&#xff0c;是否曾遇到过这样的困境&#xff1a;复杂的UI系统拖慢开发节奏&#xff0c;跨平台兼容性问题频发&#xff0c;渲染性能无法满足实时要求&#xff1f;这正是传统GUI框架在游戏场景中的普遍痛点。 【免费下载链接】egui egui: an …

作者头像 李华
网站建设 2026/7/23 22:57:24

2026毕设ssm+vue基于的再生产公益管理系统的设计与实现论文+程序

本系统&#xff08;程序源码&#xff09;带文档lw万字以上 文末可获取一份本项目的java源码和数据库参考。系统程序文件列表开题报告内容一、选题背景 关于内容聚合与赞助机制的研究&#xff0c;现有研究主要以单一内容形态&#xff08;如纯短视频、纯图文博客&#xff09;或单…

作者头像 李华
网站建设 2026/7/23 13:27:19

31、深入了解XHTML+SMIL:创建交互式多媒体文档

深入了解XHTML+SMIL:创建交互式多媒体文档 1. XHTML+SMIL简介 XHTML+SMIL配置文件为XHTML元素增添了定时、动画和多媒体功能。它由SYMM工作组制作,并于2002年1月下旬由W3C发布。不过,该发布仅用于讨论,并不代表W3C、SYMM工作组或任何W3C成员的认可。 这个配置文件包含了…

作者头像 李华
网站建设 2026/7/17 14:47:46

如何快速获取M3U8视频:开源工具的完整使用指南

还在为M3U8视频获取而烦恼吗&#xff1f;M3U8 Downloader是一款完全开源的免费工具&#xff0c;专门针对M3U8格式文件设计&#xff0c;让您轻松实现快速、高效的视频获取体验。 【免费下载链接】M3u8Downloader下载工具 M3u8 Downloader是一款高效、易用的开源下载工具&#xf…

作者头像 李华