Najprostszym podejściem do pracy z Javą 8 i Javą 7 jest użycie profilu w kompilacji:

<profiles>
  <profile>
    <id>doclint-java8-disable</id>
    <activation>
      <jdk>[1.8,)</jdk>
    </activation>

    <build>
      <plugins>
        <plugin>
          <groupId>org.apache.maven.plugins</groupId>
          <artifactId>maven-javadoc-plugin</artifactId>
          <configuration>
            <additionalparam>-Xdoclint:none</additionalparam>
          </configuration>
        </plugin>
      </plugins>
    </build>
  </profile>
</profiles>

Oto najbardziej zwięzły sposób, jaki znam, aby ignorować Ostrzeżenia doclint niezależnie od używanej wersji Javy. Nie ma potrzeby powielania konfiguracji wtyczki w wielu profilach z niewielkimi modyfikacjami.

<profiles>
  <profile>
    <id>doclint-java8-disable</id>
    <activation>
      <jdk>[1.8,)</jdk>
    </activation>
    <properties>
      <javadoc.opts>-Xdoclint:none</javadoc.opts>
    </properties>
  </profile>
</profiles>

<build>
  <plugins>
    <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-javadoc-plugin</artifactId>
      <version>2.9.1</version>
      <executions>
        <execution>
          <id>attach-javadocs</id> <!-- The actual id should be apparent from maven output -->
          <configuration>
            <additionalparam>${javadoc.opts}</additionalparam>
          </configuration>
        </execution>
      </executions>
    </plugin>
    ...
  </plugins>
</build>

Testowane na oracle / open jdk 6, 7 i 8.

Dodaj do sekcji Właściwości globalne w pliku pom:

<project>
    ...
    <properties>
        <additionalparam>-Xdoclint:none</additionalparam>
    </properties>

Wspólne rozwiązanie podane tutaj w innych odpowiedziach (dodanie tej właściwości w sekcji wtyczek) nie działało z jakiegoś powodu. Tylko ustawiając go globalnie mogłem zbudować Javadoc jar pomyślnie.

Najkrótsze rozwiązanie, które będzie działać z dowolną wersją Javy:

<profiles>
    <profile>
        <id>disable-java8-doclint</id>
        <activation>
            <jdk>[1.8,)</jdk>
        </activation>
        <properties>
            <additionalparam>-Xdoclint:none</additionalparam>
        </properties>
    </profile>
</profiles>

To w zasadzie odpowiedź@ankon plus odpowiedź@zapp .

Dla użytkowników maven-javadoc-plugin 3.0.0:

Zastąp

<additionalparam>-Xdoclint:none</additionalparam>

By

<doclint>none</doclint>

Nadpisywanie tylko konfiguracji maven-javadoc-plugin, nie rozwiązuje problemu z mvn site (używanym np. na etapie wydania). Oto co musiałem zrobić:

<profile>
  <id>doclint-java8-disable</id>
  <activation>
    <jdk>[1.8,)</jdk>
  </activation>
  <build>
    <plugins>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-javadoc-plugin</artifactId>
        <configuration>
          <additionalparam>-Xdoclint:none</additionalparam>
        </configuration>
      </plugin>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-site-plugin</artifactId>
        <version>3.3</version>
        <configuration>
          <reportPlugins>
            <plugin>
              <groupId>org.apache.maven.plugins</groupId>
              <artifactId>maven-javadoc-plugin</artifactId>
              <configuration>
                <additionalparam>-Xdoclint:none</additionalparam>
              </configuration>
            </plugin>
          </reportPlugins>
        </configuration>
      </plugin>
    </plugins>
  </build>
</profile>

Nie sądzę, żeby samo wyłączenie Doclinta było dobrym rozwiązaniem, przynajmniej nie na dłuższą metę. Dobrze, że Javadoc stał się nieco bardziej rygorystyczny, więc właściwym sposobem na naprawienie problemu z kompilacją jest naprawienie podstawowego problemu . Tak, ostatecznie będziesz musiał naprawić te pliki kodu źródłowego.

Oto rzeczy, na które warto zwrócić uwagę, które wcześniej można było ujść na sucho:

• nieprawidłowo Ukształtowany HTML (na przykład brak znacznika końca, nawiasy nieprzezroczyste itp.)
• Invalid {@link } s. (to samo dotyczy podobnych tagów, takich jak @see)
• nieprawidłowe @author wartości. To kiedyś było akceptowane: @author John <[email protected]> ale już tak nie jest z powodu nawiasów nieusuwalnych.
• tabele HTML w Javadoc wymagają teraz podsumowania lub podpisu. Zobacz to pytanie dla wyjaśnienia.

Będziesz musiał po prostu naprawić swoje pliki z kodem źródłowym i budować Javadoc, dopóki nie będzie mógł zbudować bez awarii. Uciążliwe tak, ale osobiście lubię, gdy wprowadzam swoje projekty do Poziom DocLint, ponieważ oznacza to, że mogę być bardziej pewny, że Javadoc, który produkuję, jest tym, co zamierzam.

Jest oczywiście problem, jeśli generujesz Javadoc na jakimś kodzie źródłowym, którego sam nie stworzyłeś, na przykład dlatego, że pochodzi on z jakiegoś generatora kodu, np. wsimport. Dziwne, że Oracle nie przygotowało własnych narzędzi do zgodności z jdk8 przed wydaniem JDK8. Wygląda na to, że zostanie naprawione dopiero w Javie 9 . Tylko w tym konkretnym przypadku I sugerujemy wyłączenie DocLint zgodnie z dokumentacją w innym miejscu na tej stronie.

Możesz spróbować ustawić właściwość failOnError (zobacz dokumentacja wtyczki) na false:

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-javadoc-plugin</artifactId>
    <version>2.9</version>
    <executions>
        <execution>
            <id>attach-javadocs</id>
            <goals>
                <goal>jar</goal>
            </goals>
            <configuration>
              <failOnError>false</failOnError>
            </configuration>
        </execution>
    </executions>
</plugin>

Jak widać z dokumentów, domyślną wartością jest true.

Ponieważ zależy to od wersji twojego JRE, która jest używana do uruchomienia polecenia maven, prawdopodobnie nie chcesz wyłączać DocLint domyślnie w Twoim pom.xml

Stąd z linii poleceń można użyć przełącznika -Dadditionalparam=-Xdoclint:none.

Przykład: mvn clean install -Dadditionalparam=-Xdoclint:none

Nazwa właściwości konfiguracyjnej została zmieniona w najnowszej wersji wtyczki Maven-javadoc czyli 3.0.0.

Stąd nie będzie działać. Więc musimy zmodyfikować go jak poniżej.

   <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-javadoc-plugin</artifactId>
      <version>3.0.0</version>
      <configuration>
         <doclint>none</doclint>
      </configuration>
  </plugin>

Począwszy od maven-javadoc-plugin 3.0.0 powinieneś używać additionalJOption Aby ustawić dodatkową opcję Javadoc, więc jeśli chcesz, aby Javadoc wyłączał doclint, powinieneś dodać następującą właściwość.

<properties>
    ...
    <additionalJOption>-Xdoclint:none</additionalJOption>
    ...
<properties>

Należy również wspomnieć o wersji maven-javadoc-plugin jako 3.0.0 lub wyższej.

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-javadoc-plugin</artifactId>
    <version>3.0.0</version>    
</plugin>

Nie jestem pewien, czy to pomoże, ale nawet ja spotkałem się z dokładnie tym samym problemem bardzo niedawno z oozie-4.2.0 Wersja. Po przeczytaniu powyższych odpowiedzi dodałem właśnie opcję maven za pomocą wiersza poleceń i zadziałało dla mnie. Więc dzielę się tutaj.

Używam Javy 1.8.0_77, nie próbowałem z Javą 1.7

Bin/mkdistro.sh -Dskiptests - Dmaven.javadoc.opts='-xdoclint: - html '

Dodano poniżej

JAVA_TOOL_OPTIONS=-DadditionalJOption= - Xdoclint:none

Into Jenkins job konfiguracja > środowisko kompilacji > wprowadzanie zmiennych środowiskowych do procesu kompilacji > zawartość Właściwości

Rozwiązałem mój problem budowania kodu przez Jenkins Maven : -)

Więc zaoszczędź sobie kilka godzin, których nie zrobiłem i spróbuj tego, jeśli wydaje się, że nie działa:

 <additionalJOption>-Xdoclint:none</additionalJOption>

Znacznik jest zmieniany dla nowszych wersji.

Chciałbym dodać trochę wglądu w inne odpowiedzi

W moim przypadku

- Xdoclint: none

Zacznijmy od tego, że w moim projekcie wcale nie potrzebowałem javadoc. Tylko niektóre niezbędne wtyczki miały zależność od czasu kompilacji.

Więc najprostszym sposobem rozwiązania mojego problemu było:

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-javadoc-plugin</artifactId>
    <configuration>
        <skip>true</skip>
    </configuration>
</plugin>

Jestem trochę spóźniona na imprezę, ale też musiałam szukać obejścia, wylądowałam tutaj, a potem je znalazłam.

Oto, co działa dla mnie:-

export JAVA_TOOL_OPTIONS=-DadditionalJOption=-Xdoclint:none

A następnie uruchom Maven build, dowolną dystrybucję Linuksa itp. Fajne jest to, że nie wymaga modyfikacji plików Maven Config - nie mogłem tego zrobić, ponieważ moim celem było odbudowanie kilku pakietówCentos rpm, więc musiałem pójść naprawdę głęboko.

Aby zignorować brakujące tagi @param i @return wystarczy wyłączyć missing grupa doclint . W ten sposób javadoc będzie nadal sprawdzany pod kątem problemów z wyższym poziomem i składnią:

    <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-javadoc-plugin</artifactId>
        <version>3.0.0</version>
        <configuration>
            <doclint>all,-missing</doclint>
        </configuration>
    </plugin>

Zauważ, że jest to dla wtyczki w wersji 3.0 lub nowszej.