Discussion :

[Runhide]

Bonjour,

Lors de mon apprentissage des annotations, j'ai remarqué quelque chose que je n'ai pas encore compris.

En effet la plus part du temps, nous votre mes annotations écris simplement du style:

@MonAnnotation({valeur, valeur})
Public MaClass ...

Mais parfois, notamment dans un mojo maven, je trouve cette syntaxe, une annotation commenté :

/**
* @param args
* @throws JAXBException
*/
Public static void main(...

J'ai essayé de la decommenter et j'ai eu une erreur de build maven.

Pourquoi ce genre d'annotations est mis en /***/ ? Quel est la différence avec ou sans ?

Merci à vous !

[Drowan]

/**
* @param args
* @throws JAXBException
*/

Ce n'est pas des annotations mais de la JavaDoc. Une façon de documenter/commenter ton code de manière à pouvoir générer facilement de la documentation.
Les @ permette d'indiquer des informations particulières. Par exemple @param est suivi d'un argument de ta fonction. Si tu génère de la documenation cela sera automatiquement indiqué que ta fonction prend tel ou tel paramètres.
Mais cela reste du commentaire, ça n'influe pas sur le code contrairement aux annotations.

Pour en savoir plus : par ici

[Runhide]

Ok donc si j'en crois cette exemple de mojo maven


/**
* Echos an object string to the output screen.
* @goal echo
* @requiresProject false
*/
public class EchoMojo extends AbstractMojo
{
/**
* Any Object to print out.
* @parameter expression="${echo.message}" default-value="Hello World..."
*/

Le commentaire @goal echo me permet dans le shell d'appeler mon plugin comme suit: mvn mon-plug-plugin:echo

Maven se génère une documentation à la manière de java pour la javadoc ? Permettant à maven de mapper l'entré shell :echo au mojo correspondant ?