Створення javadoc для збереження в Eclipse - java, eclipse, maven, javadoc

Я створюю Javadoc свого проекту за допомогою Maven (з javadoc:javadoc мета). Я також налаштував Розташування Javadoc властивість мого проекту до папки, де mavenгенерує Javadoc. Тоді я можу легко побачити повний Javadoc класу з представлення Eclipse Javadoc, вибравши "Відкрити доданий Javadoc у браузері".

Однак кожен раз, коли я вношу деякі зміни в документацію, мені потрібно явно відтворити документацію з maven, перш ніж я можу побачити оновлення документації в браузері.

Чи є спосіб я доручити Eclipse автоматично генерувати файли Javadoc, коли файл зберігається?

Я знаю, що це, мабуть, не гарна ідея, коли нізосередився на написанні документації, оскільки це може трохи уповільнити затемнення. Однак, коли моє головне завдання - написання документації, трохи автоматизації в цьому сенсі будуть оцінені. Я думаю, що правильне рішення проходить шляхом оновлення документації лише збережених файлів (і не запускає весь процес генерації Javadoc), але я не знаю, чи таке можливо.

Відповіді:

Якщо ви використовуєте Інтеграція Maven для Eclipse (m2e), ви можете налаштувати a фільтр виконання плагінів так що m2e знає, що ви хочете, щоб певне виконання плагіна також виконувалося в Eclipse. Ви хочете, щоб плагін запускався у фоновому режимі:

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

Зворотний бік цього всього полягає в тому, що він запускатиме все ваше виконання Javadoc, коли ви щось зберігаєте, поступовий в цьому сенсі вводить в оману. Це може засмітити ваше Eclipse, а не просто «трохи», як ви говорите в оновленому запитанні. Кожне виконання плагіна, яке робить більше, ніж абсолютна тривіальність, повинно бути ретельно вивчене.

По-справжньому додаткове рішення не вийдеМейвен, оскільки він не має сенсу лише будувати частини проекту, які потрібно будувати. Швидше, вам знадобиться Eclipse, щоб це зробити безпосередньо. Я думаю, що те ж саме відбувається і з компіляцією Java: це робиться самим Eclipse, поступово. Однак, згідно з FAQ FAQ Javadoc:

А9. Чи можу я поступово будувати документ із різних прогонів Javadoc?

В основному немає (...)

Ми називаємо цю додаткову збірку і розглядаємо її для майбутнього випуску.

Але нічого неможливого :)