Hybris批量添加商品至购物车最优方案及关联赠品场景实践咨询

针对你描述的场景（添加X-1时必须自动加入免费的X-2，同时X-2可单独售卖），我在多个Hybris B2C项目中落地过类似需求，最佳实践是结合产品关系配置+购物车扩展钩子+自定义价格策略的组合方案，既符合Accelerator的标准架构，又能保证灵活性和可扩展性，下面详细拆解：

一、先明确核心需求的特殊性 #

你的场景不是普通的捆绑产品（Bundle）——捆绑产品是固定组合，用户无法单独购买其中的单品；而你需要的是触发式关联：只有当用户添加X-1时，才自动加入免费的X-2，同时X-2仍可作为独立商品正常售卖。所以不能直接用Hybris原生的Bundle功能，需要自定义扩展逻辑。

二、分步实现方案 #

1. 后台配置产品关联关系 #

首先在Hybris后台创建一个自定义的产品关系类型，比如命名为mandatoryComplimentary（强制互补品）：

• 进入Backoffice > Product > Relations，创建新的关系类型，设置关联方向为“从主商品到互补品”（比如X-1是主商品，X-2是关联的互补品）。
• 给X-1配置该类型的关联产品为X-2。
• 优势：完全通过后台配置实现商品关联，不需要硬编码商品编码，后续新增类似规则的商品时，直接在后台配置即可，无需修改代码。

2. 扩展购物车添加逻辑，自动插入免费互补品 #

利用Hybris提供的标准扩展点CartModificationHook来拦截购物车添加动作，自动插入互补品：

• 自定义一个MandatoryComplimentaryCartHook类，实现CartModificationHook接口：

  public class MandatoryComplimentaryCartHook implements CartModificationHook {
      private CartService cartService;
      private ProductRelationService productRelationService;
      private ModelService modelService;
  
      @Override
      public void afterModify(final CartModel cart, final List<CartModificationModel> modifications) {
          // 遍历本次添加的商品条目
          for (CartModificationModel modification : modifications) {
              ProductModel product = modification.getEntry().getProduct();
              // 获取当前商品的强制互补品
              List<ProductModel> complimentaryProducts = productRelationService.getRelationsForSource(product, "mandatoryComplimentary");
              if (!complimentaryProducts.isEmpty()) {
                  for (ProductModel complimentary : complimentaryProducts) {
                      // 检查购物车中是否已存在该互补品的免费条目
                      boolean hasFreeComplimentary = cart.getEntries().stream()
                          .anyMatch(entry -> entry.getProduct().equals(complimentary) && Boolean.TRUE.equals(entry.getIsComplimentary()));
                      if (!hasFreeComplimentary) {
                          // 添加免费互补品到购物车
                          CartEntryModel complimentaryEntry = cartService.addEntry(cart, complimentary, 1, null, null);
                          // 标记为免费附赠
                          complimentaryEntry.setIsComplimentary(true);
                          modelService.save(complimentaryEntry);
                      }
                  }
              }
          }
      }
  
      // 省略getter/setter
  }
  

• 在spring.xml中注册这个钩子，让Hybris在购物车修改时自动调用：

  <bean id="mandatoryComplimentaryCartHook" class="com.yourstore.core.hook.MandatoryComplimentaryCartHook">
      <property name="cartService" ref="cartService"/>
      <property name="productRelationService" ref="productRelationService"/>
      <property name="modelService" ref="modelService"/>
  </bean>
  
  <bean parent="cartModificationHookList">
      <property name="list">
          <list>
              <ref bean="mandatoryComplimentaryCartHook"/>
          </list>
      </property>
  </bean>
  

3. 自定义价格计算策略，确保互补品价格为0 #

需要覆盖Hybris的购物车条目价格计算逻辑，让标记为isComplimentary的条目价格为0：

• 自定义ComplimentaryCartEntryPriceCalculationStrategy类，实现CartEntryPriceCalculationStrategy接口：

  public class ComplimentaryCartEntryPriceCalculationStrategy extends DefaultCartEntryPriceCalculationStrategy {
      @Override
      public PriceInformation calculateUnitPrice(final CartEntryModel entry) {
          // 如果是免费附赠条目，返回价格为0
          if (Boolean.TRUE.equals(entry.getIsComplimentary())) {
              return PriceInformationFactory.createForZeroPrice(entry.getProduct().getUnit());
          }
          // 否则使用默认价格计算逻辑
          return super.calculateUnitPrice(entry);
      }
  }
  

• 在spring.xml中替换默认的策略：

  <bean id="cartEntryPriceCalculationStrategy" class="com.yourstore.core.price.ComplimentaryCartEntryPriceCalculationStrategy">
      <property name="priceFactory" ref="priceFactory"/>
      <property name="productService" ref="productService"/>
  </bean>
  

4. 处理移除主商品时的联动逻辑 #

当用户从购物车中移除X-1时，需要自动移除对应的免费X-2条目（但保留用户单独添加的付费X-2）：

• 自定义ComplimentaryCartRemovalHook类，实现CartRemovalHook接口：

  public class ComplimentaryCartRemovalHook implements CartRemovalHook {
      private CartService cartService;
      private ProductRelationService productRelationService;
  
      @Override
      public void afterRemove(final CartModel cart, final List<CartEntryModel> removedEntries) {
          for (CartEntryModel removedEntry : removedEntries) {
              ProductModel removedProduct = removedEntry.getProduct();
              // 获取该商品的强制互补品
              List<ProductModel> complimentaryProducts = productRelationService.getRelationsForSource(removedProduct, "mandatoryComplimentary");
              if (!complimentaryProducts.isEmpty()) {
                  // 查找购物车中对应的免费互补品条目并移除
                  List<CartEntryModel> toRemove = cart.getEntries().stream()
                      .filter(entry -> complimentaryProducts.contains(entry.getProduct()) && Boolean.TRUE.equals(entry.getIsComplimentary()))
                      .collect(Collectors.toList());
                  toRemove.forEach(entry -> cartService.removeEntry(cart, entry));
              }
          }
      }
  
      // 省略getter/setter
  }
  

• 在spring.xml中注册这个钩子：

  <bean id="complimentaryCartRemovalHook" class="com.yourstore.core.hook.ComplimentaryCartRemovalHook">
      <property name="cartService" ref="cartService"/>
      <property name="productRelationService" ref="productRelationService"/>
  </bean>
  
  <bean parent="cartRemovalHookList">
      <property name="list">
          <list>
              <ref bean="complimentaryCartRemovalHook"/>
          </list>
      </property>
  </bean>
  

5. 前台页面优化 #

在产品详情页和购物车页添加提示信息，提升用户体验：

• 在X-1的产品详情页，添加提示：“购买此商品将免费附赠X-2”。
• 在购物车页，对X-2的免费条目显示：“X-2（免费，随X-1附赠）”，避免用户困惑。

三、关键注意事项 #

• 避免硬编码：所有商品关联关系都通过后台配置，不要在代码中写死X-1、X-2的编码，后续扩展更方便。
• 性能优化：如果批量添加多个商品，建议批量查询关联产品，避免逐个查询数据库。
• 兼容性：确保自定义的价格策略与Hybris原生的促销、折扣逻辑兼容，比如促销活动不会覆盖免费条目的0价格。
• 测试覆盖：要测试所有场景：添加X-1、单独添加X-2、添加X-1后再添加X-2、移除X-1、移除免费X-2等。

内容的提问来源于stack exchange，提问作者Hatip Kabak