Как настроить плагин maven-java-doc, чтобы только измененные разделы исходного кода java обновлялись в полных сгенерированных файлах java?

Question

У меня есть вопрос, касающийся плагина Maven Javadoc в Apache Maven. Моя текущая конфигурация позволяет создать полный новый документ Java из моего проекта Maven, если фаза установки будет выполнена. Если бы я вызвал команду "mvn clean install", файлы java doc будут полностью удалены (для этого я настроил плагин Maven clean). И на этапе установки файлы java doc будут сгенерированы снова!

Есть ли способ настроить плагин java doc таким образом, чтобы в существующем java doc обновлялись только измененные разделы исходного кода java? И не полный документ Java будет сгенерирован снова?

Моя maven-javadoc-конфигурация:

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-javadoc-plugin</artifactId>
    <version>2.9</version>
    <configuration>
        <noqualifier>all</noqualifier>
        <reportOutputDirectory>myJavaDocOutputDirectory</reportOutputDirectory>
    </configuration>
    <executions>
        <execution>
            <id>create-myjavadoc</id>
            <phase>install</phase>
            <goals>
                <goal>javadoc</goal>
            </goals>
        </execution>
    </executions>
</plugin>

Моя конфигурация maven-clean-plugin:

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-clean-plugin</artifactId>
    <version>2.4.1</version>
    <configuration>
        <filesets>
            <fileset>
                <directory>target</directory>
                <includes>
                    <include>**/*</include>
                </includes>
                <followSymlinks>false</followSymlinks>
            </fileset>
            <fileset>
                <directory>MySourcefolder</directory>
                <includes>
                    <include>**/*</include>
                </includes>
                <followSymlinks>false</followSymlinks>
            </fileset>
        </filesets>
    </configuration>
</plugin>

Answer 1

Возможно, JavaDoc не должен генерироваться в сборке снимка - в зависимости от ваших требований. Если это так, добавьте профиль для выпуска или специальных сборок, который включает конфигурацию maven-javadoc-plugin, и удалите плагин из раздела по умолчанию для сборки / плагинов. Если вы хотите сгенерировать JavaDoc, запустите профиль с помощью "mvn clean install -P ". В противном случае просто запустите "mvn clean install", чтобы избежать генерации JavaDoc. Такой профиль может выглядеть так:

<profiles>
  <profile>
    <id>release-build</id>

    <build>
      <plugins>
        <plugin>
          <groupId>org.apache.maven.plugins</groupId>
          <artifactId>maven-javadoc-plugin</artifactId>
          <version>2.9</version>
          <configuration>
            <noqualifier>all</noqualifier>
            <reportOutputDirectory>myJavaDocOutputDirectory</reportOutputDirectory>
          </configuration>
          <executions>
            <execution>
              <id>create-myjavadoc</id>
              <phase>install</phase>
              <goals>
                <goal>javadoc</goal>
              </goals>
            </execution>
          </executions>
        </plugin>
      </plugins>
    </build>
  </profile>
</profiles>

Вы можете запустить его с помощью: "mvn clean install -P release-build"