1

私は大規模な Java エンタープライズウェア ( MatrixOne / ENOVIA V6、気にするなら) に取り組んでいます。メンテナーは、非常にバニラのJavadocのように見えるある種のJavadocを提供しており、ブラウザでHTMLとして読むことができます。

しかし、これを Eclipse に統合することはできません。これは、ブラウザーに往復しなければならないため、苦痛です。Eclipseでは、私はただ恐ろしいものを手に入れますNote: This element neither has attached source nor attached Javadoc and hence no Javadoc could be found.: ここに画像の説明を入力

Javadoc をプロジェクトとレベルで定義できることを知った後.jar、次のことを知って両方を実行しようとしました。

  1. javadoc フォルダーには、文書化されたパッケージを正気で定義しているように見えるファイルが含まれていますpackage-list
  2. javadoc フォルダーには、通常のフォルダー/サブフォルダー パッケージ構造が含まれており、それ自体にClassName.htmlファイルが含まれています。たとえば、com.matrixone.apps.domain私のファイルの行は、多くのファイルを含む構造package-listと一致していますcom/matrixone/apps/domainClassName.html
  3. index.htmljavadoc フォルダーにファイルが含まれていません

Javadoc を定義しようとするとValidate...、 が見つからないためにボタンが失敗しますindex.html。その後、ダミーindex.htmlファイルを作成すると、検証は機能しますが、ベンダー クラス/メソッドにカーソルを合わせると Javadoc が表示されません。

私の質問は、この歪んだ Javadoc を Eclipse で表示するには何が欠けているのでしょうか? この時点で私が目にするサブ質問は次のとおりです。

  1. index.htmlダミーファイルを作成するのは悪い考えでしたか? はいの場合、どうすればよいですか? (つまり、Eclipse が期待するタグ/メタ情報は何ですか?)
  2. 標準の Javadoc ファイル ( String.html) とベンダーの Javadoc の 1 つ( ) を簡単に比較すると、 DomainObject.htmlEclipse で使用されている可能性のあるメタ情報が私の javadoc にないことがわかります。たとえば、私のベンダー Javadoc には、 Javadocに<meta>存在する多くのタグが含まれていません。 →メソッド/クラスJavadocを取得するためにEclipseが使用するロジック/ヒューリスティックを知っている人はいますか? コードを教えてください。この情報を使用して、Javadoc の何が問題なのかを突き止め、うまくいけば修正できるかもしれません。String.html<head>
  3. 同様の問題に直面したことがあるなら、あなたが適切だと思うものなら何でも。

私は現在、Windows 7の下で、Java 7でEclipse Juno SR1を使用しています。

もちろん、私が含めるのを忘れた情報を求めるためにコメントしてください. ご協力いただきありがとうございます！

4

1 に答える 1

1

同様の問題がありました。ただし、JDOM の JavaDoc のローカル コピーを使用して解決しようとはしませんでした。代わりに、適切な URL を使用しようとしていました (現在のバージョンの JDOM の JavaDoc URL はhttp://jdom.org/docs/apidocs/です)。そこで、私の Eclipse プロジェクトの Java ビルド パス構成の jdom.jar ライブラリで、URL を構成し、[検証] ボタンをクリックしました。Eclipse はそれが有効であると考えているように見えましたが、JavaDoc が添付されていないという同じエラーが発生しました。

その後、jdom.org には古いバージョンの JDOM ( http://www.jdom.org/docs/apidocs.1.1/ ) 用の JavaDoc もあることがわかりました。それで、jdom.jarライブラリのJavaDoc構成でそれを試してみましたが、うまくいきました!

私が学んだ教訓は、Eclipse が構成された JavaDoc を使用するかどうか (添付されていると見なされるかどうか) を決定するときに、ライブラリーのバージョンが考慮されるように見えるということでした。 ライブラリのバージョンがライブラリのJavaDocのバージョンと一致していることを確認してください（私が見つけたので明らかです）。

お役に立てれば。

于 2013-08-13T18:37:16.887 に答える