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-unsubscr...@axis.apache.org
For additional commands, e-mail: java-dev-h...@axis.apache.org
