Question

我们正在使用maven-enunciate-plugin版本1.26.2，并且在生成我们的文档时遇到了问题。我们通过以下方式为我们的XSD添加了评论：

<xs:complexType name="PagingParameters">
    <xs:annotation>
        <xs:documentation>information about PagingParameters</xs:documentation>
    </xs:annotation>
    <xs:sequence>
        <xs:choice minOccurs="0">
            <xs:element name="StartPos" type="xs:long" nillable="false">                    
                <xs:annotation>
                    <xs:documentation>information about StartPos</xs:documentation>
                </xs:annotation>
            </xs:element>
            <xs:element name="FollowOnBrowseToken" type="xs:string" nillable="false">
                <xs:annotation>
                    <xs:documentation>information about token</xs:documentation>
                </xs:annotation>
            </xs:element>
        </xs:choice>
        <xs:element name="NoOfRecords" type="xs:long" nillable="false">
            <xs:annotation>
                <xs:documentation>information about noOfRecords</xs:documentation>
            </xs:annotation>
        </xs:element>
    </xs:sequence>
</xs:complexType>

第一组在enunciate页面上被解析并正确输出，但是其中各个元素的所有注释都完全丢失了。奇怪的是，这只发生在元素序列中，但枚举效果很好。

我尝试了一些不同的格式化文档的方法，包括使用CDATA块，但似乎没有任何工作。

我错过了什么？如果需要，我可以包含更多的XSD。

Answer 1

Enunciate使用JavaDoc来解析其文档。你能否确认JavaDoc出现在生成的Java类中？

Answer 2

Javadoc NOT 出现在生成的类中，但是jaxb用它们自己的标准注释覆盖了这个：

/**
 * Gets the value of the X property.
 * 
 * @return
 *     possible object is
 *     {@link String }
 *     
 */
public String getX() {

但仍然没有在enuciate中显示javadoc

Enunciate不会生成xs上的描述：xs：elements上的文档

2 个答案: