Spring Boot 调用 WebService 的两种方式：动态与静态调用

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>

2. 获取 WSDL 文件

在浏览器中访问：

http://127.0.0.1/Service.asmx?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 文件中有错误，那么就打开这个文件修改不对的地方，重新生成即可。

例如我有个报错：

报错的节点：

<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>

当时是这句报错了：

<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 全局替换）。

5. 示例代码：静态调用

import com.AllProcess.process.webservice.Service; // 通讯类
import com.AllProcess.process.webservice.ServiceSoap; // 调用接口
import com.AllProcess.process.webservice.ArrayOfString;
import org.springframework.stereotype.Component;
import javax.xml.namespace.QName;
import java.net.URL;
import java.util.Arrays;

@Component
public class WebServiceStaticClient {
    private static final String WEBSERVICE_WSDL_URL = "http://127.0.0.1/Service.asmx?wsdl";
    private static final String LOCAL_WSDL_PATH = "file:/D:/文件夹/service.wsdl";

    public String[] callFuc1(String flag, String mac, String psw) {
        try {
            // 1. 创建 URL 对象（远程或本地）
            URL wsdlURL = new URL(WEBSERVICE_WSDL_URL);
            // 2. 创建服务实例
            Service service = new Service(wsdlURL, new QName("http://www.xxx/", "Service"));
            // 3. 获取端口代理
            ServiceSoap port = service.getServiceSoap();
            // 4. 调用方法
            ArrayOfString resultGetData = port.fuc1(flag, mac, psw);
            // 5. 转为 String[]
            String[] result = resultGetData.getString().toArray(new String[0]);
            System.out.println("Response: " + Arrays.toString(result));
            return result;
        } catch (Exception e) {
            e.printStackTrace();
            return null;
        }
    }
}

对比分析

总结

参考资料

• Apache CXF 官方文档
• wsimport 使用指南
• SOAP WebService 入门