3
我正在开发合同的第一个Web服务,并希望在模式中包含适当的文档,以便尽可能自我描述。你应该在哪里放置XSD文档,以便JAXB能够把它们放在Javadoc中?
将XSD注释和文档放在JAXB中并将它们包含在生成的Java文件中作为Javadoc的最佳实践是什么?我注意到一些元素和枚举可以获取文档,但有些则不是。为了让每个元素,元素或方法描述每个元素,复杂类型定义还是WSDL操作,是否有特定的位置?
我正在开发合同的第一个Web服务,并希望在模式中包含适当的文档,以便尽可能自我描述。你应该在哪里放置XSD文档,以便JAXB能够把它们放在Javadoc中?
将XSD注释和文档放在JAXB中并将它们包含在生成的Java文件中作为Javadoc的最佳实践是什么?我注意到一些元素和枚举可以获取文档,但有些则不是。为了让每个元素,元素或方法描述每个元素,复杂类型定义还是WSDL操作,是否有特定的位置?
也许并不完全符合您的要求,但将Java Docs添加到JAXB生成的源的一种方法是在JAXB绑定文件中使用<javadoc>
元素。
一个完整的答案可以在这里找到:
How to make generated classes contain Javadoc from XML Schema documentation
感谢。这看起来有点太Java和JAXB。 – jbx 2011-07-17 20:46:49