如何生成SOAP Web服务映射文档？寻求Maven依赖实现方案

一、基于Maven的自动服务解析工具 #

1. Apache CXF Maven插件 #

如果你的项目用了CXF框架，这个插件是首选——它能直接从带@WebService注解的服务类生成WSDL，还能输出包含服务结构的基础文档，支持批量处理多个服务类。

配置示例：

<plugin>
    <groupId>org.apache.cxf</groupId>
    <artifactId>cxf-java2ws-plugin</artifactId>
    <version>3.6.2</version>
    <executions>
        <execution>
            <phase>process-classes</phase>
            <goals>
                <goal>java2ws</goal>
            </goals>
            <configuration>
                <!-- 可配置多个服务类，用逗号分隔 -->
                <className>com.yourpackage.ServiceA,com.yourpackage.ServiceB</className>
                <genWsdl>true</genWsdl>
                <outputDir>${project.build.directory}/wsdl-docs</outputDir>
                <verbose>true</verbose>
            </configuration>
        </execution>
    </executions>
</plugin>

如果是Spring Boot整合CXF的项目，搭配cxf-spring-boot-starter-jaxws，插件能自动扫描Spring容器里的所有SOAP服务Bean，无需手动指定类名。

2. JAX-WS Maven插件（原生规范支持） #

对于用原生JAX-WS开发的项目，用GlassFish维护的jaxws-maven-plugin即可，它能解析服务类生成WSDL和服务元数据，也支持从WSDL反向生成调用示例代码。

配置示例：

<plugin>
    <groupId>com.sun.xml.ws</groupId>
    <artifactId>jaxws-maven-plugin</artifactId>
    <version>2.3.5</version>
    <executions>
        <execution>
            <goals>
                <goal>wsgen</goal>
            </goals>
            <configuration>
                <sei>com.yourpackage.YourSoapService</sei>
                <genWsdl>true</genWsdl>
                <destDir>${project.build.directory}/generated-docs</destDir>
            </configuration>
        </execution>
    </executions>
</plugin>

二、服务映射与文档增强 #

1. 用Swagger扩展生成可交互文档 #

虽然Swagger主打REST，但swagger-jaxws扩展能支持SOAP服务：给服务类和方法加上@Api、@ApiOperation等注解，然后用Maven插件生成元数据JSON，再通过Swagger UI展示——不仅能自动生成参数、响应说明，还能直接在页面上测试调用，生成调用示例代码。

2. 自定义批量扫描工具 #

如果要跨多个项目统一处理，可以写个简单的Java工具类，配合Maven的exec-maven-plugin批量执行：

• 核心逻辑：扫描项目编译后的class文件，识别带@WebService、@WebMethod的类和方法，提取服务名称、端点地址（从配置文件或注解读取）、参数类型、返回类型。
• 输出：直接生成Markdown或HTML格式的服务映射清单，甚至可以自动拼接基于JAX-WS客户端的调用示例代码。

三、运行时动态发现服务 #

如果需要在应用运行时获取服务列表：

• Spring Boot + CXF：注入Bus实例，通过Bus.getExtension(EndpointRegistry.class)拿到所有注册的SOAP端点，提取地址、服务类等信息。
• 原生JAX-WS：多数框架默认会提供/services端点，访问这个页面就能看到所有服务的WSDL链接，然后批量解析这些WSDL生成文档。

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