文章摘要
文章介绍在SpringBoot项目中使用ApacheCXF实现WebService动态和静态调用的方法。动态调用不依赖生成的Java类,灵活性高但不支持复杂对象,适合调试;静态调用通过WSDL文件生成Java类,类型安全、易维护,适合生产。文章还给出两种调用方式的详细步骤、示例代码及常见问题解决方案,并对比了二者优劣。
前言
在企业级系统开发中,Web Service 是一种常见的跨平台通信方式。尤其是在与旧系统对接时,我们经常需要通过 SOAP 协议调用远程 WebService 接口。
本文将详细介绍如何在 Spring Boot 项目中使用 Apache CXF 实现 WebService 的 动态调用 和 静态调用,并附上完整的示例代码和操作步骤。
✅ 支持返回 String[]、byte[] 等复杂类型 ✅ 提供 WSDL 文件处理流程 ✅ 包含常见问题解决方案
0、前提准备,添加依赖(Spring Boot + CXF)
这个maven依赖是动态调用方法和静态调用方法都需要使用的。添加后更新maven。
<dependency>
<groupId>org.apache.cxf</groupId>
<artifactId>cxf-spring-boot-starter-jaxws</artifactId>
<version>3.4.10</version>
</dependency>
💡 使用 cxf-spring-boot-starter-jaxws 可以自动配置 CXF,无需额外 XML 配置。
一、 方法一:动态调用 WebService(推荐用于调试)
动态调用不依赖生成的 Java 类,直接通过 URL 和方法名调用,灵活性高,适合快速测试。
1. 添加依赖(Spring Boot + CXF)
<dependency>
<groupId>org.apache.cxf</groupId>
<artifactId>cxf-spring-boot-starter-jaxws</artifactId>
<version>3.4.10</version>
</dependency>
💡 使用 cxf-spring-boot-starter-jaxws 可以自动配置 CXF,无需额外 XML 配置。
2、调用示例代码
import org.apache.cxf.endpoint.Client;
import org.apache.cxf.jaxws.endpoint.dynamic.JaxWsDynamicClientFactory;
public class WebServiceDynamicClient {
public String[] callFuc1(String flag, String mac, String psw) {
try {
// 创建动态客户端
JaxWsDynamicClientFactory dcf = JaxWsDynamicClientFactory.newInstance();
Client client = dcf.createClient("http://127.0.0.1/Service.asmx?wsdl");
// 调用方法,返回 Object[]
Object[] objects = client.invoke("fuc1", flag, mac, psw);
// 如果返回的是数组,转换为 String[]
if (objects != null && objects.length > 0) {
return (String[]) objects[0]; // 注意:返回值可能在 objects[0]
}
} catch (Exception e) {
e.printStackTrace();
}
return null;
}
这里我调用的时候,在创建客户端对象的时候报错了,仅供参考。
3、注意事项
client.invoke() 返回的是 Object[],第一个元素是实际返回值。- 动态调用不支持复杂的对象类型(如自定义类),仅适用于基本类型或数组。
- 不推荐用于生产环境,但非常适合快速验证接口是否可用。
二、方法二:静态调用 WebService(推荐用于生产)
静态调用通过 WSDL 文件生成 Java 类,然后像调用本地方法一样调用远程服务,类型安全、易维护。
1. 添加依赖(Spring Boot + CXF)
<dependency>
<groupId>org.apache.cxf</groupId>
<artifactId>cxf-spring-boot-starter-jaxws</artifactId>
<version>3.4.10</version>
</dependency>
💡 使用 cxf-spring-boot-starter-jaxws 可以自动配置 CXF,无需额外 XML 配置。
2、获取 WSDL 文件
在浏览器中访问可以看到如下内容,说明URL有效。

页面显示 WSDL 内容 → 右键另存为 → 保存为 service.wsdl
👉 注意:必须以 .wsdl 结尾
3、使用 wsimport 生成 Java 类
1. 检查 wsimport 是否存在
打开命令行,输入:
wsimport -version
如果提示找不到命令,请安装 JDK 并确保 JAVA_HOME 配置正确。
2. 进入存放 service.wsdl 的目录,执行:
wsimport -keep -d . -p com.example.wsclient service.wsdl
注意这里如果提示wsdl文件中有错误,那么就打开这个文件修改不对的地方,重新生成即可。
例如我有个报错:

我是将284行这个地方,报错的节点修改了一下,重新保存生成就可以了。
报错的节点:
<s:element name="GetDataResponse">
<s:complexType>
<s:sequence>
<s:element minOccurs="0" maxOccurs="1" name="GetDataResult">
<s:complexType>
<s:sequence>
<s:element ref="s:schema"/>
<s:any/>
</s:sequence>
</s:complexType>
</s:element>
</s:sequence>
</s:complexType>
当时是这句报错了:
<s:element ref="s:schema"/>
<s:any/>
修改后的节点:
<s:element name="GetDataResponse">
<s:complexType>
<s:sequence>
<s:element minOccurs="0" maxOccurs="1" name="GetDataResponse">
<s:complexType>
<s:sequence>
<!-- 替换非法引用为任意 XML -->
<s:any minOccurs="0" maxOccurs="unbounded" processContents="lax" />
</s:sequence>
</s:complexType>
</s:element>
</s:sequence>
</s:complexType>
</s:element>
参数说明:
✅ 成功后会生成多个 Java 类,包括:
Service.java(服务类)ServiceSoap.java(端口接口)ArrayOfString.java(数组包装类)

4、将生成的类导入项目
- 将所有生成的
.java 文件复制到你的项目中指定包下,例如:
src/main/java/com/example/webservice/
这里注意,只需要.java类型的文件,.class类型的文件可以删除

- 手动修改所有类的第一行包名,确保一致(可使用
Ctrl+Shift+R 全局替换)。

三、动态调用和静态调用哪个更好?
总结