轻松掌握WSDL与Java客户端开发技巧

引言

Web服务描述语言（WSDL）是用于描述Web服务的接口和操作的XML格式语言。Java客户端开发则是指使用Java语言来调用这些Web服务。掌握WSDL与Java客户端开发的技巧对于进行现代软件开发至关重要。本文将详细介绍WSDL的结构和Java客户端开发的步骤，并提供一些实用的技巧。

WSDL基础

1. WSDL概述

WSDL定义了Web服务的接口，包括服务提供的操作、输入和输出参数以及数据类型。它通常由以下几部分组成：

服务（Service）：定义了服务的名称和地址。
端口（Port）：定义了服务提供的接口。
操作（Operation）：定义了服务的具体操作及其输入和输出参数。
消息（Message）：定义了操作的输入和输出参数的数据结构。
类型（Types）：定义了消息中的数据类型。

2. WSDL结构

以下是一个简单的WSDL示例：

<wsdl:definitions xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:tns="http://example.com" targetNamespace="http://example.com"> <wsdl:types> <xs:schema targetNamespace="http://example.com"> <xs:element name="Greeting" type="xs:string"/> </xs:schema> </wsdl:types> <wsdl:message name="GreetingRequest"> <wsdl:part name="parameters" element="tns:Greeting"/> </wsdl:message> <wsdl:message name="GreetingResponse"> <wsdl:part name="parameters" element="tns:Greeting"/> </wsdl:message> <wsdl:portType name="GreetingPortType"> <wsdl:operation name="Greet"> <wsdl:input message="tns:GreetingRequest"/> <wsdl:output message="tns:GreetingResponse"/> </wsdl:operation> </wsdl:portType> <wsdl:binding name="GreetingBinding" type="tns:GreetingPortType"> <soap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http"/> <wsdl:operation name="Greet"> <soap:operation soapAction="Greet"/> <wsdl:input> <soap:body use="literal"/> </wsdl:input> <wsdl:output> <soap:body use="literal"/> </wsdl:output> </wsdl:operation> </wsdl:binding> <wsdl:service name="GreetingService"> <wsdl:port name="GreetingPort" binding="tns:GreetingBinding"> <soap:address location="http://example.com/GreetingService"/> </wsdl:port> </wsdl:service> </wsdl:definitions>

Java客户端开发

1. 使用JAX-WS

JAX-WS是Java平台的一部分，用于处理Web服务的开发。以下是如何使用JAX-WS创建一个简单的Java客户端：

1.1 添加依赖

在项目的pom.xml文件中添加以下依赖：

<dependency> <groupId>javax.xml.ws</groupId> <artifactId>jaxws-api</artifactId> <version>2.3.3</version> </dependency> <dependency> <groupId>org.glassfish.jaxb</groupId> <artifactId>jaxb-runtime</artifactId> <version>2.3.1</version> </dependency>

1.2 创建客户端代码

以下是一个简单的Java客户端示例：

import javax.xml.namespace.QName; import javax.xml.ws.Service; import java.net.MalformedURLException; import java.net.URL; public class GreetingClient { public static void main(String[] args) throws MalformedURLException { URL wsdlLocation = new URL("http://example.com/GreetingService?wsdl"); QName serviceName = new QName("http://example.com", "GreetingService"); QName portName = new QName("http://example.com", "GreetingPort"); Service service = Service.create(wsdlLocation, serviceName); GreetingPortType port = service.getPort(portName, GreetingPortType.class); String greeting = port.greet("World"); System.out.println("Greeting: " + greeting); } }

2. 使用Apache CXF

Apache CXF是另一个流行的Java Web服务框架。以下是如何使用Apache CXF创建一个简单的Java客户端：

2.1 添加依赖

在项目的pom.xml文件中添加以下依赖：

<dependency> <groupId>org.apache.cxf</groupId> <artifactId>cxf-rt-frontend-jaxws</artifactId> <version>3.4.0</version> </dependency> <dependency> <groupId>org.apache.cxf</groupId> <artifactId>cxf-rt-transports-http</artifactId> <version>3.4.0</version> </dependency>

2.2 创建客户端代码

以下是一个简单的Apache CXF客户端示例：

import org.apache.cxf.jaxws.JaxWsProxyFactoryBean; public class GreetingClient { public static void main(String[] args) { JaxWsProxyFactoryBean factory = new JaxWsProxyFactoryBean(); factory.setServiceClass(GreetingPortType.class); factory.setAddress("http://example.com/GreetingService"); GreetingPortType port = (GreetingPortType) factory.create(); String greeting = port.greet("World"); System.out.println("Greeting: " + greeting); } }