写在前面
"纸上得来终觉浅,绝知此事要躬行".
读完23种设计模式后,感觉肚子还是空空的,不知道无从下手,今天翻了一下之前的博客,曾经记录过关于Apache Commons Chain的使用,它其实基于责任链,命令模式来写的,它很适合做流程化的逻辑代码,比如订单的下单,支付流程以及退款流程,让代码写的很nice,下面把我应用在订单系统的实战记录下,看下对其他人有没有帮助.
概念
)
Command接口:
1. 命令模式,实现它来执行责任链中某个节点的业务.
2. 主要方法 boolean execute(Context context); return false 会继续执行下一个节点,否则终止.
Filter接口:
1. extend command.
2. 比Command接口多了一个方法 boolean postprocess(Context var1, Exception var2);只要Filter的execute方法被调用,不论链的执行过程中是否抛出错误,Commons Chain都将保证Filter的postprocess方法被调用。
ChainBase基类:
它表示“命令链”,要在其中执行的命令,需要先添加到Chain中
Context接口:
它表示命令执行的上下文,在命令间实现共享信息的传递
订单系统支付流程
直接上代码了,代码里面有注释,代码可以运行测试
1. pom文件引入
commons-chain
commons-chain
1.2
org.projectlombok
lombok
1.18.12
org.slf4j
slf4j-api
2.0.0-alpha1
ch.qos.logback
logback-core
1.3.0-alpha5
ch.qos.logback
logback-classic
1.3.0-alpha5
2. 订单支付主流程
业务逻辑: 订单下单后,应付金额 = 订单总价, 如果使用了优惠券,我们需要把优惠券的金额从支付金额减去,如果还有商旅卡之类营销类卡余额得扣去,最后才是客户应该支付的现金,计算好应该支付的现金后,需要同步订单的信息到公共订单系统,供app查询,app刷到订单系统给的该笔订单的支付开关是打开的,则跳转到收银台,比如微信或者支付宝开始支付,下面我们看下怎么实现的.
- OrderPayChain 定义支付流程的步骤
- OrderContext 定义订单的信息上下文:订单总价,已支付的价格,使用的商旅卡价格
- PromotionPayCommand 优惠券支付逻辑
- BusinessPayCommand 商旅卡支付逻辑
- CashPayCommand 现金支付逻辑
- SysncOrderInfoCommand 同步订单信息,打开支付开关
3. 实现过程
import org.apache.commons.chain.impl.ChainBase;
import java.math.BigDecimal;
/**
* 这是变异后的责任链和命令模式
*
* 它表示“命令链”,要在其中执行的命令,需要先添加到Chain中
*/
public class OrderPayChain extends ChainBase {
public void init() {
//第一步: 扣优惠券
this.addCommand(new PromotionPayCommand());
//第二步:优先商旅卡
this.addCommand(new BusinessPayCommand());
//第三步: 扣现金
this.addCommand(new CashPayCommand());
// 同步订单信息
this.addCommand(new SysncOrderInfoCommand());
}
public static void main(String[] args) throws Exception {
var refundTicketChain = new OrderPayChain();
refundTicketChain.init();
var context = new OrderContext();
context.setOrderId(1621940242);
context.setTotalPrice(BigDecimal.valueOf(100));
refundTicketChain.execute(context);
}
}
import lombok.Data;
import org.apache.commons.chain.impl.ContextBase;
import java.math.BigDecimal;
/**
* Context接口。它表示命令执行的上下文,在命令间实现共享信息的传递
*/
@Data
public class OrderContext extends ContextBase {
/**
* 订单号
*/
private Integer orderId;
/**
* 订单总价
*/
private BigDecimal totalPrice = BigDecimal.ZERO;
/**
* 该笔订单已经支付的总价
*/
private BigDecimal payTotalPrice = BigDecimal.ZERO;
/**
* 使用商旅卡支付的金额
*/
private BigDecimal businessCardPayPrice = BigDecimal.ZERO;
}
import lombok.extern.slf4j.Slf4j;
import org.apache.commons.chain.Context;
import org.apache.commons.chain.Filter;
import java.math.BigDecimal;
@Slf4j
public class BusinessPayCommand implements Filter {
@Override
public boolean execute(Context context) throws Exception {
OrderContext orderContext = (OrderContext) context;
//查询客户账户下的商旅卡余额,比如查询结果是12.5元
// var bPrice = new BigDecimal(12.5); 禁止这种写法
var bPrice = BigDecimal.valueOf(12.5);
//算出还需要支付的价格
var remainPrice = orderContext.getTotalPrice().subtract(orderContext.getPayTotalPrice());
//该笔订单,优先商旅卡支付全额
if (bPrice.compareTo(remainPrice) >= 0) {
orderContext.setPayTotalPrice(orderContext.getPayTotalPrice().add(remainPrice));
orderContext.setBusinessCardPayPrice(remainPrice);
if (log.isDebugEnabled()) {
log.debug("订单orderId:{} ,订单总价:{},使用商旅卡支付了:{},还需要支付:{}",orderContext.getOrderId(),orderContext.getTotalPrice(),orderContext.getBusinessCardPayPrice(),orderContext.getTotalPrice().subtract(orderContext.getPayTotalPrice()));
}
return true;
}else {
// 使用商旅卡支付部分
orderContext.setPayTotalPrice(orderContext.getPayTotalPrice().add(bPrice));
orderContext.setBusinessCardPayPrice(bPrice);
if (log.isDebugEnabled()) {
log.debug("订单orderId:{} ,订单总价:{},使用商旅卡支付了:{},还需要支付:{}",orderContext.getOrderId(),orderContext.getTotalPrice(),orderContext.getBusinessCardPayPrice(),orderContext.getTotalPrice().subtract(orderContext.getPayTotalPrice()));
}
return false;
}
}
@Override
public boolean postprocess(Context context, Exception e) {
OrderContext orderContext = (OrderContext) context;
var businessCardPayPrice = orderContext.getBusinessCardPayPrice();
// 请求扣除账户下商旅卡
//httpClient.post("/api/businessCard/reduce",businessCardPayPrice);
return false;
}
}
import lombok.extern.slf4j.Slf4j;
import org.apache.commons.chain.Command;
import org.apache.commons.chain.Context;
import java.math.BigDecimal;
@Slf4j
public class PromotionPayCommand implements Command {
@Override
public boolean execute(Context context) throws Exception {
OrderContext orderContext = (OrderContext) context;
//查询客户账户下的优惠券余额,比如查询结果是10元
var bPrice = BigDecimal.valueOf(10);
//算出还需要支付的价格
var remainPrice = orderContext.getTotalPrice().subtract(orderContext.getPayTotalPrice());
//该笔订单,优先商旅卡支付全额
if (bPrice.compareTo(remainPrice) >= 0) {
orderContext.setPayTotalPrice(orderContext.getPayTotalPrice().add(remainPrice));
orderContext.setBusinessCardPayPrice(remainPrice);
if (log.isDebugEnabled()) {
log.debug("订单orderId:{} ,订单总价:{},使用优惠券支付了:{},还需要支付:{}",orderContext.getOrderId(),orderContext.getTotalPrice(),orderContext.getBusinessCardPayPrice(),orderContext.getTotalPrice().subtract(orderContext.getPayTotalPrice()));
}
return true;
}else {
// 使用商旅卡支付部分
orderContext.setPayTotalPrice(orderContext.getPayTotalPrice().add(bPrice));
orderContext.setBusinessCardPayPrice(bPrice);
if (log.isDebugEnabled()) {
log.debug("订单orderId:{} ,订单总价:{},使用优惠券支付了:{},还需要支付:{}",orderContext.getOrderId(),orderContext.getTotalPrice(),orderContext.getBusinessCardPayPrice(),orderContext.getTotalPrice().subtract(orderContext.getPayTotalPrice()));
}
return false;
}
}
}
import lombok.extern.slf4j.Slf4j;
import org.apache.commons.chain.Command;
import org.apache.commons.chain.Context;
import org.apache.commons.chain.Filter;
import java.math.BigDecimal;
@Slf4j
public class CashPayCommand implements Filter {
@Override
public boolean execute(Context context) throws Exception {
OrderContext orderContext = (OrderContext) context;
//算出还需要支付的现金
var remainPrice = orderContext.getTotalPrice().subtract(orderContext.getPayTotalPrice());
if (log.isDebugEnabled()) {
log.debug("订单orderId:{} ,订单总价:{},还需要支付现金:{}",orderContext.getOrderId(),orderContext.getTotalPrice(),remainPrice);
}
return false;
}
@Override
public boolean postprocess(Context context, Exception e) {
log.info("打开支付开关,客户端引导跳转收银台去支付");
return false;
}
}
import lombok.extern.slf4j.Slf4j;
import org.apache.commons.chain.Command;
import org.apache.commons.chain.Context;
@Slf4j
public class SysncOrderInfoCommand implements Command {
@Override
public boolean execute(Context context) throws Exception {
if (log.isDebugEnabled()) {
log.debug("同步子系统订单信息到公共订单系统");
}
return false;
}
}
测试
[PromotionPayCommand.java:33]2020-07-29 16:26:45.982 [DEBUG] {main} 订单orderId:1621940242 ,订单总价:100,使用优惠券支付了:10,还需要支付:90
[BusinessPayCommand.java:36]2020-07-29 16:26:45.992 [DEBUG] {main} 订单orderId:1621940242 ,订单总价:100,使用商旅卡支付了:12.5,还需要支付:77.5
[CashPayCommand.java:19]2020-07-29 16:26:45.993 [DEBUG] {main} 订单orderId:1621940242 ,订单总价:100,还需要支付现金:77.5
[SysncOrderInfoCommand.java:12]2020-07-29 16:26:45.994 [DEBUG] {main} 同步子系统订单信息到公共订单系统
[CashPayCommand.java:26]2020-07-29 16:26:45.994 [INFO] {main} 打开支付开关,客户端引导跳转收银台去支付