De toute façon pour générer le service de documentation de Javadoc avec JAX-WS?
Je suis en espérant qu'une extension d'un certain type sont disponibles ci (même si je suppose que mon espoir est bêtement optimiste).
/**
* <p>
* Gets the {@link ResultObject} given the identifier. The following
* fields are not available for some users and will contain a null value:
* </p>
*
* <ul>
* <li>{@code resultObject.comment}</li>
* <li>{@code resultObject.anotherObject.actionById}</li>
* <li>{@code resultObject.anotherObject.actionByName}</li>
* </ul>
*
* <p>
* The {@code daysInPurgatory} value will be {@code -1} when not
* applicable
* </p>
*
* @param requestUser
* the user initiating the request
* @param identifier
* the id of the ResultObject
* @return the {@link ResultObject} or {@code null} if none exists
* @throws SomeException
* if the {@code identifier} is {@code null}
*/
@WebMethod
@WebResult(name = "resultObject")
public ResultObject getResultObjectById(
@WebParam(name = "RequestUser", header = true, partName = "RequestUser") final String requestUser,
@WebParam(name = "identifier") final Long identifier)
throws SomeException;
Grâce,
LES2
Vous devez vous connecter pour publier un commentaire.
Vous pouvez regarder Énoncer. Il est possible d'utiliser c'est plugin Maven pour générer des fichiers HTML statiques à partir des commentaires Javadoc. Cela fonctionne pour le SAVON (c'est à dire JAX-WS) et de REPOS (c'est à dire de JAX-RS) de points de terminaison.
Intéressant, se lit comme suit:
Production Exemples:
Vous n'êtes pas le seul à chercher un moyen pour générer le service de la documentation (voir la La génération WSDL documentation à partir de la Javadoc thread), mais, autant que je sache, il n'y a pas de standard JAX-WS façon de le faire.
Maintenant, peut-être avoir un coup d'oeil à JBoss propriétaire d'annotation
@Documentation
mentionné dans JBWS-1850 qui génèrejaxws:binding
artefacts décrits dans la section 2.9 Javadoc De Personnalisation lors de l'utilisation de Java->WSDL approche. Ce n'est pas exactement ce que vous avez demandé, mais il peut vous donner quelques idées.En tout cas, je pense qu'il faudrait fournir votre propre
WSDLGeneratorExtension
d'étendrewsgen
et de générer de l'souhaité WSDL.Dans un projet, nous avons publié beaucoup de fichiers wsdl. Pour chaque Service Web, nous avons exposé un WS méthode "getDocumentationURL()". Cette méthode fournit un lien vers la JavaDoc généré à partir de la SEI. La JavaDoc est place sur un intranet accessible à l'server.