• Home
  • Docker
  • Kubernetes
  • LLMs
  • Java
  • Ubuntu
  • Maven
  • Big Data
  • Archived
Java | Conventions de nommage
  1. Règles de nommage des identificateurs
  2. Conventions de nommage des identificateurs (Java code conventions)
  3. Conventions de nommage des propriétés JavaBeans (JavaBeans Property naming standards)
  4. Règles de création des fichiers source Java

  1. Règles de nommage des identificateurs
    Un identificateur est un nom qui désigne un type, une variable, ou une méthode.
    • La première lettre du nom de l'identificateur doit être:
      • une lettre ([A-Z|a-z]|unicode character),
      • le caractère monétaire ($),
      • ou le caractère de soulignement (_).

      Exemple de noms des variables :


    • La première lettre du nom de l'identificateur peut être suivie par:
      • une combinaison de lettres,
      • de chiffres,
      • du caractère monétaire ($),
      • et du caractère de soulignement (_).

      Exemple de noms des variables :

    • Les noms des identificateurs ne peuvent pas contenir des espaces ou les symboles "+" ou "©"

    • Les noms des identificateurs ne peuvent pas utiliser les mots clés (Java Keywords) : "public", "static", "void", ...

    • Les noms des identificateurs sont sensibles à la casse (intVar est différent de INTVAR).
  2. Conventions de nommage des identificateurs (Java code conventions)
    • Noms des classes :
      La première lettre de chaque mot composant le nom de la classe doit être en majuscule.
      Les noms des classes doivent être des noms (exemple : GenericServlet).

    • Noms des interfaces :
      La première lettre de chaque mot composant le nom de l'interface doit être en majuscule.
      Les noms des interfaces doivent être des adjectifs (exemple : Serializable).

    • Noms des variables :
      La première lettre doit être en minuscule puis la première lettre de chaque mot composant le nom de la variable doit être en majuscule (exemple : servletName).

    • Noms des méthodes :
      La première lettre doit être en minuscule puis la première lettre de chaque mot composant le nom de la méthode doit être en majuscule (exemple : getServletName).
      Les noms des méthodes doivent avoir la forme verbe-nom.

    • Noms des constantes:
      Le nom d'une constante doit être en majuscule.
      Les mots composant le nom d'une constante doivent être séparés par un caractère de soulignement (exemple : SC_NOT_FOUND).
      La déclaration des constantes doit utiliser les modificateurs public, final et static.
  3. Conventions de nommage des propriétés JavaBeans
    • Les noms des getters (accesseurs) doivent commencer par "get" (exemple : getValue).
      Les propriétés booléennes peuvent avoir des noms des getters qui commencent par "is" (exemple : isValid).

    • Les noms des setters (mutateurs) doivent commencer par "set" (exemple : setValue).

    • La déclaration des getters et des setters doivent utiliser le mot clé public.

    • Le getter ne doit pas avoir des paramètres et le type de retour de la méthode doit correspondre au type de la propriété qu'elle représente PROPERTY_TYPE getPROPERTY_NAME().

    • Le setter doit retourner le type void et doit avoir un paramètre qui correspondre au type de la propriété qu'il représente void setPROPERTY_NAME(PROPERTY_TYPE PROPERTY_NAME).

    Exemple : /general/src/ca/mtitek/javabeans/MyJavaBean.java
  4. Règles de création des fichiers source Java
    • Les fichiers sources Java doivent avoir l'extension .java.

    • Un fichier source ne peut pas avoir plus d'une déclaration de classe avec le mot clé public (classe public).
      Autrement dit, le fichier source peut avoir plusieurs déclarations de classes mais juste une classe peut être public.

    • Si le fichier source contient une seule classe public, alors son nom doit être celui du nom de cette classe.
      Si le fichier source contient plusieurs définitions de classes, alors le nom du fichier doit être celui du nom de la classe public.
      Si le fichier source ne contient aucune classe public, alors le nom du fichier peut être différent des noms des classes de ce fichier.

    • Le nom du fichier doit être unique dans un package, ainsi que les noms des classes définies dans chaque fichier.

    • Si le fichier source est créé dans un package, alors le code doit utiliser le mot clé package pour préciser explicitement ce package.
      La déclaration du package doit être la première ligne du code (à l'exception des commentaires et lignes vides).

    • Le code du fichier source peut utiliser le mot clés import pour spécifier les dépendances avec des classes externes.
      Les instructions import doivent être saisies juste après l'instruction package (à l'exception des commentaires et lignes vides).
© 2025  mtitek