Spring Boot集成SOAP服务：WSDL转Java教程

1. 理解WSDL与Java类转换的挑战

Web服务描述语言（WSDL）是用于描述SOAP（Simple Object Access Protocol）服务接口的标准XML格式。在Java项目中，为了与SOAP服务进行交互，通常需要将WSDL定义转换为Java类。这些生成的Java类包括服务接口、数据传输对象（DTOs）以及用于调用服务的桩（stubs）。

然而，在实际操作中，开发者常会遇到以下问题：

• wsimport工具的兼容性问题： 随着Java版本的发展，wsimport工具（JAX-WS的一部分）在JDK 11及更高版本中被移除或移至单独的模块。例如，在Java 19环境下直接运行wsimport可能因找不到运行时支持而失败，提示“Unable to locate a Java Runtime that supports wsimport”。
• IDE工具集成不足： 即使是像Eclipse这样的企业级IDE，在某些安装包或配置下，也可能缺少直接从WSDL生成Java类的Web服务插件选项，导致操作受阻。

面对这些挑战，一种更健壮、可维护且与现代构建流程集成的解决方案显得尤为重要。

2. 基于Maven/Gradle和JAXB自动化WSDL到Java的生成

推荐的方法是利用项目构建工具（如Maven或Gradle）结合JAXB（Java Architecture for XML Binding）相关的插件来自动化WSDL到Java类的生成过程。这种方法具有以下优势：

• 自动化与可重复性： 生成过程集成到构建生命周期中，确保每次构建都能生成最新的客户端代码。
• 版本控制： WSDL文件可以与项目代码一同置于版本控制系统下，便于追踪变更。
• 环境独立性： 不依赖于特定IDE或JDK版本中wsimport工具的存在。

2.1 Maven配置示例

对于Maven项目，可以使用jaxws-maven-plugin或cxf-codegen-plugin等插件来完成WSDL到Java的转换。这里以jaxws-maven-plugin为例，它能够调用内部的wsimport功能，并处理JDK兼容性问题。

首先，将WSDL文件放置在项目的某个目录下，例如src/main/resources/wsdl/server.wsdl。

在pom.xml的部分的中添加插件配置：

    
        
            org.codehaus.mojo
            jaxws-maven-plugin
            2.6 
            
                
                    
                        wsimport
                    
                
            
            
                ${project.basedir}/src/main/resources/wsdl
                
                    server.wsdl 
                
                ${project.build.directory}/generated-sources/wsimport
                true
                true
                com.example.soap.client 
                
                
            
            
                
                
                    com.sun.xml.ws
                    jaxws-rt
                    2.3.5 
                
                
                    jakarta.xml.ws
                    jakarta.xml.ws-api
                    2.3.3
                
                
                    jakarta.jws
                    jakarta.jws-api
                    2.1.0