27.2. 生成开始点代码
概述
JAX-WS 指定从 WSDL 中定义的服务到将实施该服务作为服务提供商的 Java 类的详细映射。由 wsdl:portType 元素定义的逻辑接口映射到服务端点接口(SEI)。WSDL 中定义的任何复杂类型都映射到 Java 类，遵循 Java 架构为 XML 绑定(JAXB)规范定义的映射。wsdl:service 元素定义的端点也会生成在 Java 类中，供使用者用于访问实施该服务的服务提供商。
cxf-codegen-plugin Maven 插件会生成此代码。它还为您提供了为实施生成起点代码的选项。代码生成器提供了多个控制生成的代码的选项。
运行代码生成器
例 27.1 “Service Code Generation” 演示了如何使用代码生成器为服务生成起点代码。
例 27.1. Service Code Generation
<plugin>
<groupId>org.apache.cxf</groupId>
<artifactId>cxf-codegen-plugin</artifactId>
<version>${cxf.version}</version>
<executions>
<execution>
<id>generate-sources</id>
<phase>generate-sources</phase>
<configuration>
<sourceRoot>outputDir</sourceRoot>
<wsdlOptions>
<wsdlOption>
<wsdl>wsdl</wsdl>
<extraargs>
<extraarg>-server</extraarg>
<extraarg>-impl</extraarg>
</extraargs>
</wsdlOption>
</wsdlOptions>
</configuration>
<goals>
<goal>wsdl2java</goal>
</goals>
</execution>
</executions>
</plugin>这执行以下操作：
-
-impl选项为 WSDL 合同中的每个wsdl:portType元素生成一个 shell 实施类。 -
-server选项生成一个简单的main （），将您的服务提供商作为独立应用程序运行。 -
sourceRoot指定生成的代码被写入一个名为 outputDir 的目录。 -
WSDL元素指定生成代码的 WSDL 合同。
有关代码生成器选项的完整列表，请参阅 第 44.2 节 “cxf-codegen-plugin”。
生成的代码
表 27.1 “为服务提供商生成的类” 描述为创建服务提供商生成的文件。
| File | 描述 |
|---|---|
| SEI。此文件包含您的服务提供商实施的接口。您不应该编辑此文件。 | |
|
| 端点。此文件包含 Java 类使用者，用于对服务发出请求。 |
| 框架实施类。修改此文件以构建您的服务提供商。 | |
|
| 一个基本的服务器主线，允许您将服务提供商部署为独立进程。如需更多信息，请参阅 第 31 章 发布服务。 |
此外，代码生成器将为 WSDL 合同中定义的所有类型生成 Java 类。
生成的软件包
生成的代码根据 WSDL 合同中使用的命名空间放入软件包中。为支持服务生成的类（基于 wsdl:portType 元素、wsdl:service 元素和 wsdl:port 元素）将放置到基于 WSDL 合同目标命名空间中的软件包中。为实施合同的 type 元素中定义的类，根据 type 元素的 targetNamespace 属性将放置在 软件包中。
映射算法如下：
-
前面的
http://或urn://被剥离命名空间。 -
如果命名空间中的第一个字符串是有效的互联网域，例如以
.com或.gov结束，则前导www.将去除该字符串，其余两个组件将被解译。 -
如果命名空间中的最终字符串以模式
.xxx或.xx的文件扩展名结尾，则扩展会被剥离。 - 命名空间中的其余字符串附加到生成的字符串中，并以点分开。
- 所有字母都是小写。
