Les commentaires facilitent la compréhension du code source.
Au début d'une section de code, la présence d'un commentaire permet de clarifier le rôle de cette partie.
Le commentaire est ignoré lors de l'étape de compilation.
Trois manières de créer des commentaires :
sur une seule ligne en la précédant par //
sur une ou plusieurs lignes entre /* et */
Entre /** et */, on peut indiquer du texte mais aussi des tags HTML
Les commentaires commençant par /** sont des commentaires de documentation. Il existe en effet un outil Javadoc qui extrait ces commentaires pour générer une documentation html.
Exemple :
/* Commentaires
sur plusieurs
lignes */
// Commentaire sur une seule ligne