/ / Eclipseで保存時にjavadocを生成する - java、eclipse、maven、javadoc

Eclipseでの保存時にjavadocを生成する - java、eclipse、maven、javadoc

私は自分のプロジェクトのJavadocをMavenを使って生成しています。 javadoc:javadoc ゴール)。 私も設定しました Javadocのロケーション 自分のプロジェクトのプロパティをmavenしたフォルダにJavadocを生成します。それから、EclipseのJavadocビューから「ブラウザでOpen Javadocを開く」を選択すると、クラスのJavadoc全体を簡単に見ることができます。

しかし、私がドキュメンテーションに何らかの変更を加えるたびに、私はブラウザでドキュメンテーションの更新を見ることができる前に、明示的にmavenでドキュメンテーションを作り直す必要があります。

ファイルが保存されたときにJavadocファイルを自動的に生成するようにEclipseに指示する方法はありますか?

そうでないとき、これはおそらく良い考えではないことを私は知っていますEclipseを少し遅くするかもしれないので、ドキュメントを書くことに集中しました。しかし、私の主な仕事がドキュメンテーションを書くことであるとき、この意味での少しの自動化は評価されるでしょう。保存されたファイルのみのドキュメントを更新することで正しい解決策が通ると思います(そしてJavadoc生成プロセス全体を起動することはしません)が、そのようなことが可能かどうかはわかりません。

回答:

回答№1は1

あなたが Eclipse用Maven統合(m2e)、あなたが設定することができます プラグイン実行フィルタ m2eは、あなたが特定のプラグインの実行がEclipseでも実行されることを望むことを知っているように。プラグインをバックグラウンドで実行したいと思うでしょう。

       <execute >
<runOnIncremental>true</runOnIncremental>
</execute >

これとは反対に、何かを保存するとJavadocの実行全体が実行されます。 増分 その意味で誤解を招くようです。 更新された質問で言うように、それはあなたのEclipseを詰まらせるかもしれません、そして単に「少し」だけではありません。絶対的な些細なこと以上のことをしているすべてのプラグインの実行は厳しく精査されるべきです。

真に漸進的な解決策は、これからは生まれないでしょう。Mavenは、プロジェクトの一部だけを構築しなければならないという意味がないためです。そうではなく、これを直接行うにはEclipseが必要になります。私は同じことがJavaのコンパイルにも起こると思います。それはEclipse自身によって、少しずつ行われます。ただし、Javadoc FAQによると、

A9。 Javadocのさまざまな実行から徐々に文書を作成することはできますか?

基本的にいいえ(...)

私たちはこの増分ビルドと呼び、将来のリリースのためにそれを検討しています。

しかし不可能なことは何もありません:)