2026-06-26 20b96473f2520590a0dca6b775b81e3ea06a77a0
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
package cn.iocoder.yudao.module.trade.service.order.handler;
 
import cn.iocoder.yudao.framework.common.util.collection.CollectionUtils;
import cn.iocoder.yudao.module.trade.dal.dataobject.order.TradeOrderDO;
import cn.iocoder.yudao.module.trade.dal.dataobject.order.TradeOrderItemDO;
import cn.iocoder.yudao.module.trade.enums.order.TradeOrderItemAfterSaleStatusEnum;
 
import java.util.List;
 
/**
 * 订单活动特殊逻辑处理器 handler 接口
 * 提供订单生命周期钩子接口;订单创建前、订单创建后、订单支付后、订单取消
 *
 * @author HUIHUI
 */
public interface TradeOrderHandler {
 
    /**
     * 订单创建前
     *
     * @param order 订单
     * @param orderItems 订单项
     */
    default void beforeOrderCreate(TradeOrderDO order, List<TradeOrderItemDO> orderItems) {}
 
    /**
     * 订单创建后
     *
     * @param order 订单
     * @param orderItems 订单项
     */
    default void afterOrderCreate(TradeOrderDO order, List<TradeOrderItemDO> orderItems) {}
 
    /**
     * 支付订单后
     *
     * @param order 订单
     * @param orderItems 订单项
     */
    default void afterPayOrder(TradeOrderDO order, List<TradeOrderItemDO> orderItems) {}
 
    /**
     * 订单取消后
     *
     * @param order 订单
     * @param orderItems 订单项
     */
    default void afterCancelOrder(TradeOrderDO order, List<TradeOrderItemDO> orderItems) {}
 
    /**
     * 订单项取消后
     *
     * @param order 订单
     * @param orderItem 订单项
     */
    default void afterCancelOrderItem(TradeOrderDO order, TradeOrderItemDO orderItem) {}
 
    /**
     * 订单发货前
     *
     * @param order 订单
     */
    default void beforeDeliveryOrder(TradeOrderDO order) {}
 
    /**
     * 订单发货后
     *
     * @param order 订单
     */
    default void afterDeliveryOrder(TradeOrderDO order) {}
 
    /**
     * 订单收货前
     *
     * @param order 订单
     */
    default void beforeReceiveOrder(TradeOrderDO order) {}
 
    /**
     * 订单收货后
     *
     * @param order 订单
     */
    default void afterReceiveOrder(TradeOrderDO order) {}
 
    // ========== 公用方法 ==========
 
    /**
     * 过滤“未售后”的订单项列表
     *
     * @param orderItems 订单项列表
     * @return 过滤后的订单项列表
     */
    default List<TradeOrderItemDO> filterOrderItemListByNoneAfterSale(List<TradeOrderItemDO> orderItems) {
        return CollectionUtils.filterList(orderItems,
                item -> TradeOrderItemAfterSaleStatusEnum.isNone(item.getAfterSaleStatus()));
    }
 
}