Xsd 阐明isn';t从xs:elements上的xs:documentation生成描述
我们正在使用maven Enouncate插件版本1.26.2,在生成文档的过程中遇到了一个问题。我们以以下方式向XSD添加了评论:Xsd 阐明isn';t从xs:elements上的xs:documentation生成描述,xsd,enunciate,Xsd,Enunciate,我们正在使用maven Enouncate插件版本1.26.2,在生成文档的过程中遇到了一个问题。我们以以下方式向XSD添加了评论: <xs:complexType name="PagingParameters"> <xs:annotation> <xs:documentation>information about PagingParameters</xs:documentation> </xs:annota
<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>
有关分页参数的信息
关于StartPos的信息
关于令牌的信息
关于noOfRecords的信息
第一个集合被解析并正确地输出到“阐明”页面上,但是其中单个元素的所有注释都完全丢失了。奇怪的是,这种情况只发生在元素序列中,但枚举工作得很好
我尝试了几种不同的格式化文档的方法,包括使用CDATA块,但似乎没有什么效果
我错过了什么?如果需要,我可以包含更多的XSD。Encluate使用JavaDoc解析其文档。您能确认JavaDoc是否显示在生成的Java类中吗?JavaDoc不会显示在生成的类中,但jaxb会用自己的标准注释覆盖它,如下所示:
/**
* Gets the value of the X property.
*
* @return
* possible object is
* {@link String }
*
*/
public String getX() {
但在enuciate中仍然没有显示javadoc