编写jax-ws-web服务并在不使用XSD的情况下生成WSDL

Question

我在java上为tomcat应用服务器编写了一个简单的JAX-WS Web服务。

我有一个接口和实现类：
接口

@WebService(name = "myWs")
@SOAPBinding(style = Style.RPC)
public interface IMyWs {
    @WebMethod(operationName = "getUser")
    Response getUser(@WebParam(name = "phone", mode = Mode.IN) String phone);

}

实施

@WebService(endpointInterface = "ge.mari.IMyWs")
public class MyWs implements IMyWs {
    @Override
    public Response getUser(String phone) {
               // SOME CODE
        return response;
    }
}

我的问题是，在我的wsdl文件中，响应类是在xsd文件中定义的
这是我的wsdl文件的片段

<types>
<xsd:schema>
          <xsd:import namespace="http://ws.mari.ge/" schemaLocation="http://localhost:8080/MyServcie/MyWs?xsd=1">
</xsd:import>
</xsd:schema>
</types>

如何使web服务生成WSDL文件中的所有类型而不是单独的XSD文件
我是否应该更改任何配置或向web服务添加一些注释？

Answer 1

实际上，在运行时WSDL生成器中不可能使用inlineSchemas。我调试了WSDL生成，并在Endpoint Factory中发现了这一行，其中inlineSchemas特性（实际上存在于wsgen工具中）被设置为false：

    /**
     * Generates the WSDL and XML Schema for the endpoint if necessary
     * It generates WSDL only for SOAP1.1, and for XSOAP1.2 bindings
     */
    private static SDDocumentImpl generateWSDL(WSBinding binding, AbstractSEIModelImpl seiModel, Collection<SDDocumentImpl> docs,
                                               Container container, Class implType) {
        // [...]
        WSDLGenInfo wsdlGenInfo = new WSDLGenInfo(); 
        // [...]
        wsdlGenInfo.setInlineSchemas(false);
        // [...]
        seiModel.getDatabinding().generateWSDL(wsdlGenInfo);
        // [...]
    }

https://github.com/eclipse-ee4j/metro-jax-ws/blob/f37dae6bdfd03bafdad63ed05b27dbfc3c38af1b/jaxws-ri/rt/src/main/java/com/sun/xml/ws/server/EndpointFactory.java#L658

JAX-WS要改变这一点还有一个开放的问题（但我想JAX-WS中的改变已经没有多大希望了）。https://github.com/eclipse-ee4j/metro-jax-ws/issues/49

Answer 2

AFAIK不可能让JAX生成一个带有内联模式的WSDL。

顺便说一句：分离WSDL定义和XSD模式是一个很好的举措（您可能希望在不同的上下文中使用模式定义的对象结构，例如将数据存储到文件或类似的东西）。

这就是说：如果您需要一个“一体式”WSDL（因为一些古老的客户机需要它），您可以始终让jax-ws最初生成WSDL，然后根据您的内心内容编辑它。可以使用@WebService注释的wsdlLocation参数包含编辑的WSDL。

Answer 3

您可以让JAX-WS通过使用

-inlineSchemas

命令行开关。[1]张志强

如果您在项目中使用Maven，您可以将JAX-WS Maven插件配置为对执行配置中的inlineSchemas配置元素执行相同的操作，如下所示：[2]

<plugin>
  <groupId>org.jvnet.jax-ws-commons</groupId>
  <artifactId>jaxws-maven-plugin</artifactId>
  <version>2.2</version>
  <executions>
    <execution>
      <id>SomeId</id>
      <goals>
        <goal>wsgen</goal>
      </goals>
      <phase>prepare-package</phase>
      <configuration>
        <sei>some.class.Name</sei>
        <genWsdl>true</genWsdl>
        <keep>true</keep>
        <resourceDestDir>some/target/dir</resourceDestDir>
        <inlineSchemas>true</inlineSchemas>
      </configuration>
    </execution>
  </executions>
</plugin>

不需要对Java类进行任何更改。

[1]http://jax-ws.java.net/nonav/2.2.1/docs/wsgen.html

[2] http://jax-ws-commons.java.net/jaxws-maven-plugin/wsgen-mojo.html