Introduction

En tant que développeur expérimenté, vous êtes peut-être familier avec les conventions de codage Java. Cependant, la précision et la cohérence sont essentielles pour maintenir une base de code solide et facile à comprendre. Dans cet article, nous allons explorer les règles de codage pour l’indentation, les littéraux, les déclarations de package, les expressions lambda, les fichiers sources Java, la mise en page des instructions et les caractères spéciaux.

Indentation

L’indentation est cruciale pour maintenir une lecture claire du code. Voici les règles à suivre :

• L’indentation doit être faite avec quatre espaces.
• Seuls les espaces sont autorisés pour l’indentation, pas les tabulations.
• Les lignes vides ne doivent pas être indentées.

Exemple

switch (var) {
    case TWO:
        setChoice("two");
        break;
    case THREE:
        setChoice("three");
        break;
    default:
        throw new IllegalArgumentException();
}

Littéraux

Les littéraux sont utilisés pour représenter des valeurs numériques. Voici les règles à suivre :

• Les longs doivent utiliser la lettre majuscule L (par exemple, 5432L).
• Les hexadécimaux doivent utiliser les lettres majuscules A-F (par exemple, 0x123 + 0xABC).

Exemple

long l = 5432L;
int i = 0x123 + 0xABC;
byte b = 0b1010;
float f1 = 1 / 5432f;
double d1 = 1 / 5432d; // ou 1 / 5432.0

Déclarations de package

La déclaration de package doit être à la première ligne du fichier source et ne doit pas être indentée.

Exemple

package com.example.my.package;

Expressions lambda

Les expressions lambda sont utilisées pour représenter des fonctionnalités anonymes. Voici les règles à suivre :

• Les expressions lambda doivent utiliser des paramètres avec des noms significatifs.
• Les expressions lambda doivent être favorisées par rapport aux références de méthode.

Exemple

Runnable r = () -> System.out.println("Hello World");
Supplier<String> c = () -> "Hello World";

Fichiers sources Java

Les fichiers sources Java doivent suivre les règles suivantes :

• Toutes les lignes doivent être terminées par un caractère de saut de ligne (LF, ASCII value 10).
• Il ne doit pas y avoir d’espaces en fin de ligne.
• Le nom du fichier source doit correspondre au nom de la classe qu’il contient, suivi de l’extension .java.

Exemple

// Fichier source MyFile.java
public class MyFile {
    public static void main(String[] args) {
        System.out.println("Hello World");
    }
}

Mise en page des instructions

La mise en page des instructions est cruciale pour maintenir une lecture claire du code. Voici les règles à suivre :

• Les lignes de code ne doivent pas dépasser 80 caractères par ligne.
• Les expressions lambda doivent être favorisées par rapport aux références de méthode.

Exemple

// Bon exemple
Error e = isTypeParam ? Errors.InvalidRepeatableAnnotationNotApplicable(targetContainerType, on) : Errors.InvalidRepeatableAnnotationNotApplicableInContext(targetContainerType);

// Mauvais exemple (trop long)
Error e = isTypeParam ? Errors.InvalidRepeatableAnnotationNotApplicable( targetContainerType, on) int) .collectors(joining(", "));

Caractères spéciaux

Les caractères spéciaux sont utilisés pour représenter des espaces de type non texte. Voici les règles à suivre :

• Seuls les espaces (ASCII value 32) sont autorisés.
• Les autres espaces doivent être écrits en forme d’échappement.

Exemple

String s = "Bonjour, monde !\n";

En suivant ces règles et conventions de codage Java, vous pourrez créer des bases de code solides, faciles à comprendre et à maintenir. Cela est essentiel pour le développement de logiciels robustes et efficaces.

Conclusion

Cet article a abordé les règles de codage pour l’indentation, les littéraux, les déclarations de package, les expressions lambda, les fichiers sources Java, la mise en page des instructions et les caractères spéciaux. En suivant ces règles et conventions de codage Java, vous pouvez créer des bases de code solides, faciles à comprendre et à maintenir.

Prochaines étapes

Pour approfondir vos connaissances sur le sujet, nous recommandons la lecture du livre “Java Notes for Professionals” qui couvre les règles de codage Java en détail. En outre, vous pouvez rejoindre des communautés de développeurs pour discuter avec d’autres programmeurs et partager vos expériences.

En suivant ces étapes et en appliquant les règles de codage Java, vous deviendrez un développeur plus compétent et efficace.