Spring Boot中CXF WebService配置类注解方式导入SchemaLocation问题

我来帮你搞定这个注解配置Schema的难题！之前用XML能实现，换成注解其实就是把XML里的配置逻辑转化为对应的Bean定义，核心是通过SimpleXsdSchema加载XSD文件，再关联到WSDL定义中。

步骤1：放置XSD文件 #

先把你的XSD文件放到src/main/resources/xsd目录下（这个路径可以自定义，只要后续能正确读取就行），确保Spring可以通过类路径访问到它。

步骤2：编写注解式配置类 #

创建一个带@Configuration和@EnableWs的配置类，通过定义DefaultWsdl11Definition和XsdSchema Bean来关联你的Schema：

@Configuration
@EnableWs // 开启Spring WebService支持
public class WebConfWebServiceConfig extends WsConfigurerAdapter {

    // 定义WSDL端点
    @Bean(name = "webConfWebService")
    public DefaultWsdl11Definition webConfWsdlDefinition(XsdSchema webConfSchema) {
        DefaultWsdl11Definition wsdlDefinition = new DefaultWsdl11Definition();
        // 设置端口名称，对应XML里的port-type-name
        wsdlDefinition.setPortTypeName("WebConfPort");
        // 设置WebService的访问路径
        wsdlDefinition.setLocationUri("/ws/webconf");
        // 设置命名空间，要和你的XSD里的targetNamespace一致
        wsdlDefinition.setTargetNamespace("http://your-domain.com/webconf");
        
        // 如果是单个XSD，用setSchema；多个的话用setSchemas传入数组
        wsdlDefinition.setSchema(webConfSchema);
        // 多XSD示例：wsdlDefinition.setSchemas(new XsdSchema[]{webConfSchema, anotherXsdSchema});
        
        return wsdlDefinition;
    }

    // 加载你的XSD文件
    @Bean
    public XsdSchema webConfSchema() {
        return new SimpleXsdSchema(new ClassPathResource("xsd/webconf.xsd"));
    }

    // 如果有多个XSD，添加对应的XsdSchema Bean即可
    // @Bean
    // public XsdSchema anotherXsdSchema() {
    //     return new SimpleXsdSchema(new ClassPathResource("xsd/another-webconf.xsd"));
    // }
}

步骤3：编写端点类（示例） #

配套的端点类用@Endpoint注解标记，确保命名空间和XSD、WSDL配置一致：

@Endpoint
public class WebConfEndpoint {
    // 必须和XSD里的targetNamespace一致
    private static final String NAMESPACE_URI = "http://your-domain.com/webconf";

    @PayloadRoot(namespace = NAMESPACE_URI, localPart = "GetConfigRequest")
    @ResponsePayload
    public GetConfigResponse handleGetConfigRequest(@RequestPayload GetConfigRequest request) {
        // 这里写你的业务逻辑
        GetConfigResponse response = new GetConfigResponse();
        response.setConfigValue("your-config-data");
        return response;
    }
}

对应XML配置的逻辑对比 #

你之前的XML配置大概是这样的：

<sws:wsdl-definition id="webConfWebService" port-type-name="WebConfPort" location-uri="/ws/webconf" target-namespace="http://your-domain.com/webconf">
    <sws:xsd location="classpath:xsd/webconf.xsd"/>
    <sws:xsd location="classpath:xsd/another-webconf.xsd"/>
</sws:wsdl-definition>

注解方式其实就是把<sws:xsd>标签转化为XsdSchema Bean，再通过DefaultWsdl11Definition的setSchema/setSchemas方法关联，逻辑完全对应。

注意事项 #

• 确保XSD的targetNamespace和配置类、端点类里的命名空间完全一致
• 如果XSD之间有依赖（比如import其他XSD），只要都放在类路径下，SimpleXsdSchema会自动处理依赖关系
• 启动应用后，访问http://localhost:8080/ws/webconf.wsdl就能看到包含Schema引用的WSDL了

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