2013-10-08 1 views
4

Comment obtenir le champ de description sur un type rempli dans la documentation enunciate générée?Comment documenter un type dans enunciate?

Nous générons des classes à partir de jaxb en utilisant jaxb2-maven-plugin. Peu importe la façon dont je le document un élément soit en utilisant le <xsd:documentation></xsd:documentation> ou

<xsd:appinfo> 
    <jaxb:class> 
    <jaxb:javadoc> 
     </jaxb:javadoc> 
    </jaxb:class> 
</xsd:appinfo> 

il est écrasé dans les classes générées. Puis-je en quelque sorte désactiver le javadoc généré automatiquement à partir de ce plugin? Ou qu'est-ce que l'énonciation veut vraiment que je fasse, laissez-moi documenter sur le terrain?

Remarque que le commentaire que j'écris au niveau classe apparaît dans la classe générée et dans la documentation générée énoncée.

Nous utilisons énoncer (v.1.26.2) et jaxb2-maven-plugin (v. 1.5)

Répondre

0

Vous vous demandez comment s'Énoncer à pas utiliser le Javadocs de la classe? L'une des solutions possibles consiste à compiler les classes générées par JAXB et à exécuter Enunciate sur les classes compilées au lieu du code source.

+0

Non, je me demande comment obtenir enunciate pour afficher les commentaires javadoc pour les getters et setter pour les variables d'instance (éléments dans xsd). Dans la documentation générée, il y a une table pour eux indiquant des choses comme type, facultatif, mais les lignes où le commentaire attendu doit être affiché sont * NEVER * peuplé. –

Questions connexes