wsimport 生成的客户端如何工作？

Question

首先，我想让您知道我已经可以连接到 Web 服务服务器。我问这个问题是因为我想更深入地了解 wsimport 生成的客户端是如何工作的。根据我的研究，wsimport 使用 JAXWS。请注意，我不了解 JAXWS。

我使用 wsimport 生成了我的客户端。我使用的 WSDL 来自 Axis2 Web 服务，由 Axis2 自动生成。下面的类是wsimport的结果：

com.datamodel.xsd下

• DataBeanRequest.java
• DataBeanResponse.java
• ObjectFactory.java
• package-info.java

com.service下

• MyWebService.java
• MyWebServicePortType.java
• MyMethod.java
• MyMethodResponse.java
• ObjectFactory.java
• package-info.java

通过上面的类，我可以看出com.datamodel.xsd 包含Web 服务服务器使用的bean（不包括ObjectFactory 和package-info）。同时MyMethod和MyMethodResponse也是用于设置Web服务方法/操作的请求和响应参数的bean。

以下是我的问题：（如果您不知道我的某些问题的答案，您实际上不必回答所有问题。:) 请随时分享您认为我可能找到的任何信息有用。）

我说得对吗

• 我的上述假设是否正确？
• 其他类的作用是什么？
• 我检查了MyWebService，它包含一个注释，它引用了我用来生成客户端的WSDL 的绝对位置。在客户端指定wsdllocation 有什么相关性？客户如何使用这些信息？
• 我注意到 Web 服务的实际 URL 没有在任何生成的类中声明。客户端如何知道它需要连接到哪里？
• 是否对 WSDL 文件进行了注释，以便客户端可以在连接时读取 WSDL 文件上的 URL？如果是这样，是否意味着必须建立新连接时始终读取 WSDL 文件？
• 由于我需要编译我的应用程序并将其安装在不同的服务器上，因此将变得无效。我可以将其设置为相对路径而不是绝对路径吗？如何？ （答：可以，可以设置成相对路径。wsimport命令有wsdllocation属性，其中wsdllocation的值可以指定。）
• 如果我需要连接到 HTTPS，该怎么办。如何设置服务器证书？
• 使用 wsimport 生成客户端和使用 Axis2 或 Apache CXF 生成客户端时有什么不同吗？

Answer 1

在我回答问题之前，先澄清一下：JAX-WS 是用于在 Java 中实现 Web 服务的规范。它描述了如何将 WSDL 工件映射到 Java 类以及如何使用注释来应用这种映射。你可以download the specification here。工具 wsimport 是本规范参考实现的一部分，参考实现是 Java 类库的一部分。有几种替代实现，例如 Axis2、CXF 或 Metro，它们通过支持其他标准（例如 WS-ReliableMessaging 或 WS-Security）来增强基本 JAX-WS 支持。

现在回答你的问题：

我的上述假设是否正确？

是的，你是。

其他类的作用是什么？

package-info 用于将 Web 服务中使用的 XML 命名空间映射到实现类所在的包。命名空间通常看起来与 Java 包名称不同（通常是 URL），这使得映射成为必要。

ObjectFactory 允许您创建服务发送和接收的任何消息。如果你想在你的存根类前面挂上代码，提供修改过的消息或类似的东西，你需要这个。

我看不到你的类的内容，但如果我理解正确的话，MyWebServicePortType 是一个类似于你的 WSDL 中的portType 的接口。也就是说，它将 WSDL 中的操作及其签名映射到 Java 方法。如果您想提供服务（您不提供服务，您正在询问客户端），则需要实现此接口。在实现客户端时，您只需使用它。

最后，MyWebService 类包含您想要调用 Web 服务所需的客户端存根。

我检查了 MyWebService，它包含一个注解 我用来生成客户端的 WSDL 的绝对位置。什么 在客户端指定 wsdllocation 是否相关？如何 客户是否使用该信息？

您生成的接口包含服务的portType 的签名，但它没有说明如何与服务通信。这是 WSDL 中绑定的一部分。最基本的设置是使用 SOAP over HTTP 的消息的文档/文字样式。其他配置（例如 JMS 上的 SOAP）也是可能的，您的客户端需要知道要使用什么协议。因此它需要绑定 WSDL。此外，正如您稍后所述，您的 Java 文件中没有端点地址。这个地址也是从 WSDL 中读取的。

我注意到 Web 服务的实际 URL 没有在 生成的任何类。客户如何知道它需要什么 连接到？

它从 WSDL 中的service 的port 中读取address。它位于 WSDL 的末尾。

是否对 WSDL 文件进行了注释，以便客户端可以读取 连接时的 WSDL 文件？

不，port 是具体 Web 服务端点的典型元素。这里没有什么特别需要的。

如果是这样，那是否意味着当一个新的 WSDL 文件总是被读取？ 必须建立连接？

嗯，客户端可能有缓存（我不知道这个参考实现的细节）。从概念的角度来看：是的。

如果我需要连接到 HTTPS，该怎么办。如何设置服务器 证书

这可能很棘手，我不能给你一个开箱即用的答案。我建议阅读有关此主题的问题，such as this one。

当我使用 wsimport 和 当我使用 Axis2 或 Apache CXF 生成它时

是的，有。 wsimport 更好，不要使用 wsdl2java。 Here is a description, why.

Answer 2

您问：我注意到 Web 服务的实际 URL 没有在任何生成的类中声明。客户端如何知道它需要连接到哪里？

如果 WSDL 是使用浏览器下载并作为输入传递给 wsimport，则本地 wsdl 文件位置将嵌入到生成的代码中。这就是您在生成的代码中看不到实际服务位置的原因。这也意味着如果您删除了 wsdl 文件的本地副本，生成的代码将无法工作（当使用 main 方法调用时）。

如果 wsdl 的 URL 作为输入传递给 wsimport，则该 URL 嵌入在生成的代码中，该代码进一步用于获取实际的服务位置。这个想法是 WSDL 位置是固定的。它们应该位于 UDDI 中或作为本地文件。这允许实际服务移动，如果它们移动，您只需单独修改 wsdl 文件的本地副本或更新 UDDI 中的 wsdl。 [大多数情况下这不会发生，因为服务位置从来都不是 IP，而是 DNS 名称]

这就是为什么在运行 Web 服务的同一台服务器上发布 wsdl 绝不是一个好主意