我正在开发合同第一个Web服务，并希望在架构中包含适当的文档，以便尽可能自我描述。
将XSD注释和文档放入JAXB并将其作为Javadoc包含在生成的Java文件中的最佳实践是什么？我注意到一些元素和枚举得到了文档，但其他一些则没有。我是否需要在每个元素，复杂类型定义或WSDL操作之后放置它们以使其描述每个Class，Element或Method？
答案 0 :(得分：3)
也许并不完全是您所要求的，但将Java Docs添加到JAXB生成源的一种方法是使用JAXB绑定文件中的<javadoc>元素。
可在此处找到完整的答案：
How to make generated classes contain Javadoc from XML Schema documentation