如何将OCC扩展API集成到自定义Commerce Web Services并在Swagger展示？

以下是需要执行的后续步骤：

• 添加自定义扩展对OCC扩展的显式依赖
  仅在localextensions.xml中启用OCC扩展不够，需要在mycommercewebservices的extensioninfo.xml文件里添加对目标OCC扩展的依赖声明，确保自定义扩展能正确加载OCC的API资源：

  <requires-extension name="b2bocc"/>
  <requires-extension name="b2bpunchoutocc"/>
  <requires-extension name="cmsocc"/>
  

• 导入OCC扩展的Spring Web配置
  在自定义扩展的web/webroot/WEB-INF/config/spring目录下，找到或创建Web Spring配置文件（如mycommercewebservices-web-spring.xml），导入OCC扩展的Spring配置文件，让OCC的API控制器被Spring上下文加载：

  <import resource="classpath:/META-INF/b2bocc-spring.xml"/>
  <import resource="classpath:/META-INF/b2bpunchoutocc-spring.xml"/>
  <import resource="classpath:/META-INF/cmsocc-spring.xml"/>
  

• 配置Swagger扫描OCC的API包
  找到自定义扩展中Swagger的配置类（通常是继承SwaggerConfig的Java类，或XML配置中的swagger-springmvc-plugin），将OCC扩展的API包加入扫描范围：

  • 示例Java配置：

    @Bean
    public Docket api() {
        return new Docket(DocumentationType.SWAGGER_2)
                .select()
                .apis(RequestHandlerSelectors.basePackage("de.hybris.platform.mycommercewebservices.controllers")
                        .or(RequestHandlerSelectors.basePackage("de.hybris.platform.b2bocc.controllers"))
                        .or(RequestHandlerSelectors.basePackage("de.hybris.platform.cmsocc.controllers"))
                        .or(RequestHandlerSelectors.basePackage("de.hybris.platform.b2bpunchoutocc.controllers")))
                .paths(PathSelectors.any())
                .build();
    }
    

  • 若使用XML配置，调整basePackage属性，用逗号分隔多个包路径：

    <bean class="com.mangofactory.swagger.configuration.SpringSwaggerConfig"/>
    <bean class="com.mangofactory.swagger.plugins.SwaggerSpringMvcPlugin">
        <property name="basePackage" value="de.hybris.platform.mycommercewebservices.controllers,de.hybris.platform.b2bocc.controllers,de.hybris.platform.cmsocc.controllers,de.hybris.platform.b2bpunchoutocc.controllers"/>
    </bean>
    

• 重新构建并重启服务
  执行构建命令清理并编译项目：

  ant clean all
  # 或使用Gradle
  ./gradlew clean build
  

  完成后重启Hybris服务器，确保所有配置变更生效。

• 验证与排查
  重启后访问Swagger页面，检查是否出现/b2b、/cms等OCC相关路径的API分组。如果仍未显示，可查看Hybris服务器日志：

  • 搜索是否有OCC控制器加载失败的异常信息
  • 检查Swagger初始化日志，确认是否正确扫描到OCC的API包

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