On peut maintenant présenter une classe complète qui modélise un registre à décalage à gauche.
En Java, une classe doit être entièrement définie dans un même fichier (ici
Registre.java). Tous
les champs et les méthodes sont définis dans le bloc de déclaration de classe.
class Registre { // bloc de déclaration de classe
/* représente l'état du registre */
int etat = 0;
/** décale à gauche l'état du registre
* @param poidsFaible nouveau bit de poids faible */
void decaleAGauche(int poidsFaible) {
/* L'opérateur << est un décalage de bit à gauche, il est
équivalent à une multiplication par deux. */
this.etat = this.etat << 1 + poidsFaible;
}
/** @return la valeur courante du registre */
int getEtat() {
return this.etat;
}
}
Il est impératif de documenter le code avec des commentaires pertinents. Il y a trois type de
bloc de commentaires. Les commentaires de lignes commencent par
// et terminent à la fin de la ligne.
Les commentaires de bloc commencent par /* et finissent par */. Les commentaires javadoc
commencent par /**, finissent par */ et contiennent des mots clés spéciaux qui permettent de générer
automatiquement une documentation au format HTML.
Les majuscules et les minuscules sont importantes.