如何从 jaxb 文件生成 javaDoc

Question

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

Answer 1

您可以将 xs:annotation 与 xs:documentation 一起使用，jaxb 会选取它们并使它们成为类上的 javadoc。

注意：

• 当 xs:documentation 标签为
  在 xs:complexType 标记之外，它
  没有接听（可以理解）
• 我假设可以在
  .xsd 中的属性/元素级别
  对于班级的领域，但没有尝试。
• 如果你尝试添加 HTML 标签，输出会很难看
  在文档中。有
  可能有办法解决这个问题，但我
  也没有尝试过。

    <xs:complexType name="TypeThatBecomesJavaClass">
      <xs:annotation>
       <xs:documentation>
           This becomes javadoc for TypeThatBecomesJavaClass
      </xs:documentation>
     </xs:annotation>
    ... etc ... 

Answer 2

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

Answer 3

假设您已从 .xsd 生成了 .java 文件 - 是的，它们是您可以修改、注释和记录的常规类。