naming en Java

Donnez à un nombre un nom clair pour réutiliser la même orthographe. Dans Yard.java, écrivez int ticketCount = 4; et imprimez ticketCount. Compilez avec javac Yard.java et lancez java Yard. L’écran doit montrer 4. Une seconde démo range 4 sous ticketCount et 9 sous TicketCount, puis imprime les deux noms. L’écran doit montrer 4, puis 9, parce que ces orthographes sont des noms différents en Java. Laissez les règles de formatting pour la page suivante — cette leçon est le naming exact, pas le style d’espacement.

Rangez un nom clair

La page Javadoc a étiqueté le contrat d’une méthode. Cette page choisit des noms lisibles pour les valeurs que vous rangez. Ouvrez Yard.java. Gardez le nom de classe public Yard. Supprimez les démos add restantes si elles enterrent l’histoire de naming, les étiquettes println de debug qui ne chassent qu’une mauvaise somme, les démos equals restantes, et tout Scanner clavier. Le programme ne doit pas attendre la frappe. Aucune ligne import n’est requise.
Dans Yard.main, écrivez un nom en camelCase — commencez par une lettre minuscule, puis mettez en majuscule les mots suivants dans le même nom :
int ticketCount = 4;
System.out.println(ticketCount);
L’orthographe ticketCount est le nom. La valeur 4 siège sous cette orthographe. Quand vous imprimez le nom, Java cherche cette orthographe exacte et écrit le nombre rangé.

Depuis le dossier qui contient Yard.java, lancez javac Yard.java. Quand les parenthèses, accolades et points-virgules correspondent, javac n’écrit aucune ligne de son cru. Puis lancez java Yard — pas java Yard.java. Enlevez la fin .java de la commande d’exécution. Gardez une classe public dans le fichier pour que le nom corresponde à Yard.
L’écran montre 4. Parcourez l’exécution une fois. Java démarre à Yard.main. La première ligne range quatre sous ticketCount. La ligne d’impression cherche ticketCount et écrit 4. Aucun second nom n’apparaît dans cette première démo. La recherche est exacte. TicketCount n’est pas le nom que vous avez rangé dans ce premier programme.
Dites la règle débutante en regardant l’écran : choisissez une orthographe, rangez la valeur, demandez la même orthographe. N’inventez pas de longs cours de formatting sur cette page. Le formatting attend la leçon suivante.
Si vous voyez encore 12 d’une démo Javadoc add, passez au fichier d’enseignement naming et relancez java Yard. Si vous écrivez ticket count = 4 avec un espace au milieu, ce n’est pas un seul nom. Gardez la forme camelCase comme un seul mot.

Une majuscule crée un second nom

Un second programme garde ticketCount et ajoute un autre nom qui ne diffère que par une lettre majuscule. Java traite ticketCount et TicketCount comme deux noms. Rangez 4 sous la première orthographe et 9 sous la seconde, puis imprimez les deux.

Compilez avec javac Yard.java, puis lancez java Yard. L’écran montre 4, puis 9. La première impression lit ticketCount. La seconde impression lit TicketCount. Ce ne sont pas la même recherche. Changer la casse d’une lettre crée un nouveau nom. Les débutants s’attendent souvent à ce que la seconde orthographe mette à jour la première. Sur cette page, ce n’est pas le cas. Chaque orthographe garde sa propre valeur.
Relisez les deux déclarations une fois. Le nom de classe Yard reste en PascalCase avec une majuscule en tête — cela correspond au nom de fichier. Les noms de valeurs dans main montrent le contraste : camelCase ticketCount pour une variable ordinaire, et un TicketCount volontairement différent seulement pour prouver la sensibilité à la casse. Dans le code du quotidien, vous préférez encore camelCase pour les variables ; le second nom existe ici comme contraste pédagogique, pas comme un style à copier partout.
Si des démos Javadoc restantes restent à côté, gardez-les comme histoire. Pour cette leçon, lancez le fichier d’enseignement naming pour que l’écran montre des comptes nommés, pas seulement un résultat add documenté. Si javac se plaint de classes public en double, gardez seulement Yard public.

Des noms que vous ne devez pas commencer ainsi

Un nom ne doit pas commencer par un chiffre. Une ligne comme int 4tickets = 4; n’est pas dans ces démos exprès. Cette forme est illégale en Java, donc javac la refuse avant que le programme puisse tourner. Gardez le premier caractère une lettre ou un underscore dans le travail réel. Les démos qui marchent sur cette page commencent par t ou T.
Un espace dans un nom échoue aussi. ticket count est deux jetons, pas un nom. CamelCase joint les mots sans espaces : ticketCount. Gardez cette habitude quand vous nommez la prochaine variable vous-même.
Vous n’avez pas besoin d’un tableau sur cette page. Les deux écrans sont la carte : un nom imprime 4 ; deux noms capitalisés différemment impriment 4 puis 9.

Comparé aux étiquettes Javadoc

Sur la page Javadoc, @param et @return ont étiqueté le contrat d’une méthode. Sur cette page, l’orthographe de la variable est le contrat pour retrouver la valeur. Vous compilez encore Yard.java et lancez java Yard. La nouvelle habitude est de choisir un nom camelCase clair et de respecter la casse exacte quand vous le relisez.
Les commentaires Javadoc ne remplacent pas de bons noms. Un nom clair et un commentaire clair peuvent siéger ensemble plus tard. Cette leçon isole le naming pour que l’écran prouve la recherche sensible à la casse sans mélanger les balises de documentation dans la démo.
Si un fichier add restant est encore ouvert, vous pouvez ne voir que 12. Passez au fichier naming pour que main range et imprime ticketCount. Gardez les guides de style de formatting hors de cette page. Gardez la saisie clavier hors de cette page.

Avant le formatting

Vous pouvez ranger ticketCount comme 4 et voir 4 à l’écran. Vous pouvez ajouter TicketCount comme 9 et voir 4 puis 9. Compilez Yard.java et lancez java Yard pour chaque démo conservée à tour de rôle. L’orthographe a décidé quelle valeur apparaissait. La page suivante est le formatting, où vous rangez comment le code est espacé et arrangé pour les lecteurs.
Gardez la démo à un seul nom pour une première impression claire. Gardez la démo à deux noms pour un contraste de casse clair. Gardez les fichiers formatting hors de cette page jusqu’à cette leçon. Ces trois habitudes sont le point de contrôle avant d’avancer. Quand la même orthographe renvoie la valeur que vous avez rangée — et qu’une majuscule différente ne vole pas cette valeur — le naming a fait son travail pour cette leçon et vous êtes prêt pour le sujet suivant sur le formatting.
Un dernier passage dans le dossier : un Yard public, des noms clairs dans main, pas d’attente clavier, pas de règles de formatting forcées. Lancez javac Yard.java et java Yard une fois de plus sur la démo ouverte. Si l’écran correspond encore aux noms que vous avez tapés, la leçon de naming est solide et le cours peut passer au formatting à la page suivante. Préférez une seule idée de naming par exécution pour que chaque écran enseigne un contraste.