3

私はWebサービスを開発しましたが、当然のことながら、ユーザーはドキュメントを見たいと思っています。javadocコメントまたは明示的なアノテーションを使用して、コードを単純に文書化したいと思います。

@XmlComment("This is used to [blah blah]")
@XmlElement(name = "referenceDate", namespace = NAMESPACE, type = Date.class)
public void setReferenceDate(Date referenceDate) {
    this.referenceDate = referenceDate;
}

また

/**
 * This is used to [blah blah]
 */
@XmlElement(name = "referenceDate", namespace = NAMESPACE, type = Date.class)
public void setReferenceDate(Date referenceDate) {
    this.referenceDate = referenceDate;
}

ここで証明されているように、上記はサポートされていません。

  • JAXB-273-アノテーションからxs：documentation要素を作成する2006年のリクエスト
  • JAXB-369-コメントからxs：documentation要素を作成する2007年のリクエスト
  • SO-470001-「それはできません」stackoverflowの質問

したがって、上記を使用してサービスにコメントすることはできないことを理解しています。しかし...確かに、手動ではない方法でそうする方法はまだあります。このためだけにすべてのXMLを手作りする必要がありますか？それが答えである場合、なぜこの機能をJAXBに組み込むことにもっと注意が払われないのですか？エンタープライズグレードのWebサービスには、まったく必須のようですよね？

4

1 に答える 1

0

あなたは正しいですそれは貧しいです。最近は契約優先がほとんどなので、優先されていないのではないでしょうか。XSLT を使用して、別の XML ドキュメントから WSDL にコメントを追加できます。Java コードから生成するほどではありませんが、何もないよりはましです。これは、それを行っている古代の投稿ですhttp://www.gridlab.org/WorkPackages/wp-5/guide/wsdltips.html

于 2012-06-20T20:49:22.087 に答える