SAP HYBRIS [Y]：如何创建自定义拦截器（初学者求基础示例）

嘿，作为刚接触Hybris的新手，搞懂拦截器其实没那么复杂！咱们就以产品保存前的校验拦截为例，一步步实现，保证你能快速上手。

1. 先搞懂拦截器的核心逻辑 #

Hybris的拦截器就是在模型对象执行CRUD操作的特定节点插入自定义逻辑——比如保存前校验数据、加载时补充信息、删除前做清理等等。咱们先从最常用的PrepareInterceptor入手，它会在模型对象被保存到数据库之前触发。

2. 创建拦截器类 #

首先在你的自定义extension里新建一个拦截器类，实现PrepareInterceptor接口，指定处理的模型类型为ProductModel：

package com.yourcompany.hybris.interceptors;

import de.hybris.platform.core.model.product.ProductModel;
import de.hybris.platform.servicelayer.interceptor.InterceptorContext;
import de.hybris.platform.servicelayer.interceptor.InterceptorException;
import de.hybris.platform.servicelayer.interceptor.PrepareInterceptor;

public class ProductPrepareInterceptor implements PrepareInterceptor<ProductModel> {

    // 核心方法：在产品保存前执行自定义逻辑
    @Override
    public void onPrepare(ProductModel product, InterceptorContext context) throws InterceptorException {
        // 逻辑1：校验产品名称不能为空
        if (product.getName() == null || product.getName().trim().isEmpty()) {
            // 抛出异常会阻止产品保存，同时返回错误提示
            throw new InterceptorException("产品名称不能为空，请补充后再保存！");
        }

        // 逻辑2：给新产品自动设置默认状态（可选示例）
        if (context.isNew(product)) {
            product.setApprovalStatus(ProductApprovalStatus.APPROVED);
            System.out.println("已为新产品自动设置为【已批准】状态");
        }
    }
}

3. 注册拦截器到Spring容器 #

Hybris是基于Spring的，所以得把咱们的拦截器注册进去，让系统知道它的存在。在你的extension的resources/META-INF/spring目录下的your-extension-spring.xml里添加配置：

<!-- 定义拦截器Bean -->
<bean id="productPrepareInterceptor" class="com.yourcompany.hybris.interceptors.ProductPrepareInterceptor"/>

<!-- 把拦截器绑定到ProductModel的Prepare阶段 -->
<bean id="productInterceptorRegistry" class="de.hybris.platform.servicelayer.interceptor.impl.InterceptorRegistry">
    <property name="modelClass" value="de.hybris.platform.core.model.product.ProductModel"/>
    <property name="prepareInterceptors">
        <list>
            <ref bean="productPrepareInterceptor"/>
        </list>
    </property>
</bean>

小提示：如果你的Hybris版本支持注解，也可以直接在拦截器类上加@Interceptor注解，省去XML配置：

@Interceptor(type = InterceptorType.PREPARE, modelClass = ProductModel.class)
public class ProductPrepareInterceptor implements PrepareInterceptor<ProductModel> {
    // ... 代码不变 ...
}

记得要确保Spring能扫描到这个类所在的包哦。

4. 测试拦截器 #

现在启动Hybris服务器，打开Backoffice或者HMC，试试这两个操作：

• 新建一个产品，故意不填名称，点击保存——应该会弹出错误提示，阻止保存；
• 新建一个产品并填写名称，保存后查看控制台，会打印出咱们设置的日志，同时产品的审批状态会自动设为“已批准”。

额外小知识：常见拦截器类型 #

除了PrepareInterceptor，Hybris还有这些常用的拦截器类型：

• LoadInterceptor：模型对象从数据库加载时触发，适合补充额外数据；
• ValidateInterceptor：专门做数据校验，和Prepare的区别是它在Prepare之后、保存之前执行；
• RemoveInterceptor：模型对象被删除前触发，适合做关联数据清理。

这样一套下来，你应该就能理解自定义拦截器的基本流程了，后续可以根据业务需求扩展更复杂的逻辑哦！

内容的提问来源于stack exchange，提问作者CHARAFI Saad