JDK8 - Error "class file for javax.interceptor.InterceptorBinding not found" when trying to generate javadoc using Maven javadoc plugin

Question

I am using JDK8 (tried it on my Eclipse workspace with Win x64 u25 JDK + on Linux launched by Jenkins - jdk-8u20-linux-x64, same problem for both).

I have multi-module Maven project (I am launching Maven goal "javadoc:aggregate" from a main module with packaging type "pom").

Pom build section looks like this:

<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>

I always receive error:

[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

I have tried everything possible and tried to search on Google for a long time, but no success. I have found links, where people had similar problems, but without any information about possible solution:

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 (suggesting to update JDK8 to > update 20, which I did, but problem is still the same).

Any hints or anyone experienced this kind of behavior as well (unfortunately it looks as quite "rare" problem for some reason)? Quite desperate about this...

I had the same problem with GRADLE - it was because I had JDK 1.7 on my path but JAVA_HOME was pointing at a 1.8 JDK - Thanks, @JamesB — BretC, Feb 02 '15 at 20:44

score 142 · Accepted Answer · edited Jan 03 '20 at 17:18

142

This appears to be due to javax.transaction.Transactional (or any other class in your classpath for that matter) being itself annotated with javax.interceptor.InterceptorBinding, which is missing in classpath unless explicitly declared in dependencies:

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

Said that:

javax.transaction.Transactional - comes with javax.transaction:javax.transaction-api:1.+ (or org.jboss.spec.javax.transaction:jboss-transaction-api_1.2_spec:1.0.0.Final) and is typically used in JPA/ORM/JMS apps to annotate transactional methods.
javax.interceptor.InterceptorBinding - should come with javax.interceptor:javax.interceptor-api:1.+. But, although declared on top of Transactional, is not required for normal operation and (looks like because of this) is not getting fetched as a transitive dependency of your JPA framework.

As a result JDK8 javadoc tool fails to process the sources (if any of them are annotated with @Transactional).

Although it could be more specific about the place where this "error" has been found.

Issue fix: adding javax.interceptor:javax.interceptor-api:1.+ dependency fixes the issue.

<dependency>
    <groupId>javax.interceptor</groupId>
    <artifactId>javax.interceptor-api</artifactId>
    <version>1.2.2</version>
</dependency>

Note (January 2020): the latest (plausible) version is currently 1.2.2 (see https://mvnrepository.com/artifact/javax.interceptor/javax.interceptor-api

edited Jan 03 '20 at 17:18

t0r0X

3,058
1
29
26

answered Feb 27 '15 at 00:44

kozlovda

1,589
1
8
3

2

Yes, this solved a similar problem for me. Seems JDK 8’s javadoc requires transitive dependencies to be in the classpath whereas JDK 7 was more lenient. – Jesse Glick Mar 11 '15 at 22:22
11

The maven dependency is: javax.interceptor javax.interceptor-api 1.2 – Tim van der Lippe May 27 '15 at 10:04
Thanks a lot, @kozlovda, that solved it. Sorry for long delay with checking the answer - was working on something completely different in the meantime and couldn't find time to verify this in the old workspace :-) – Michal Aron Nov 06 '15 at 20:29
Thank you @kozlovda this helped a lot :) – Sercan Ozdemir Dec 28 '15 at 08:16
10

It's better to add it as an additionnal dependencies of maven-javadoc-plugin since the problem relies only in a conflict during javadoc generation process: javax.interceptor javax.interceptor-api 1.2 – lpratlong Mar 28 '17 at 10:49
Isn't there a way to fix this for all the missing dependencies? I've started to add the dependencies, but then I keep getting the error with a next one, and a next one... So far: javax.interceptor-api, javax.ejb, javax.inject, javax.persistence, org.apache.commons.collections... it looks like a never ending story... – Daniel Rodríguez Mar 29 '17 at 10:17

score 52 · Answer 2 · answered Jul 06 '16 at 18:41

52

As @kozlovda already mentions, the issue comes with the @Transactional annotation (javax.transaction.Transactional).

If you have the described error on a Maven run for a Spring application, there is also another way to resolve the issue: Make sure not to use the the annotation from javax.transaction, instead use org.springframework.transaction.annotation.Transactional.

Replacing the import fixed the issue for me.

answered Jul 06 '16 at 18:41

Andreas Siegel

749
6
6

Thanks! The javadoc for one of my controller classes always failed and I didn't saw directly why. It was the only class with an import on javax.Transactional. – rdhaese Jul 12 '17 at 12:09
3

thanks, this is the right fix. If you are writing a spring application, you are supposed to use spring transactional, even if spring supports javax EJB transactional. And you are not supposed to mix the two different Transactional. I had the same issue with javadoc and I found out in one class out of thousands I had javax.transactional imported. Javadoc and this comment helped me out in finding the real mistake. – pdenti May 09 '19 at 20:45
This is a great answer and, I think, the right one for most of the cases. Usually you are using @Transactional in spring and so it just makes sense that you mistook the annotation – Phate Jul 10 '20 at 07:30

chrisinmtown · Answer 3 · 2018-07-05T14:45:10.960

@lpratlong says in an answer supplied in a comment "add it as an additionnal dependencies of maven-javadoc-plugin". That worked for me, here's the full Maven plugin entry for impatient people like me to copy-paste:

        <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>

The version is commented out because in my case spring-boot manages the version, just restore as needed.

This is the best answer IMO because adding the dependency inside the plugin configuration makes it clear this dependency is needed by that plugin. — pyb, May 01 '18 at 18:37

score 11 · Answer 4 · edited Jun 30 '15 at 21:48

You can also add the following line to your javadoc maven configuration: <failOnError>false</failOnError>. This will tell the javadoc execution to ignore all errors and not let the build fail.

Your complete javadoc plugin config would therefore look like this:

<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>

This answer does not actually address the problem, it rather hides it. failOnError=true allows Maven to continue the build, but since JavaDoc aborts, not all files are generated. For instance, all index files might not be generated. Can you consider a build with truncated JavaDocs a successful one? — Martín Straus, Aug 05 '15 at 04:08

score 4 · Answer 5 · answered Jan 27 '20 at 17:07

4

Use

import org.springframework.transaction.annotation.Transactional;

instead of

import javax.transaction.Transactional;

when you are using @Transactional with Spring

answered Jan 27 '20 at 17:07

gfkl

49
1
4

score 2 · Answer 6 · answered Jul 22 '18 at 08:45

2

InterceptorBinding is available at following maven dependency:

<dependency>
    <groupId>javax.interceptor</groupId>
    <artifactId>javax.interceptor-api</artifactId>
    <version>1.2</version>
</dependency>

answered Jul 22 '18 at 08:45

Oleksii Kyslytsyn

2,048
2
24
37

score 1 · Answer 7 · answered Sep 07 '18 at 14:48

1

I had the same problem with Spring-Boot 2 Kotlin and gradle. As @kozlovda suggested:

dependencies {
  compileOnly 'javax.interceptor:javax.interceptor-api:1.+'
  ...

fixed the problem

answered Sep 07 '18 at 14:48

Oliver Sahner

121
1
4

score 0 · Answer 8 · answered Sep 05 '19 at 11:51

0

Replace as below

import org.springframework.transaction.annotation.Transactional;

@Service
@Transactional
public class WorkingService

answered Sep 05 '19 at 11:51

Fred Ondieki

2,228
23
22

score -6 · Answer 9 · answered Dec 28 '16 at 15:43

You can also add Maven dependency to your POM file. It solved this problem for me

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

JDK8 - Error "class file for javax.interceptor.InterceptorBinding not found" when trying to generate javadoc using Maven javadoc plugin

9 Answers9

Linked