Comment pour ponctuer votre code java

En anglais, la ponctuation est vital. Ponctuation est également importante dans un programme Java. L'utilisation des accolades, des points-virgules, parenthèses, guillemets, et des périodes de Java raconte comment lire le code et rend le code plus facile pour les humains de comprendre.

Cette liste expose quelques-unes des règles de ponctuation de Java:

• Joignez corps d'une classe dans une paire d'accolades.

  Dans cette annonce, le MyFirstJavaClass corps est entouré d'accolades.

  package classe MyFirstJavaClass de org.allyourcode.myfirstproject public {/ ***param args static void main (String [] args) * / public {javax.swing.JOptionPane.showMessageDialog (null, "Bonjour") -}}

  Le placement d'une accolade (à la fin d'une ligne, au début d'une ligne, ou sur une ligne de son propre) est sans importance. Le seul aspect important de la mise en place est la cohérence. Le placement cohérente des accolades à travers le code rend le code plus facile pour vous de comprendre. Et quand vous comprenez votre propre code, vous écrire beaucoup mieux code.

  Lorsque vous composez un programme, Eclipse peut automatiquement réorganiser le code de sorte que le placement des accolades (et d'autres éléments de programme) est cohérent. Pour y arriver, cliquez sur la souris n'importe où à l'intérieur de l'éditeur et choisissez Format-Source.

• Joindre un corps de la méthode dans une paire d'accolades.

  
  
  
  
  

  Dans la liste, le principal le corps de la méthode est entouré d'accolades.

• Une déclaration Java se termine par un point-virgule.

  Par exemple, dans la liste, l'appel à la showMessageDialog méthode se termine par un point-virgule.

• Une déclaration se termine par un point-virgule.

  Encore une fois dans la liste, la première ligne de code (contenant la déclaration de forfait) se termine par un point-virgule.

• En dépit de ces deux règles précédentes, ne pas placer un point-virgule immédiatement après une accolade fermante (}).

  La liste se termine avec deux fermeture des accolades, et aucun de ces accolades est suivie par un point-virgule.

• Utilisez des parenthèses pour entourer les paramètres d'une méthode, et d'utiliser des virgules pour séparer les paramètres.

  Dans la liste (où d'autre?) L'appel à la showMessageDialog méthode a deux paramètres: nul et "Bonjour". La déclaration de la principal méthode a un seul paramètre: args.

• Utilisez des guillemets doubles (“ ”) pour désigner des chaînes de caractères.

  Dans la liste, le "Bonjour" paramètre indique au showMessageDialog Procédé pour afficher des caractères Bonjour 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.swing package contient le JOptionPane classe, qui à son tour contient la showMessageDialog Procédé. Ainsi javax.swing.JOptionPane.showMessageDialog est le nom complet de la méthode.

• Utilisez points dans un nom de paquet.

  Les points dans un nom de paquet sont un peu trompeur. Un nom de package allusion à utilisations pour le code à l'intérieur du paquet. Mais un nom de paquet ne classe pas les paquets dans des sous-paquetages et sous-sous-paquetages.

  Par exemple, l'API Java possède les paquets javax.swing, javax.security.auth, javax.security.auth.login, Et plein d'autres. Le mot javax seul ne signifie rien, et la javax.security.auth.login colis ne soit pas à l'intérieur du javax.security.auth package.

  La conséquence la plus flagrante des points de nom d'un paquet est de déterminer l'emplacement d'un fichier sur le disque dur. Par exemple, en raison de son nom de paquet, le code dans la liste doit être dans un dossier nommé myfirstproject, qui doit être dans un dossier nommé allyourcode, qui à son tour doit être dans un dossier nommé org, comme illustré sur cette figure.