0

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をさらに含めることができます。

4

2 に答える 2

0

Javadoc は生成されたクラスには表示されませんが、jaxb はこれを次のような独自の標準コメントで上書きします。

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

しかし、まだenuciateにjavadocが表示されていません

于 2013-10-07T13:12:35.540 に答える