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

with を使用するxs:annotationxs:documentation、jaxb がそれらをピックアップしてクラスの javadoc にします。

ノート:

  • xs:documentation タグが xs:complexType タグの外側にある場合、(当然のことながら) 取得されませんでした。
  • クラスのフィールドの.xsdの属性/要素レベルで同じことができると思いますが、試しませんでした。
  • ドキュメントに HTML タグを挿入しようとすると、出力が見苦しくなります。おそらくそれを回避する方法がありますが、私もそれを試しませんでした。

    <xs:complexType name="TypeThatBecomesJavaClass">
      <xs:annotation>
       <xs:documentation>
           これは TypeThatBecomesJavaClass の javadoc になります。
      </xs:documentation>
     </xs:annotation>
    ...など...

于 2010-04-08T18:54:09.270 に答える
0

.javaからファイルを生成したと仮定します.xsd-はい、それらは変更、コメント、および文書化できる通常のクラスです。

于 2010-03-08T18:05:13.783 に答える