WebSphere Commerce 结账流程会调用哪些命令？

结论

WebSphere Commerce 并不存在一份适用于所有商店和版本的固定“结账命令调用清单”。

用户从购物车进入订单摘要页时，通常会涉及以下 controller commands：

• OrderItemAddCmd
• OrderItemUpdateCmd
• OrderCalculateCmd
• OrderShippingInfoUpdateCmd
• OrderPrepareCmd

登录环节还可能调用 LogonCmd。有些商店会通过自定义命令或 Ajax 包装命令提交请求。OrderProcessCmd 通常在用户最终确认并提交订单时调用，而不是在打开 Order Summary 页面时调用。

内部 task commands 的数量和执行顺序取决于 WebSphere Commerce 版本、商店模型、结账方式、计算规则、库存系统、支付插件及项目定制。仅凭页面名称无法列出可靠的完整清单。要还原实际调用链，需要结合商店的 JSP/JavaScript、URL command 配置和运行时 trace。

常见流程及对应命令

下表列出了传统 WebSphere Commerce B2C 商店中较常见的对应关系，可作为排查入口，但不是所有版本通用的标准调用顺序。

页面跳转本身不一定会调用业务 controller command。有些页面只通过 view command 渲染，只有在用户提交表单或前端发出 Ajax 请求时，系统才会执行订单相关命令。因此，页面名称和命令之间不能简单地一一对应。

为什么无法列出固定的 task commands

Controller command 是结账请求的入口。它在执行过程中可能继续调用多层 task commands，处理以下工作：

• 计算订单价格、折扣、税费和运费；
• 验证地址并处理配送方式；
• 检查库存、分配库存或选择履约中心；
• 检查合同、购买资格和购买限制；
• 创建支付指令并调用支付插件；
• 锁定和准备订单，转换订单状态；
• 执行商店自行扩展或替换的命令。

实际实现类通常由命令注册表解析。同一个接口名称在不同商店或 store group 中可能映射到不同的实现。例如：

OrderCalculateCmd command =
    (OrderCalculateCmd) CommandFactory.createCommand(
        OrderCalculateCmd.NAME,
        getStoreId()
    );

command.setCommandContext(getCommandContext());
command.setRequestProperties(getRequestProperties());
command.execute();

因此，只查看某个 controller command 的接口或默认实现，既不能证明生产环境执行的就是该实现，也无法覆盖它间接调用的所有 task commands。

如何得到当前商店的完整调用流程

1. 从前端请求开始定位

先检查结账页面中的以下内容：

• <form action="...">
• JavaScript 或 Ajax 请求地址；
• URL、viewName、orderId、calculationUsageId 等参数；
• 页面跳转前执行的 service 或 controller；
• 商店使用的 REST 接口及其服务实现。

页面可能会提交类似下面的请求：

<form action="OrderShippingInfoUpdate" method="post">
    <input type="hidden" name="orderId" value="." />
    <input type="hidden" name="URL" value="OrderPrepare" />
    <!-- shippingAddressId、shipModeId 等字段 -->
</form>

从这里可以确认直接入口是 OrderShippingInfoUpdate。不过，URL=OrderPrepare 通常表示前一个命令成功后的跳转目标，不能据此认定这两个命令在同一个调用栈中执行。

2. 查询 URL command 和命令注册

确定请求名称后，检查该名称对应的 command interface、默认实现和商店级覆盖配置，重点查看：

• URL command 到 controller command 的映射；
• command interface 到实现类的映射；
• 是否存在针对特定 storeId 的覆盖；
• 项目是否重写了 performExecute()；
• 是否通过 CommandFactory.createCommand() 调用了其他命令。

搜索代码时可以关注：

performExecute()
CommandFactory.createCommand(...)
execute()
setCommandContext(...)

3. 沿实现类追踪 task commands

从 controller command 的实际实现开始，依次记录：

1. 直接创建的 task command；
2. task command 内部继续创建的命令；
3. calculation、inventory、fulfillment 和 payment 子系统调用；
4. 扩展点、策略命令和自定义实现；
5. 异步处理或外部系统调用。

记录时最好使用调用树，而不是简单罗列命令：

OrderPrepareCmd
├── OrderCalculateCmd
│   ├── promotion calculation
│   ├── shipping calculation
│   └── tax calculation
├── inventory validation
├── shipping validation
└── payment instruction validation

这些节点仅用于说明调用树的结构，不代表某个具体版本中的真实类名。

4. 在非生产环境开启命令跟踪

确认完整调用链最可靠的方式是运行时 trace。可以在 WebSphere Application Server 管理控制台中开启与 Commerce command、order、calculation 和 payment 相关的 trace，然后完整执行一次结账流程。

不同版本的 WebSphere Commerce 可能使用不同的 trace component 名称，常见范围包括：

com.ibm.websphere.commerce.command.*
com.ibm.websphere.commerce.order.*
com.ibm.websphere.commerce.payment.*
com.ibm.websphere.commerce.fulfillment.*

具体 trace specification 应以当前版本的 IBM 文档和服务器中实际可用的 trace component 为准。不要直接在生产环境中套用上述通配范围。命令级全量 trace 可能产生大量日志，其中还可能包含订单、地址或支付相关数据。

采集时建议：

• 使用独立测试用户和新建购物车；
• 记录每次点击的时间；
• 保存浏览器 Network 请求；
• 通过订单号、会话标识或线程标识关联日志；
• 分别采集进入页面和提交页面产生的请求；
• 采集完成后立即恢复 trace 配置；
• 分享日志前对 cookie、地址、手机号和支付数据进行脱敏。

文档查找方向

IBM 文档通常分别说明各个命令的职责、参数和接口，不会提供一张适用于所有商店的端到端调用图。可以在对应版本的 IBM Documentation 或旧版 Knowledge Center 中搜索：

OrderItemAddCmd
OrderItemUpdateCmd
OrderCalculateCmd
OrderShippingInfoUpdateCmd
OrderPrepareCmd
OrderProcessCmd
WebSphere Commerce command framework
WebSphere Commerce command registry
WebSphere Commerce tracing

还需要结合当前项目采用的参考商店文档，例如 Aurora、Madisons 或项目自建 storefront。不同参考商店使用的页面控制器和 Ajax 服务并不完全相同。

注意事项

• ShoppingCart、ShippingInfo、PaymentMethod 等通常是页面名或 view 名，不一定是 command 名称。
• 一次浏览器操作可能产生多个 Ajax 请求，并执行多个 controller commands。
• OrderCalculateCmd 可能在购物车、配送方式和订单准备等阶段重复执行。
• 支付命令受版本和支付框架影响较大，不宜脱离具体版本列举。
• 不要混淆 OrderPrepareCmd 和 OrderProcessCmd。前者通常负责提交前的准备工作，后者负责最终订单处理。
• 如果项目覆盖了命令注册，只阅读 IBM 默认实现会得到错误的调用链。
• 要获得“全部 task commands”，必须以当前部署的代码、注册配置和运行日志为准。官方接口文档只能用于了解各个命令的职责。

备注：内容仅供参考。