JDK8 - ошибка файла класса для javax.interceptor.InterceptorBinding не найден "при попытке создания javadoc с использованием Maven javadoc plugin

Question

Я использую JDK8 (пробовал его на рабочем пространстве Eclipse с помощью Win x64 u25 JDK + в Linux, выпущенным Jenkins - jdk-8u20-linux-x64, та же проблема для обоих).

У меня есть мультимодульный проект Maven (я запускаю цель Maven «javadoc: aggregate» из основного модуля с типом упаковки «pom»).

Pom сборки раздела выглядит следующим образом:

<build> 
    <plugins> 
     <plugin> 
      <groupId>org.apache.maven.plugins</groupId> 
      <artifactId>maven-compiler-plugin</artifactId> 
      <configuration> 
       <source>1.8</source> 
       <target>1.8</target> 
      </configuration> 
     </plugin> 
     <plugin> 
      <groupId>org.apache.maven.plugins</groupId> 
      <artifactId>maven-javadoc-plugin</artifactId> 
      <configuration> 
       <additionalparam>-Xdoclint:none</additionalparam> 
      </configuration> 
     </plugin> 
    </plugins> 
</build> 

Я всегда получаю сообщение об ошибке:

[ERROR] Failed to execute goal org.apache.maven.plugins:maven-javadoc-plugin:2.10.1:aggregate (default-cli) on project uloan-global-build: An error has occurred in JavaDocs report generation: 
[ERROR] Exit code: 1 - javadoc: error - com.sun.tools.doclets.internal.toolkit.util.DocletAbortException: com.sun.tools.doclets.internal.toolkit.util.DocletAbortException: com.sun.tools.doclets.internal.toolkit.util.DocletAbortException: com.sun.tools.javac.code.Symbol$CompletionFailure: class file for javax.interceptor.InterceptorBinding not found 
[ERROR] 
[ERROR] Command line was: /usr/java/jdk1.8.0_20/jre/../bin/javadoc @options @packages 

Я попробовал все возможное и пытался искать на Google в течение длительного времени, но без успеха. я нашел ссылки, где люди имели схожие проблемы, но без какой-либо информации о возможном решении:

http://marc.info/?l=maven-user&m=139615350913286&w=2

http://mail-archives.apache.org/mod_mbox/maven-users/201409.mbox/%3C54101E24.6060304@gmx.de%3E (предполагая обновить JDK8 до> обновить 20, который я сделал, но проблема по-прежнему то же самое).

Любые подсказки или кто-либо испытал подобное поведение (к сожалению, по какой-то причине это выглядит как «редкая» проблема)? Отчаянно об этом ...

Answer 1

Это, кажется, из-за javax.transaction.Transactional (или любого другого класса в вашем пути к классам по этому вопросу), которые сам с аннотацией javax.interceptor.InterceptorBinding, который отсутствует в пути к классам, если явно не заявлено в зависимости:

@Inherited 
@InterceptorBinding // <-- this ONE is causing troubles 
@Target({ElementType.TYPE, ElementType.METHOD}) 
@Retention(value = RetentionPolicy.RUNTIME) 
public @interface Transactional { 

Говорит, что:

• javax.transaction.Transactional - поставляется с javax.transaction:javax.transaction-api:1.+ (или org.jboss.spec.javax.transaction:jboss-transaction-api_1.2_spec:1.0.0.Final) и обычно используется в приложениях JPA/ORM/JMS для аннотирования транзакционных методов.
• javax.interceptor.InterceptorBinding - должно поставляться с javax.interceptor:javax.interceptor-api:1.+. Но, хотя объявлено в верхней части Transactional, для нормальной работы не требуется, и (похоже, из-за этого) не получает переходную зависимость вашей инфраструктуры JPA.

В результате Javokoc JDK8 не обрабатывает источники (если какой-либо из них аннотируется @Transactional).

Хотя это может быть более конкретным о месте, где эта «ошибка» была найдена.

Исправление проблемы: добавление javax.interceptor:javax.interceptor-api:1.+ зависимостей устраняет проблему.

Answer 2

Вы также можете добавить следующую строку в конфигурацию javadoc maven: <failOnError>false</failOnError>. Это скажет, что выполнение javadoc игнорирует все ошибки и не позволяет сборке сбой. Поэтому

Ваш полный Javadoc плагин конфигурации будет выглядеть следующим образом:

<build> 
    <plugins> 
     <plugin> 
      <groupId>org.apache.maven.plugins</groupId> 
      <artifactId>maven-compiler-plugin</artifactId> 
      <configuration> 
       <source>1.8</source> 
       <target>1.8</target> 
      </configuration> 
     </plugin> 
     <plugin> 
      <groupId>org.apache.maven.plugins</groupId> 
      <artifactId>maven-javadoc-plugin</artifactId> 
      <configuration> 
       <additionalparam>-Xdoclint:none</additionalparam> 
       <failOnError>false</failOnError> 
      </configuration> 
     </plugin> 
    </plugins> 
</build> 

Answer 3

Как уже упоминалось @kozlovda, проблема связана с аннотацией @Transactional (javax.transaction.Transactional).

Если у вас есть описываемая ошибка на пробеге Maven для приложения Spring, есть и другой способ решить эту проблему: убедитесь, что не использовать аннотацию из javax.transaction, вместо этого использовать org.springframework.transaction.annotation.Transactional.

Замена импорта исправила проблему для меня.

Answer 4

Вы также можете добавить зависимость от Maven в свой файл POM. Он решил эту проблему для меня

<dependency> 
     <groupId>net.sourceforge.cobertura</groupId> 
     <artifactId>cobertura</artifactId> 
     <version>2.1.1</version> 
     <scope>compile</scope> 
    </dependency> 

Answer 5

При правильном кредита @lpratlong вот полная запись для нетерпеливых людей, как я, чтобы копипаст:

 <plugin> 
      <groupId>org.apache.maven.plugins</groupId> 
      <artifactId>maven-javadoc-plugin</artifactId> 
      <!-- <version>3.0.0</version> --> 
      <configuration> 
       <!-- Silence error javax.interceptor.InterceptorBinding not found --> 
       <additionalDependencies> 
        <additionalDependency> 
         <groupId>javax.interceptor</groupId> 
         <artifactId>javax.interceptor-api</artifactId> 
         <version>1.2</version> 
        </additionalDependency> 
       </additionalDependencies> 
      </configuration> 
     </plugin> 

версия закомментирована, потому что в моем случае весной -boot управляет версией, просто восстанавливается по мере необходимости.