[jira] [Created] (AXIS2-5829) JavaDoc warnings when using Axis2 (adl) to generate client

["Petr Dvorak (JIRA)" <ji...@apache.org>]

Petr Dvorak created AXIS2-5829:
----------------------------------

             Summary: JavaDoc warnings when using Axis2 (adl) to generate client
                 Key: AXIS2-5829
                 URL: https://issues.apache.org/jira/browse/AXIS2-5829
             Project: Axis2
          Issue Type: Bug
            Reporter: Petr Dvorak
            Priority: Trivial
         Attachments: pom.xml, service.wsdl

I use {{axis2-wsdl2code-maven-plugin}} to generate a SOAP service client (using default ADB).

However, the plugin generates JavaDoc warnings, like these (many more instances):

{code:ActionScript}
[WARNING] Javadoc Warnings
[WARNING] /private/tmp/lime-security-powerauth/powerauth-java-client-axis/target/generated-sources/axis2/wsdl2code/src/io/getlime/powerauth/soap/PowerAuthPortServiceStub.java:331: warning - Tag @see: reference not found: io.getlime.powerauth.soap.PowerAuthPortService#blockActivation
[WARNING] /private/tmp/lime-security-powerauth/powerauth-java-client-axis/target/generated-sources/axis2/wsdl2code/src/io/getlime/powerauth/soap/PowerAuthPortServiceStub.java:447: warning - Tag @see: reference not found: io.getlime.powerauth.soap.PowerAuthPortService#startblockActivation
[WARNING] /private/tmp/lime-security-powerauth/powerauth-java-client-axis/target/generated-sources/axis2/wsdl2code/src/io/getlime/powerauth/soap/PowerAuthPortServiceStub.java:599: warning - Tag @see: reference not found: io.getlime.powerauth.soap.PowerAuthPortService#getCallbackUrlList
[WARNING] /private/tmp/lime-security-powerauth/powerauth-java-client-axis/target/generated-sources/axis2/wsdl2code/src/io/getlime/powerauth/soap/PowerAuthPortServiceStub.java:715: warning - Tag @see: reference not found: io.getlime.powerauth.soap.PowerAuthPortService#startgetCallbackUrlList
{code}

After looking into the JavaDoc, I noticed that while the JavaDoc refers to {{PowerAuthPortService}} class, the actual generated class name is {{PowerAuthPortServiceStub}}.

I assume I am probably supposed to implement my own {{PowerAuthPortService}} that extends / encapsulates the {{PowerAuthPortServiceStub}} class (?). But this should IMO be mentioned in the documentation more explicitly (the implicit naming convention), or I should be able to specify the final client class name to be referred in JavaDoc, since mine is {{PowerAuthServiceClient}} at the moment...



--
This message was sent by Atlassian JIRA
(v6.3.4#6332)

---------------------------------------------------------------------
To unsubscribe, e-mail: java-dev-unsubscribe@axis.apache.org
For additional commands, e-mail: java-dev-help@axis.apache.org