maven-javadoc-plugin fails when using jaxws-maven-plugin
Description
Our maven project has as its parent the aem-global-parent:
1
2
3
4
5
6
<parent>
<groupId>io.wcm.maven</groupId>
<artifactId>io.wcm.maven.aem-global-parent</artifactId>
<version>1.2.2</version>
<relativePath />
</parent>which in has as its parent global-parent:
1
2
3
4
5
6
<parent>
<groupId>io.wcm.maven</groupId>
<artifactId>io.wcm.maven.global-parent</artifactId>
<version>14</version>
<relativePath />
</parent>In this you have a maven-javadoc-plugin execution:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
<!-- Deploy javadoc to repository -->
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-javadoc-plugin</artifactId>
<inherited>true</inherited>
<executions>
<execution>
<id>attach-javadocs</id>
<goals>
<goal>jar</goal>
</goals>
</execution>
</executions>
</plugin>In our project I added a jaxws-maven-plugin execution like this:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
<plugin>
<groupId>org.codehaus.mojo</groupId>
<artifactId>jaxws-maven-plugin</artifactId>
<version>2.4.1</version>
<executions>
<execution>
<goals>
<goal>wsimport</goal>
</goals>
<phase>generate-sources</phase>
</execution>
</executions>
<configuration>
<sourceDestDir>src/main/java</sourceDestDir>
<packageName>aem.zeppelin.ws.oxerpservice</packageName>
<wsdlUrls>
<wsdlUrl>
https://oxid-integration-zeppelin-cat.zeppelin-rental.de/modules/erp/oxerpservice.php?WSDL&version=2.14.0
</wsdlUrl>
</wsdlUrls>
<vmArgs>
<vmArg>-Djavax.xml.accessExternalSchema=all</vmArg>
</vmArgs>
</configuration>
</plugin>to generate some proxy classes to access a SOAP WS.
When I did so the maven-javadoc-plugin execution failed with several different errors saying that the javadoc contained some errors (which can be true but we cannot control the generated classes).
To solve it I've followed the suggestions given at:
https://stackoverflow.com/questions/15886209/maven-is-not-working-in-java-8-when-javadoc-tags-are-incomplete
And added an override maven-javadoc-plugin execution in our project like this:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-javadoc-plugin</artifactId>
<inherited>true</inherited>
<executions>
<execution>
<id>attach-javadocs</id>
<goals>
<goal>jar</goal>
</goals>
<configuration>
<additionalparam>-Xdoclint:none</additionalparam>
</configuration>
</execution>
</executions>
</plugin>The difference from the one you provide in your parent pom is the additionalparam that turns off the new DocLint feature in Java8.
My question for you is if you think this additionalparam should be added on your side, if we should keep with described approach or if you have a different suggestion?
Thanks.
