CXF wsdl2java不为成员生成Javadoc

Question

<xsd:complexType name="baseTaxParametersEnhanced">
  <xsd:annotation>
    <xsd:documentation>
      Some type comment.
    </xsd:documentation>
  </xsd:annotation>
  <xsd:sequence>
    <xsd:element name="municipality" type="xsd:string">
      <xsd:annotation>
        <xsd:documentation>
          Some member comment.
        </xsd:documentation>
      </xsd:annotation>
    </xsd:element>
    <xsd:element name="zip" type="xsd:string" />

Answer 1

不幸的是，几乎没有办法轻松地修复它。WSDL2Java使用xjc生成类。为此提出了一个老问题(JAXB-172)。你可以投赞成票。没有xjc插件可以修复这个问题。在如何使生成的类包含来自XML Schema文档的Javadoc中提到了更多关于这个问题的内容。

如上面所述，如果您能够控制WSDL/XSD文件，您可以用嵌入式定制绑定（jxb：javadoc）替换xsd：documentation。要实现这一点，您应该声明jxb命名空间，类似于：

<xsd:schema ... xmlns:jxb="http://java.sun.com/xml/ns/jaxb">

并更改类型声明：

<xsd:complexType name="baseTaxParametersEnhanced">
    <xsd:annotation>
        <xsd:appinfo>
            <jxb:class>
                <jxb:javadoc>Some type comment.</jxb:javadoc>
            </jxb:class>
        </xsd:appinfo>
    </xsd:annotation>
    <xsd:sequence>
        <xsd:element name="municipality" type="xsd:string">
            <xsd:annotation>
                <xsd:appinfo>
                    <jxb:property>
                        <jxb:javadoc>Some member comment.</jxb:javadoc>
                    </jxb:property>
                </xsd:appinfo>
            </xsd:annotation>
        </xsd:element>
        <xsd:element name="zip" type="xsd:string" />
    </xsd:sequence>
</xsd:complexType>

由于我认为不能使用XJC插件来执行这样的任务是很奇怪的（前面提到的问题中的一个评论说明了这一点），我决定尝试编写这样一个插件。

结果可以在这里找到：https://github.com/destin/xjc-javadoc-plugin

目前，它只向复杂类型的字段（而不是getter或setter）添加注释。如果有任何改进建议，我将不胜感激。当我认为它足够稳定时，我会试着把它贡献给CXF项目，这样任何人都可以很容易地使用它。