Search code examples
intershop

Generating Javadoc for intershop 7.5.3.0


I'm having some problems generating javadoc for my local environment in ish 7.5.3. I have the "includeJavadoc = true" property set in assembly/environment.properties and run the gradlew deployServer command.

I get he following stacktrace

    Caused by: org.gradle.internal.exceptions.LocationAwareException: Execution failed for task ':ac_bmecat:deployJavadocFiles'.
    at org.gradle.initialization.DefaultExceptionAnalyser.transform(DefaultExceptionAnalyser.java:77)
    at org.gradle.initialization.MultipleBuildFailuresExceptionAnalyser.transform(MultipleBuildFailuresExceptionAnalyser.java:47)
    at org.gradle.initialization.StackTraceSanitizingExceptionAnalyser.transform(StackTraceSanitizingExceptionAnalyser.java:30)
    at org.gradle.initialization.DefaultGradleLauncher.doBuild(DefaultGradleLauncher.java:108)
...
    at org.gradle.initialization.DefaultGradleLauncher.doBuild(DefaultGradleLauncher.java:106)
    ... 34 more
Caused by: com.intershop.deploy.index.DuplicateResourceException: Task :ac_bmecat:deployJavadocFiles: Resource '/home/user/projects/eserver1/assemblies/omnishop_assembly/target/javadoc/index.html' already defined for Task :deployJavadocIndexFiles
    at com.intershop.deploy.index.AvroTaskResources.create(AvroIndex.groovy:129)
    at com.intershop.deploy.resources.DeployCopyAction.doCopy(DeployCopyAction.groovy:129)
    at com.intershop.deploy.resources.DeployCopyAction.access$0(DeployCopyAction.groovy)
    at com.intershop.deploy.resources.DeployCopyAction$_execute_closure1_closure3.doCall(DeployCopyAction.groovy:95)
    at com.sun.proxy.$Proxy45.processFile(Unknown Source)

the reason of course is that ac_bmecat is deploying the index.html file again after another component has already done so. The question is how to get around this problem?


Solution

  • Let me answer my own question. Since 7.6 you cant generate javadoc like this anymore. Rather download latest studio and from the top menu : Help -> Help content. In the content menu select : "Intershop Suite Cartridge API JavaDoc". Javadoc is loaded from the gradle cache, so you would have to build and deploy an intershop server first.

    See kb for more details https://support.intershop.com/kb/index.php/Display/282Y19