继续翻译： 本指南将指导您使用Spring使用基于SOAP的Web服务。您将构建一个客户端，该客户端使用SOAP从基于 WSDL 的 Webservice 服务获取国家数据。您将能够根据某个国家的名称查询该国家的数据。
SOAP( 简单对象访问协议)是交换数据的一种协议规范，是一种轻量的、简单的、基于 XML （ 标准通用标记语言 下的一个子集）的协议，它被设计成在WEB上交换结构化的和固化的信息,采用了两个协议:HTTP 和 XML （ 标准通用标记语言 下的一个子集）。HTTP用于实现 SOAP 的RPC 风格的传输, 而XML 是它的编码模式。
我利用业余时间，翻译了Spring官网的例子，方便中文不好的同学，将陆续发到头条上，欢迎大家关注，也可以上我个人BLOG：itmanclub.com，上面有已经翻译过的。
程序结构
└── src
└── main
└── java
└── hello
pom .xml文件
<?xml version="1.0" encoding="UTF-8"?> <project xmlns="http:// Maven .apache.org/POM/4.0.0" xmlns:xsi="" xsi: schema Location=" "> <modelVersion>4.0.0</modelVersion> <groupId>org.springframework</groupId> <artifactId>gs-consuming-web-service</artifactId> <version>0.1.0</version> <parent> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-parent</artifactId> <version>2.1.6.RELEASE</version> </parent> <properties> <java.version>1.8</java.version> </properties> <dependencies> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter</artifactId> </dependency> <dependency> <groupId>org.springframework.ws</groupId> <artifactId>spring-ws-core</artifactId> </dependency> </dependencies> <build> < plugin s> <plugin> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-maven-plugin</artifactId> </plugin> <!-- tag::wsdl[] --> <plugin> <groupId>org.jvnet.jaxb2.maven2</groupId> <artifactId>maven-jaxb2-plugin</artifactId> <version>0.12.3</version> <executions> <execution> <goals> <goal>generate</goal> </goals> </execution> </executions> < configuration > <schemaLanguage>WSDL</schemaLanguage> <generatePackage>hello.wsdl</generatePackage> <schemas> <schema> <url> </schema> </schemas> </configuration> </plugin> <!-- end::wsdl[] --> </plugins> </build> </project>
Spring Boot将会你做如下的事:
- 将 classpath 里面所有用到的jar包构建成一个可执行的 JAR 文件，方便执行你的程序
- 搜索public static void main()方法并且将它当作可执行类
- 根据springboot版本，去查找相应的依赖类版本，当然你可以定义其它版本。
在本地运行目标Web服务
按照指南中的步骤操作，或者只拷贝存储库并从其完整目录运行服务（例如，使用mvn spring-boot:run）。您可以通过在浏览器中访问来验证是否有效。
生成基于WSDL的域对象
SOAP Web服务的描述写在WSDL中。JAXB提供了一种从WSDL（或更确切地说，在WSDL的<Types/>节中包含的XSD）生成Java类的简单方法。本次国家查询服务的WSDL可以在上找到。
要从Maven中的WSDL生成Java类，需要在pon.xml中增加如下设置：
<plugin> <groupId>org.jvnet.jaxb2.maven2</groupId> <artifactId>maven-jaxb2-plugin</artifactId> <version>0.13.1</version> <executions> <execution> <goals> <goal>generate</goal> </goals> </execution> </executions> <configuration> <schemaLanguage>WSDL</schemaLanguage> <generatePackage>hello.wsdl</generatePackage> <schemas> <schema> <url> </schema> </schemas> </configuration> </plugin>
此安装程序将为在指定的URL上找到的WSDL生成类，并将这些类放入hello.wsdl包中。
要对 Gradle 执行相同的操作，您的构建文件中将需要以下内容：
task genJaxb {
ext.sourcesDir = "${buildDir}/generated-sources/jaxb"
ext.classesDir = "${buildDir}/classes/jaxb"
ext.schema = ""
outputs.dir classesDir
doLast() {
project.ant {
taskdef name: "xjc", classname: "com.sun.tools.xjc.XJCTask",
classpath: configurations.jaxb.asPath
mkdir(dir: sourcesDir)
mkdir(dir: classesDir)
xjc(destdir: sourcesDir, schema: schema,
package: "hello.wsdl") {
arg(value: "-wsdl")
produces(dir: sourcesDir, includes: "**/*.java")
}
javac(destdir: classesDir, source: 1.8, target: 1.8, debug: true,
debugLevel: "lines,vars,source",
classpath: configurations.jaxb.asPath) {
src(path: sourcesDir)
include(name: "**/*.java")
include(name: "*.java")
}
copy(todir: classesDir) {
fileset(dir: sourcesDir, erroronmissingdir: false) {
exclude(name: "**/*.java")
}
}
}
}
}
因为Gradle还没有JAXB插件，所以它涉及到一个Ant任务，这使得它比Maven要复杂一些。
在这两种情况下，JAXB域对象生成过程都已连接到构建工具的生命周期中，因此没有额外的步骤可以运行。
创建一个国家查询服务客户端
要创建Web服务客户端，只需扩展WebServiceGatewaySupport类并对操作进行编码：
src/main/java/hello/CountryClient.java
package hello;
import org. slf4j .Logger;
import org.slf4j.LoggerFactory;
import org.springframework.ws.client.core.support.WebServiceGatewaySupport;
import org.springframework.ws.soap.client.core.SoapActionCallback;
import hello.wsdl.GetCountryRequest;
import hello.wsdl.GetCountryResponse;
public class CountryClient extends WebServiceGatewaySupport {
private static final Logger log = LoggerFactory.getLogger(CountryClient.class);
public GetCountryResponse getCountry(String country) {
GetCountryRequest request = new GetCountryRequest();
request.setName(country);
log.info("Requesting location for " + country);
GetCountryResponse response = (GetCountryResponse) getWebServiceTemplate()
.marshalSendAndReceive("", request,
new SoapActionCallback(
""));
return response;
}
}
客户端包含一个方法：getCountry，它执行实际的SOAP交换。
在这个方法中，GetCountryRequest和GetCountryResponse类都是从WSDL派生的，并且是在前面步骤中描述的JAXB生成过程中生成的。它创建GetCountryRequest请求对象，并使用country参数（国家名称）对其进行设置。打印出国家/地区名称后，它使用WebServiceGatewaySupport基类提供的WebServiceTemplate进行实际的SOAP交换。它传递GetCountryRequest请求对象，以及SoapActionCallback来传递带有请求的SOAPAction头，正如WSDL在<soap:operation/>元素中描述的那样。它将响应强制转换为GetCountryResponse 对象，然后返回该对象。
配置Web服务组件
SpringWS使用Spring框架的OXM模块，该模块具有Jaxb2Marshaller来 序列化 和反序列化XML请求。
src/main/java/hello/CountryConfiguration.java
package hello; import org.springframework.context. annotation . Bean ; import org.springframework.context.annotation.Configuration; import org.springframework.oxm.jaxb.Jaxb2Marshaller; @Configuration public class CountryConfiguration { @Bean public Jaxb2Marshaller marshaller() { Jaxb2Marshaller marshaller = new Jaxb2Marshaller(); // this package must match the package in the <generatePackage> specified in // pom.xml marshaller.setContextPath("hello.wsdl"); return marshaller; } @Bean public CountryClient countryClient(Jaxb2Marshaller marshaller) { CountryClient client = new CountryClient(); client.setDefaultUri(""); client.setMarshaller(marshaller); client.setUnmarshaller(marshaller); return client; } }
marshaller指向生成的域对象集合，并将使用它们在XML和POJO之间进行序列化和反序列化。
countryClient是用上面显示的国家服务的URI创建和配置的。它还配置为使用JAXB的marshaller。
创建应用程序 Application
src/main/java/hello/Application.java
package hello;
import org.springframework.boot.CommandLineRunner;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.context.annotation.Bean;
import hello.wsdl.GetCountryResponse;
@SpringBootApplication
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
@Bean
CommandLineRunner lookup(CountryClient quoteClient) {
return args -> {
String country = "Spain";
if (args.length > 0) {
country = args[0];
}
GetCountryResponse response = quoteClient.getCountry(country);
System.err.println(response.getCountry().getCurrency());
};
}
}
main()方法遵从SpringApplication帮助程序类，为其runrun() 方法提供CountryConfiguration.class作为参数。这告诉Spring从CountryConfiguration中读取注释元数据，并将其作为Spring应用程序上下文中的组件进行管理。
此应用程序硬编码以查找对应于Microsoft Corporation的号“MSFT”。在本指南的最后，您将看到如何在不编辑代码的情况下插入其他符号。
执行并测试程序
可以直接使用前面的Appcation，运行程序，日志输出是打开的，服务应该在几秒钟内启动并运行。
请求西班牙的国家数据
<getCountryRequest><name>Spain</name>...</getCountryRequest>
您可以通过键入java -jar build/libs/gs-consuming-web-service-0.1.0.jar Poland来插入Poland国家。
请求波兰的数据：
<getCountryRequest><name>Poland</name>...</getCountryRequest>
