将jaxws-maven-plugin与-clientjar选项一起使用

Question

我正在使用jaxws-maven-plugin为Web服务使用者应用程序执行wsimport。我正在使用-clientjar2010年随JAX-WS 2.2.2
RI引入的wsimport上的选项。之所以这样做，是因为我想将WSDL捆绑在jar中。

我在制作pom时没有问题。对于插件配置，我可以执行以下操作：

<configuration>
    ...
    <args>
        <arg>-clientjar</arg>
        <arg>bundled-wsdl.jar</arg>
    </args>
</configuration>

当我执行构建时，我创建的jar称为myapp.jar，其中包含文件bundled-wsdl.jar。在bundled- wsdl.jar的META-
INF目录中，可以找到wsdl和xsd，就像我喜欢的一样。我对使用该-clientjar选项产生的Java代码也很满意。到目前为止，一切都很好。

但这东西应该放在myapp.jar的META-INF中，对吗？它位于bundled-wsdl.jarMETA-INF中的事实并没有太大帮助。

有趣的是，实际上我确实在myapp.jarMETA-
INF中获得了一个wsdl文件，这使得该应用程序实际上可以工作。我不知道怎么到达那里。此外，xsd文件不存在，仅在bundled- wsdl.jar的META-INF中。

基本问题是如何-clientjar在Maven项目中正确使用wsimport 选项？

Java 1.7.0_45。

Answer 1

-clientjar恕我直言，该选项的记录确实很少。我认为这是有效的：

使用该-clientjar <jarfile>选项时，发生了 三 件事：

1. 您将<jarfile>在-d该wsimport工具的参数所指向的目录中生成一个。其中将包含WSDL和任何相关的XSD文件。这个小捆绑包根本不会用于任何东西。如果您想使用它，完全取决于您。但是在您看到下面的（2）之前。我不知道除了将其作为文档形式外，还可以将该jarfile用作什么。
2. 您将获得WSDL的副本，该副本放入名为的文件中 META-INF/wsdl/<svcname>.wsdl。生成的类将在no-arg代理构造函数中使用此文件。因此，如果您使用该-clientjar 选项请求捆绑的WSDL文件，则实际上将使用此文件。
3. 生成的代码将发生更改，从而wsdlLocation，如果您在类上使用默认的no-arg构造函数@WebServiceClient，则将是捆绑的WSDL（来自（2））的，而不是远程WSDL的。的确，如果您-wsdllocation在命令行上与一起使用，-clientjar则您指定的任何内容都-wsdllocation将无效，因为-clientjar它将具有优先权。

因此，我们必须关注（2）和（3），因为这是实际使用的唯一代码…至少如果您原样使用生成的代码。

有趣的是，（2）的结果 只是
一个WSDL文件。该文件可能具有指向XSD文件的嵌入式链接，但据我所知，永远不会遵循该链接。原因是，当我们说Web服务使用者在运行时需要WSDL时，实际上只需要WSDL本身，而不是模式。该模式已“硬编码”到使用者中，无法在运行时进行更改。因此，没有理由在运行时读取架构信息。（这是我的理解）

关于（2）包含的WSDL的第二点注意事项：它实际上只是原始WSDL的副本，因此它可能没有所需的端点。实际上，在大多数情况下不会。这意味着在这种情况下，您需要自己设置端点：

// Use no-arg constructor. Means it uses the WSDL bundled into the 
// META-INF/wsdl directory rather than trying to retrieve WSDL over the
// network.
service = new HelloSvc_Service();
hello = service.getHelloSvcPort();

// Since we're using a bundled WSDL the web service URL cannot 
// be derived from that (it would be wrong!). So we have to set
// it explicitly.
((BindingProvider) hello).getRequestContext().put(
                BindingProvider.ENDPOINT_ADDRESS_PROPERTY,
                "http://myhellowebservice-address");