支付场景中的状态流转
在开发电商支付模块时,我们常遇到这样的状态流转需求:
- 订单需要经历
待支付→支付中→支付成功/失败→退款处理的完整生命周期。 - 不同状态下可执行的操作不同(例如只有支付成功才能退款)。
- 状态转换需要触发附加操作(支付成功要发通知、更新库存)。
传统的 if-else 或 switch 实现方式会导致:
- 代码臃肿,维护困难
- 状态转换逻辑分散
- 新增状态需要修改大量现有代码
此时,状态模式(State Pattern)是这些问题的最佳解决方案。
状态模式核心思想
通过将状态抽象为独立类,实现两大关键特性:
- 行为状态化 :不同状态下相同的操作产生不同结果
- 转换自动化 :状态对象自行决定下一个状态
状态模式实现
- 状态接口设计
// 订单状态抽象接口 public interface IOrderState { void Process(OrderContext context); void Cancel(OrderContext context); void Refund(OrderContext context); } // 订单上下文(维护当前状态) public class OrderContext { private IOrderState _currentState; public string OrderId { get; } = Guid.NewGuid().ToString(); public OrderContext(IOrderState initialState) { TransitionTo(initialState); } public void TransitionTo(IOrderState state) { Console.WriteLine($"订单状态变更:{_currentState?.GetType().Name} → {state.GetType().Name}"); _currentState = state; } public void ProcessPayment() => _currentState.Process(this); public void CancelOrder() => _currentState.Cancel(this); public void RequestRefund() => _currentState.Refund(this); }
- 具体状态类实现
待支付状态:
public class PendingState : IOrderState { public void Process(OrderContext context) { Console.WriteLine("开始支付处理..."); // 调用支付网关接口 context.TransitionTo(new ProcessingState()); } public void Cancel(OrderContext context) { Console.WriteLine("订单已取消"); context.TransitionTo(new CanceledState()); } public void Refund(OrderContext context) { Console.WriteLine("待支付订单不能退款"); throw new InvalidOperationException("待支付订单不能退款"); } }
支付中状态:
public class ProcessingState : IOrderState { public void Process(OrderContext context) { Console.WriteLine("支付处理中..."); context.TransitionTo(new PaidState()); } public void Cancel(OrderContext context) { Console.WriteLine("支付处理中,不可取消订单..."); throw new InvalidOperationException("支付处理中,不可取消订单..."); } public void Refund(OrderContext context) { Console.WriteLine("支付未完成不能退款"); throw new InvalidOperationException("支付未完成不能退款"); } }
支付成功状态:
public class PaidState : IOrderState { public void Process(OrderContext context) { Console.WriteLine("订单已完成支付"); throw new InvalidOperationException("订单已完成支付"); } public void Cancel(OrderContext context) { Console.WriteLine("已支付订单需走退款流程"); throw new InvalidOperationException("已支付订单需走退款流程"); } public void Refund(OrderContext context) { Console.WriteLine("发起退款申请..."); // 调用退款接口 context.TransitionTo(new RefundingState()); } }
退款中状态:
public class RefundingState : IOrderState { public void Process(OrderContext context) { Console.WriteLine("退款处理中..."); context.TransitionTo(new RefundedState()); } public void Cancel(OrderContext context) { Console.WriteLine("退款处理中,不可取消订单..."); throw new InvalidOperationException("退款处理中,不可取消订单..."); } public void Refund(OrderContext context) { Console.WriteLine("退款处理中,不可重复退款"); throw new InvalidOperationException("退款处理中,不可重复退款"); } }
退款完成状态:
public class RefundedState : IOrderState { public void Process(OrderContext context) { Console.WriteLine("退款完成,订单已取消"); throw new InvalidOperationException("退款完成,订单已取消"); } public void Cancel(OrderContext context) { Console.WriteLine("订单已退款,无需取消"); throw new InvalidOperationException("订单已退款,无需取消"); } public void Refund(OrderContext context) { Console.WriteLine("订单已退款,无需退款"); throw new InvalidOperationException("订单已退款,无需退款"); } }
订单取消状态:
public class CanceledState : IOrderState { public void Process(OrderContext context) { Console.WriteLine("订单已取消,无需支付"); throw new InvalidOperationException("订单已取消,无需支付"); } public void Cancel(OrderContext context) { Console.WriteLine("订单已取消,无需取消"); throw new InvalidOperationException("订单已取消,无需取消"); } public void Refund(OrderContext context) { Console.WriteLine("订单已取消,无需退款"); throw new InvalidOperationException("订单已取消,无需退款"); } }
完整状态流转示例
var order = new OrderContext(new PendingState()); order.ProcessPayment(); // 进入ProcessingState order.RequestRefund(); // 输出警告信息 // 模拟支付成功回调 order.TransitionTo(new PaidState()); order.RequestRefund(); // 进入RefundingState
相关代码:https://github.com/huangmingji/design-pattern-learning/tree/main/design-pattern-learning-2