使用Apache CXF生成Web服务客户端是Java开发中常见的任务，它简化了与SOAP服务的交互流程，CXF是一个开源的Services框架，支持多种协议和数据绑定技术，能够帮助开发者快速构建和部署SOAP和RESTful服务，下面将详细介绍使用CXF生成客户端的完整步骤、命令参数说明及实际应用场景。
生成客户端的基本命令
CXF提供了wsdl2java工具，用于根据WSDL（Web Services Description Language）文件生成Java客户端代码，该工具位于CXF的bin目录下，使用时需要确保环境变量中配置了Java Development Kit（JDK）和CXF的路径，基本命令格式如下：
wsdl2java -p <包名> -d <输出目录> -client <WSDL文件路径>
-p参数指定生成的Java类的包名，-d参数指定代码输出的目录，-client参数表示生成客户端测试类，假设WSDL文件位于http://example.com/service?wsdl，生成命令为：
wsdl2java -p com.example.client -d ./src/main/java -client http://example.com/service?wsdl
常用参数详解
为了满足不同的开发需求,wsdl2java提供了丰富的参数选项，以下是常用参数的说明及示例：
| 参数 | 说明 | 示例 |
|---|---|---|
-p |
指定生成类的包名 | -p com.example.service |
-d |
指定代码输出目录 | -d ./src/main/java |
-client |
生成客户端测试类 | -client |
-server |
生成服务端实现类 | -server |
-impl |
生成服务端实现类（不包含接口） | -impl |
-all |
生成所有客户端和服务端代码 | -all |
-frontend |
指定前端类型（如jaxws、jaxrs） |
-frontend jaxws |
-validate |
验证WSDL文件的有效性 | -validate |
-autoNameResolution |
自动解决命名冲突 | -autoNameResolution |
-exsh |
生成外部绑定文件 | -exsh ./bindings.xml |
如果需要生成包含所有代码、使用JAX-WS前端并自动解决命名冲突的客户端，可以执行以下命令：
wsdl2java -p com.example.client -d ./src/main/java -all -frontend jaxws -autoNameResolution http://example.com/service?wsdl
实际应用步骤
- 准备环境：确保已安装JDK（版本1.8及以上）并配置环境变量，下载CXF压缩包并解压，将
bin目录添加到系统PATH变量中。 - 获取WSDL文件：从服务提供方获取WSDL文件的URL或本地路径，如果WSDL文件依赖其他模式文件（XSD），需确保它们可被正确访问。
- 执行生成命令：根据需求选择合适的参数运行
wsdl2java命令，生成仅包含客户端代码的Java类：wsdl2java -p com.example.client -d ./src/main/java -client http://example.com/service?wsdl
- 检查生成代码：查看输出目录，确认生成了接口类（如
ServiceName）、客户端类（如ServiceName_Service）和测试类（如ServiceName_Client）。 - 调用服务：在Java代码中通过生成的客户端类调用服务方法。
com.example.client.ServiceName_Service service = new ServiceName_Service(); com.example.client.ServiceName port = service.getServiceNamePort(); String result = port.someMethod("input"); System.out.println(result);
高级配置
如果WSDL文件包含复杂类型或需要自定义绑定,可以通过-b参数指定绑定文件（如bindings.xml）。
wsdl2java -b ./bindings.xml -p com.example.client -d ./src/main/java http://example.com/service?wsdl
绑定文件可以修改命名空间、类名映射等，以满足特定需求，CXF还支持通过-xjc参数传递XJC插件选项，用于进一步定制生成的代码。
常见问题及解决方案
- 生成代码报错：检查WSDL文件是否有效，确保网络连接正常或本地文件路径正确，使用
-validate参数验证WSDL语法。 - 依赖冲突：如果生成代码后编译失败，可能是CXF依赖的库与项目现有依赖冲突，建议在
pom.xml中添加CXF依赖：<dependency> <groupId>org.apache.cxf</groupId> <artifactId>cxf-rt-frontend-jaxws</artifactId> <version>3.4.0</version> </dependency>
相关问答FAQs
Q1: 如何处理WSDL文件中的多个端口（Port）？
A1: wsdl2java默认会生成所有端口的客户端代码，如果需要指定特定端口，可以通过-port参数指定端口的名称，例如-port ServiceNamePort，生成的ServiceName_Service类中提供了获取不同端口的方法，可以通过代码动态选择。
Q2: 生成的客户端代码如何添加自定义拦截器？
A2: 可以在调用服务前通过BindingProvider添加拦截器。
ServiceName_Service service = new ServiceName_Service();
ServiceName port = service.getServiceNamePort();
BindingProvider bindingProvider = (BindingProvider) port;
bindingProvider.getBinding().getHandlerChain().add(new LoggingInterceptor());
String result = port.someMethod("input");
LoggingInterceptor需实现javax.xml.ws.handler.soap.SOAPHandler接口，用于处理SOAP消息的日志记录。
