2

我正在与 Jaxb 合作。我想从这些类中生成 javaDoc 文件，这与我对常规 java 文件执行的方式相同吗？

4

3 回答 3

2

解决上述问题的更直接的方法（来自 JAXB 教程）：http: //jaxb.java.net/tutorial/section_5_4-Adding-Documentation.html#Adding%20Documentation

于 2010-04-09T15:18:16.030 回答
2

您可以使用xs:annotationwithxs:documentation和 jaxb 将它们拾取并在类中使它们成为 javadoc。

笔记：

  • 当 xs:documentation 标记在 xs:complexType 标记之外时，它没有拾取（可以理解）
  • 我假设可以在 .xsd 中的属性/元素级别为类的字段执行相同的操作，但没有尝试。
  • 如果您尝试将 HTML 标记放入文档中，则输出很丑陋。可能有办法解决这个问题，但我也没有尝试过。

    <xs:complexType name="TypeThatBecomesJavaClass">
      <xs:annotation>
       <xs:documentation>
           这成为 TypeThatBecomesJavaClass 的 javadoc
      </xs:documentation>
     </xs:annotation>
    ... ETC ...

于 2010-04-08T18:54:09.270 回答
0

假设您已经生成.java了文件.xsd——是的，它们是您可以修改、评论和记录的常规类。

于 2010-03-08T18:05:13.783 回答