使用绑定文件注释 JAX-WS SEI 类答案

【问题标题】：Annotate JAX-WS SEI class using bindings file使用绑定文件注释 JAX-WS SEI 类
【发布时间】：2014-07-10 12:10:17
【问题描述】：

我想为 Apache CXF Web 服务客户端的服务端点实现接口类添加 java 注释，从 WSDL 生成。

这是我正在使用的绑定文件，它应该利用来自 http://confluence.highsource.org/display/J2B/Annotate+Plugin 的 JAXB 注释插件：

<jaxws:bindings wsdlLocation="OptenetServices.wsdl"
     xmlns:jaxws="http://java.sun.com/xml/ns/jaxws"
     xmlns:xs="http://www.w3.org/2001/XMLSchema"
     xmlns:jaxb="http://java.sun.com/xml/ns/jaxb"
     xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"
     xmlns:annox="http://annox.dev.java.net"
     jaxws:extensionBindingPrefixes="annox">

   <jaxws:bindings node="wsdl:portType">
      <annox:annotate>
         <annox:annotate annox:class="org.jvnet.hk2.annotations.Contract" />
      </annox:annotate>
    </jaxws:bindings>
</jaxws:bindings>

没有错误，只是没有创建注释。我可以确认选择了节点并使用了绑定，因为如果我将annox:annotate 更改为：

    <jaxws:class name="Renamed">
        <jaxws:javadoc>Blah blah</jaxws:javadoc>
    </jaxws:class>

界面重命名和注释正确。

我不清楚 annox 是否可以在这种情况下使用，以及 jaxb 和 jaxws 绑定之间的关系是什么。

代码生成由 CFX 通过 Maven 处理：

<build>
  <plugins>
    <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>${project.build.directory}/generated/cxf</sourceRoot>
            <wsdlOptions>
              <wsdlOption>
                <wsdl>${basedir}/src/main/wsdl/service.wsdl</wsdl>
                <extraargs>
                  <extraarg>-client</extraarg>
                  <extraarg>-p</extraarg>
                  <extraarg>com.example.pkg</extraarg>
                  <extraarg>-b</extraarg>
                  <extraarg>${basedir}/src/main/wsdl/bindings.xml</extraarg>
                  <extraarg>-xjc-Xannotate</extraarg>
                  <extraarg>-verbose</extraarg>
                </extraargs>
              </wsdlOption>
            </wsdlOptions>
          </configuration>
          <goals>
            <goal>wsdl2java</goal>
          </goals>
        </execution>
      </executions>
      <dependencies>
        <dependency>
          <groupId>org.jvnet.jaxb2_commons</groupId>
          <artifactId>jaxb2-basics-annotate</artifactId>
          <version>0.6.5</version>
        </dependency>
        <dependency>
          <groupId>org.jvnet.jaxb2_commons</groupId>
          <artifactId>jaxb2-basics-annotate</artifactId>
          <version>0.6.5</version>
        </dependency>
      </dependencies>
    </plugin>
  </plugins>
</build>

谢谢。

【问题讨论】：

我也很想知道这一点，因为我目前面临同样的问题......
我目前无法解决
可惜了。我倾向于认为这可能根本不可能。

标签： java jaxb cxf jax-ws annox

【解决方案1】：

你试过用<annox:annotateClass>而不是<annox:annotate annox:class="org.jvnet.hk2.annotations.Contract" />

给出的例子：

这将使用 @SuppressWarnings("all") 注释生成的类 FindApplicationForApplicationSession

<jaxws:bindings node="xs:complexType[@name='findApplicationForApplicationSession']"> <annox:annotateClass>@java.lang.SuppressWarnings(name="all")</annox:annotateClass> </jaxws:bindings>

【讨论】：

项目已完成，我无法对此进行测试。看起来它可以工作，赞成。
FWIW 给未来的观众，这对我没有任何影响

【解决方案2】：

无法使用绑定文件注释 SEI 类。 Apache CXF 的 cxf-codegen-plugin 使用速度模板来生成 SEI 类。因此您应该创建一个提供不同速度模板的插件。

示例：https://github.com/valmol/samples-cxf-codegen-plugin/

生成器只是将 cmets 添加到生成的 SEI。添加不依赖于生成的上下文的注释也是简单的任务，只需将注释原样添加到自定义模板中。

【讨论】：