原创 飘渺Jam JAVA日知录 2023-12-14 08:32 发表于安徽
大家好,让我们继续DDD&微服务系列,今天,我们看看在DailyMart项目中如何基于DDD完成订单的创建功能。
1. 业务分析
在DailyMart进行购物时,用户经历以下步骤:
1)用户登录系统,浏览商品,并将心仪的商品加入购物车。
2)进入购物车,选择要购买的商品,填写收货信息,生成订单。
3)扫码支付,等待仓库发货。
4)用户收到货后确认收货,订单完结。

订单域作为DailyMart系统的核心,其逻辑相当复杂。本文将专注于订单生成的处理逻辑。通常而言,生成订单的逻辑包含以下步骤:
2. 订单生成逻辑
-
获取用户购物车项: 首先,系统需要获取当前用户已选中的购物车项。
-
库存校验: 对选中的商品进行库存校验。如果库存不足,无法生成订单,并向用户提供相应提示。
-
订单及明细生成与持久化: 通过选中的商品生成订单及订单明细,并将其插入数据库进行持久化。此时,订单状态为待支付。
-
库存预占用: 对订单涉及的商品进行库存预占用。详细的库存扣减细节可参考《基于DDD如何实现库存扣减》一文。
-
订单超时处理: 如果用户在规定时间内未支付订单,系统需要关闭订单并释放预占库存。
-
购物车清空: 最后,清空用户选中的购物车商品。

结合业务分析与订单生成逻辑,我们可以得到订单模块的领域模型:

交易订单 (TradeOrder): 订单模块是一个聚合,每个订单有唯一的订单ID作为标识。
订单项(OrderItem):订单项是订单聚合中的一个实体,代表订单中的一个明细商品。
收货人信息(RecipientInfo): 收货人信息是一个值对象,它没有自己的唯一标识,一旦订单创建就不能被修改,只能被替换。
订单状态(OrderStatusEnum): 订单状态是一个值对象,表示订单的不同状态,例如待支付、待发货、已发货、已完成、已关闭等,在实现时用枚举类表示。
3. 代码模型分层
基于DDD的四层架构模型(接口层、应用服务层、领域层、基础设施层)如下:
-
接口层: 提供创建订单的接口,接收用户生成订单的请求,传入收件人信息。
-
应用服务层: 负责组装业务逻辑,包括获取购物车已选择的商品、库存校验、订单生成等。
-
领域层: 包含订单聚合、实体、值对象,负责核心领域逻辑的实现。
-
基础设施层: 定义与外部系统交互的接口,包括购物车、库存等远程调用。同时,通过领域事件和延时消息实现订单创建后的清空购物车、预占用库存、订单超时处理等逻辑。
4. 代码实现
4.1 订单创建接口
@Operation(summary = "创建订单")
@PostMapping("/api/pd/order/create")
public String create(@RequestBody OrderCreateRequest createRequest) {
return orderService.createOrder(createRequest);
}
调用接口时需要提供包含订单详情的请求体(OrderCreateRequest),接口返回生成的订单号。
4.2 订单的应用服务
@Service
@RequiredArgsConstructor(onConstructor = @__(@Autowired))
@Slf4j
public class OrderServiceImpl implements OrderService {
/**
* 通过购物车创建订单
* @param orderCreateRequest 创建订单参数
* 业务逻辑如下:
* 1. 将商品加入购物车
* 2. 在购物车选中商品,修改购物车商品状态,同时需要校验库存状态
* 3. 下单时下的是购物车中被勾选的商品
* 4. 做前置校验
* 5. 生成订单号
* 6. 保存订单
* 7. 删除购物车中勾选的商品
*/
@Override
@Transactional(rollbackFor = RuntimeException.class)
public String createOrder(OrderCreateRequest orderCreateRequest) {
// 生成订单编号
String orderSn = IdUtils.nextIdStr();
// 获取购物车详情
ShoppingCartDetailDTO shoppingCartDetailDTO = cartRemoteFacade.queryCheckedCartItemByUserId(orderCreateRequest.getCustomerId());
List<CartItemDTO> cartItemList = shoppingCartDetailDTO.getCartItemDtoS();
//校验库存
checkInventory(cartItemList);
...
orderRepository.save(tradeOrder);
eventPublisher.publishEvent(new OrderCreatedEvent(tradeOrder));
return orderSn;
}
/**
* 校验库存
* @param cartItemDtoS 购物车明细
*/
private void checkInventory(List<CartItemDTO> cartItemDtoS) {
List<InventoryLockDetail> lockDetailList = OrikaMapperUtils.INSTANCE.convertList(cartItemDtoS, InventoryLockDetail.class);
// 校验库存
List<ItemInventoryCheckedDTO> checkedAvailability = inventoryRemoteFacade.checkAvailability(lockDetailList);
checkedAvailability.stream()
.filter(item -> !item.isAvailable())
.findFirst()
.ifPresent(item -> {
throw new BusinessException(item.getSkuId() + "库存不足,可用库存为:" + item.getInventoryQuantity());
});
}
}
createOrder 方法实现了通过购物车创建订单的业务逻辑,包括生成订单号、校验库存、保存订单等步骤。
有经验的小伙伴可能注意到在这个方法中是使用@Transactional注解来保证事务,但是这个方法中有很多远程服务调用,这就会导致大事务的产生,你知道如何解决这个问题吗?
4.3 领域事件的监听
在订单创建事件(OrderCreatedEvent)发布后,多个监听器分别处理库存预占用、购物车清空、发布延时消息等逻辑。在SpringBoot中,通过 @Order 注解可以指定执行顺序,这里以库存占用为例:
@Order(1)
@Component
@Slf4j
public class InventoryWithholdListener implements ApplicationListener<OrderCreatedEvent> {
@Resource
private InventoryRemoteFacade inventoryRemoteFacade;
/**
* 收到消息以后调用远程接口,实现库存扣减
* @param event 订单创建事件
*/
@Override
public void onApplicationEvent(@NotNull OrderCreatedEvent event) {
log.info("收到订单创建消息,执行库存预占用逻辑" + event);
TradeOrder tradeOrder = (TradeOrder) event.getSource();
List<OrderItem> orderItems = tradeOrder.getOrderItems();
List<InventoryLockDetail> lockDetailList = orderItems.stream().map(
orderItem -> InventoryLockDetail.builder()
.skuId(orderItem.getSkuId())
.spuId(orderItem.getSpuId())
.quantity(orderItem.getProductQuantity())
.build())
.toList();
InventoryLockRequest lockRequest = InventoryLockRequest.builder()
.detailList(lockDetailList)
.userId(tradeOrder.getCustomerId())
.transactionId(tradeOrder.getOrderSn())
.build();
try {
inventoryRemoteFacade.withholdInventory(lockRequest);
} catch (Exception e) {
log.error("库存占用失败,入参[{}]", JsonUtils.obj2String(tradeOrder));
throw new BusinessException("库存占用失败,订单编号:" + tradeOrder.getOrderSn());
}
}
}
同时,需要发送延时消息,这里可以借助RocketMQ的延时消息来实现。关于DailyMart与RocketMQ的整合在之前文章中已有详细说明,感兴趣的同学可以翻阅:SpringBoot 集成RocketMQ,这种方式才叫优雅!
@Order(3)
@Component
@Slf4j
public class DelayCloseListener implements ApplicationListener<OrderCreatedEvent> {
@Resource
private RocketMQEnhanceTemplate rocketMQEnhanceTemplate;
/**
* 收到消息以后需要发送延时消息,用以确保订单及时支付
* @param event 订单创建事件
*/
@Override
public void onApplicationEvent(@NotNull OrderCreatedEvent event) {
log.info("收到订单创建消息,发送延时消息到Rocketmq" + event);
TradeOrder tradeOrder = (TradeOrder) event.getSource();
DelayCloseOrderEvent orderMessage = new DelayCloseOrderEvent(tradeOrder.getCustomerId(), tradeOrder.getOrderSn());
rocketMQEnhanceTemplate.sendDelay("TRADE-ORDER", "DELAY-CLOSE", orderMessage, DelayMessageConstant.TWO_MINUTE);
}
}
4.4 订单的领域层
在领域层除了定义订单模型的聚合、实体、值对象以外还需要定义仓储接口
public interface OrderRepository extends Repository<TradeOrder, OrderId> {
/**
* 根据订单编号查询订单
* @param orderSn 订单号
* @return 订单聚合
*/
TradeOrder findOrderByTransaction(String orderSn);
/**
* 关闭订单
* @param orderSn 订单号
*/
void closeOrder(String orderSn);
}
OrderRepository 定义了订单领域层的仓储接口,包括根据订单编号查询订单和关闭订单的方法。
4.4 远程接口定义
在基础设施层需要定义两个基于OpenFeign的接口,用于处理获取用户选中的购物车商品、购物车清理、库存占用等逻辑,以库存接口为例:
@FeignClient("inventory-service")
public interface InventoryRemoteFacade {
/**
* 库存预扣减
* @param lockRequest 扣减对象
*/
@PostMapping("/api/pd/inventory/withholdInventory")
String withholdInventory(@Valid @RequestBody InventoryLockRequest lockRequest);
/**
* 获取库存数据
*/
@PostMapping("/api/pd/inventory/checkAvailability")
List<ItemInventoryCheckedDTO> checkAvailability(@RequestBody List<InventoryLockDetail> inventoryLockDetails);
...
}
这里需要说明的是,由于我们系统中通过自定义OpenFeign的解码器DailyMartFeignResponseDecoder来实现包装对象的自动解码(参见 优雅远程调用,微服务中ACL与OpenFeign的绝佳配合),这要求接口必须要有返回值,如果是void的则不会经过解码器处理,无法正确解析业务异常。
说明:在之前的库存扣减一文中,只支持单个商品的库存扣减,但是实际应用中一个订单有可能包含多个商品,所以本次对于库存模块进行了重构,让其支持多商品扣减。具体请参阅源码~
4.5 监听延时消息
在订单的基础设施层需要监听RocketMQ发送的延时消息,用于确保及时关闭订单和释放库存:
@Component
@Slf4j
@RocketMQMessageListener(consumerGroup = "dailymart_order_group", topic = "TRADE-ORDER", selectorExpression = "DELAY-CLOSE")
public class OrderDelayClosedConsumer extends EnhanceMessageHandler<DelayCloseOrderEvent> implements RocketMQListener<DelayCloseOrderEvent> {
@Resource
private InventoryRemoteFacade inventoryRemoteFacade;
@Resource
private OrderRepository orderRepository;
@Override
protected void handleMessage(DelayCloseOrderEvent delayCloseOrderEvent) {
// 思考一下,收到延时关闭的订单消息需要做什么呢?
// 1. 查看订单支付状态
// 1.1 如果已支付,则无需处理消息
// 1.2 如果未支付,则需要关闭订单, 释放库存
String orderSn = delayCloseOrderEvent.getOrderSn();
TradeOrder tradeOrder = orderRepository.findOrderByTransaction(orderSn);
if (Objects.equals(tradeOrder.getStatus(), OrderStatusEnum.WAITING_PAYMENT.getStatus())) {
orderRepository.closeOrder(orderSn);
inventoryRemoteFacade.unWithhold(orderSn);
}
}
@Override
protected void handleMaxRetriesExceeded(DelayCloseOrderEvent delayCloseOrderEvent) {
log.error("此订单关闭出错,需要人工干预,订单编号 {},重试次数{}",delayCloseOrderEvent.getOrderSn(),delayCloseOrderEvent.getRetryTimes());
}
@Override
public void onMessage(DelayCloseOrderEvent delayCloseOrderEvent) {
super.dispatchMessage(delayCloseOrderEvent);
}
}
订单的关闭与库存的释放是由两个不同的服务实现,这会导致分布式事务的产生,关于分布式问题后面有专门的文章进行说明与处理。
5. 小结
订单域作为交易系统的核心领域,不仅具有复杂的内部业务流程,还需要与其他模块紧密合作。在本文中,我们详细解析了订单的创建流程,并通过整合远程调用、领域事件、消息队列等组件,实现了这些组件之间的协同工作,从而成功完成了订单的创建逻辑。
以上,就是今天的主要内容了,如果对你有所帮助,还请点赞支持以下,最好是一键三连。
DailyMart是一个基于 DDD 和Spring Cloud Alibaba的微服务商城系统,同时还会在该系统中整合其他专栏的精华内容,譬如分库分表、设计模式、老鸟系列,开发实践等......希望能通过此专栏为开发者提供一个集成式的学习体验,并将其无缝地运用于实际项目中。如果你对这个系列感兴趣可以在本公众号回复关键词 DDD 以获取完整文档以及相关源码。


1099



被折叠的 条评论
为什么被折叠?



