Springboot使用CXF進行WSDL轉(zhuǎn)換及WebService服務調(diào)用過程

更新時間：2025年09月24日 10:00:49 作者：筱詩詩

本文介紹如何利用Apache CXF將WSDL轉(zhuǎn)換為Java代碼,提供bat命令和Maven插件兩種方法,并詳解生成類的屬性（如name、targetNamespace）及調(diào)用接口的參數(shù)傳遞方式,助力高效集成Web服務

1.添加依賴

<dependency>
    <groupId>org.apache.cxf</groupId>
    <artifactId>cxf-spring-boot-starter-jaxws</artifactId>
    <version>3.5.8</version>
</dependency>
<dependency>
    <groupId>org.apache.cxf</groupId>
    <artifactId>cxf-rt-transports-http</artifactId>
    <version>3.5.8</version>
</dependency>

2.wsdl轉(zhuǎn)java代碼，這有兩種方式

第一種，使用bat命令轉(zhuǎn)換

wsimport -keep http://10.1.1.1:8080/webservice/111/service/webservice?wsdl

第二種，使用maven插件實現(xiàn)（版本盡量和cxf依賴版本一致）

<plugin>
    <groupId>org.apache.cxf</groupId>
    <artifactId>cxf-codegen-plugin</artifactId>
    <version>3.5.8</version>
    <executions>
        <execution>
            <id>generate-sources</id>
            <phase>generate-sources</phase>
            <configuration>
                <sourceRoot>src/main/resources/cxf</sourceRoot>
                <wsdlOptions>
                    <wsdlOption>
                        <wsdl>http://10.1.1.1:8080/webservice/111/service/webservice?wsdl</wsdl>
                    </wsdlOption>
                </wsdlOptions>
            </configuration>
            <goals>
                <goal>wsdl2java</goal>
            </goals>
        </execution>
    </executions>
</plugin>

wsdl為這種格式，類似接口文檔

轉(zhuǎn)換為下圖這種（其中get set都是方法）

3.這是轉(zhuǎn)換后的webService類

其中name是Web Service的本地名稱，targetNamespace指定了Web Service的目標命名空間，wsdlLocation指定了WSDL文檔的位置，serviceName是WSDL中定義的服務的名稱，portName指定了WSDL中定義的端口的名稱。

@WebServiceClient(name = "webservice", targetNamespace = "http://service.xxx", wsdlLocation = "http://10.1.1.1:8080/webservice/111/service/webservice?wsdl")
public class Webservice
    extends Service
{

    private final static URL WEBSERVICE_WSDL_LOCATION;
    private final static WebServiceException WEBSERVICE_EXCEPTION;
    private final static QName WEBSERVICE_QNAME = new QName("http://service.xxx", "webservice");

    static {
        URL url = null;
        WebServiceException e = null;
        try {
            url = new URL("http://10.1.1.1:8080/webservice/111/service/webservice?wsdl");
        } catch (MalformedURLException ex) {
            e = new WebServiceException(ex);
        }
        WEBSERVICE_WSDL_LOCATION = url;
        WEBSERVICE_EXCEPTION = e;
    }

    public Webservice() {
        super(__getWsdlLocation(), WEBSERVICE_QNAME);
    }

4.我們需要使用webService去調(diào)用getWebserviceHttpPort這個方法

找到要調(diào)用的方法名，把參數(shù)傳進去（name,password,data）,data是要傳輸?shù)臄?shù)據(jù)

Webservice webservice = new Webservice();
WebservicePortType port = webservice.getWebserviceHttpPort();
String result = port.setHtInfo(checCmdUsername, checCmdPassword, data);
System.out.println("result: " + result);
if(result.contains("成功")){
    log.info("---------------同步成功！---------------");
    return true;
}else {
    log.info("---------------同步失??！---------------");
    return false;
}

通過上述步驟，我們可以輕松地將 WSDL 文件轉(zhuǎn)換為 Java 代碼，并使用生成的類調(diào)用 Web 服務接口。

無論是通過批處理命令還是使用 Maven 插件，CXF 都提供了靈活且強大的工具來簡化這一過程。