Vidéo: Readable Code | Computer Programming | Khan Academy 2024
En anglais, la ponctuation est vitale. La ponctuation est également importante dans un programme Java. L'utilisation d'accolades, de points-virgules, de parenthèses, de doubles guillemets et de points indique à Java comment lire le code et facilite la compréhension du code.
Cette liste présente quelques-unes des règles de ponctuation de Java:
-
Entourez un corps de classe dans une paire d'accolades.
Dans cette liste, le corps MyFirstJavaClass est entouré d'accolades.
paquet org. allyourcode. myfirstproject; classe publique MyFirstJavaClass {/ ** * @param args * / public static void principal (String [] args) {javax. balançoire. JOptionPane. showMessageDialog (null, "Hello");}}
Le placement d'une accolade (à la fin d'une ligne, au début d'une ligne ou sur une ligne) n'est pas important. Le seul aspect important du placement est la cohérence. Le positionnement cohérent des accolades dans tout le code rend le code plus facile à comprendre pour vous. Et quand vous comprenez votre propre code, vous écrivez un code bien meilleur.
Lorsque vous composez un programme, Eclipse peut réorganiser automatiquement le code afin que le placement des accolades (et des autres éléments du programme) soit cohérent. Pour y arriver, cliquez avec la souris n'importe où dans l'éditeur et choisissez Source → Format.
-
Entourez un corps de méthode dans une paire d'accolades.
Dans la liste, le corps de la méthode principale est entouré d'accolades.
-
Une instruction Java se termine par un point-virgule.
Par exemple, dans la liste, l'appel à la méthode showMessageDialog se termine par un point-virgule.
-
Une déclaration se termine par un point-virgule.
Dans la liste, la première ligne de code (contenant la déclaration du paquet) se termine par un point-virgule.
-
Malgré les deux règles précédentes, ne placez pas de point-virgule immédiatement après une accolade fermante (}).
La liste se termine par deux accolades de fermeture, et aucune de ces accolades n'est suivie d'un point-virgule.
-
Utilisez des parenthèses pour entourer les paramètres d'une méthode et utilisez des virgules pour séparer les paramètres.
Dans la liste (où else?), L'appel de la méthode showMessageDialog a deux paramètres: null et "Hello". La déclaration de la méthode principale n'a qu'un seul paramètre: args.
-
Utilisez des guillemets doubles ("") pour indiquer des chaînes de caractères.
Dans la liste, le paramètre "Hello" indique à la méthode showMessageDialog d'afficher les caractères Hello sur la face de la boîte de dialogue.
-
Utilisez des points pour séparer les parties d'un nom qualifié.
Dans l'API Java, le javax. Le package swing contient la classe JOptionPane, qui à son tour contient la méthode showMessageDialog.Alors javax. balançoire. JOptionPane. showMessageDialog est le nom complet de la méthode.
-
Utilisez des points dans un nom de package.
Les points dans un nom de paquet sont un peu trompeurs. Un nom de paquet fait allusion aux utilisations du code dans le paquet. Mais un nom de package ne classe pas les packages en sous-packages et sous-sous-packages.
Par exemple, l'API Java a les paquets javax. swing, javax. Sécurité. auth, javax. Sécurité. auth. connexion, et beaucoup d'autres. Le mot javax seul ne signifie rien, et le javax. Sécurité. auth. le paquet de connexion n'est pas dans le javax. Sécurité. paquet d'authentification
La conséquence la plus flagrante des points d'un nom de paquet est de déterminer l'emplacement d'un fichier sur le disque dur. Par exemple, en raison de son nom de package, le code de la liste doit se trouver dans un dossier nommé myfirstproject, qui doit se trouver dans un dossier nommé allyourcode, qui doit à son tour se trouver dans un dossier nommé org, comme illustré dans cette figure.