Envoyé par
fmarot
Ah ben ce thread tombe bien, merci _Skip
Des collegues ont récemment introduit Lombock sur une partie du projet: une API qui doit etre rendue publique. Or, qui dit "publique" dit "Javadoc" ! Mais commet créer la javadoc avec Lombock ?!
Dans le code, les champs annotés @getter et @setter étaient documentés. Mais lors de la génération de la Javadoc, les méthodes getXXX et setXXX n'apparaissaient pas. Normal...
On a alors généré le code source délomboké (en utilisant l'outil "delombok"). Les méthodes getXXX et setXXX apparaissent bien dans la javadoc apres ca, mais pas les commentaires positionnés sur les champs privés !
Là, 2 solutions:
- soit générer la javadoc paramétrée pour afficher les champs "private" mais pour une API publique ca craint...
- soit inclure en début de la javadoc public d'une classe un tableau (issu de la javadoc générée en affichant les champs privés) récapitulant les champs privés annotés get/set avec leur documentation.
C'est cette derniere solution qui a été retenue. Couplée à un processus manuel, je vous raconte pas comme on va s'amuser si l'API change souvent !
Avez vous une solution à la génération de la javadoc des champs annotés avec Lombok ?
Partager