Java - Meilleures pratiques

Lorsqu'on commence à apprendre un nouveau langage de programmation, il est important de connaître ses meilleures pratiques, car un bon programme n'est pas seulement un algorithme bien exécuté, mais aussi le Documentation Et le chemin dans quel est le code écrit ils sont importants.
Si nous documentons bien, nous pourrons bien laisser les programmeurs qui revoient notre code afin qu'ils comprennent ce que nous avons fait et les raisons, de cette façon la continuité des projets est meilleure; également un code lisible nous aide à déboguer les erreurs et fait que nous pouvons perdre moins de temps sur différents facteurs que d'atteindre nos objectifs.
Convention de nommage
La convention de nommage est extrêmement importante, avec cela nous pouvons identifier en un coup d'œil variables de classe et de méthode.
Le premier aspect important est le style d'écriture des noms, quand on a des noms de variables nous devons utiliser des minuscules et quand on a des constantes doit être en majuscule, Voyons voir:

 int [b] diviseur [/ b] = 5; double final [b] PI [/ b] = 3,14; 

Ainsi, lorsque nous verrons PI, nous saurons que c'est une constante, par contre si nous voyons un diviseur, nous savons que c'est une variable et si nous devons le manipuler, nous pouvons le faire en sachant que nous n'affecterons pas le programme.
Si nous avons des noms de plusieurs mots, nous devons utiliser le méthode de cas de chameau c'est-à-dire mettre en majuscule la première lettre des mots suivants du nom.
Regardons les exemples suivants :

Dans l'image, nous pouvons voir comment nous définissons une classe avec plusieurs mots, dans le cas des classes, jusqu'au premier mot doit commencer par des lettres majuscules.
Espace et identification
Lorsque nous écrivons du code imbriqué, par exemple des classes et leurs méthodes, celles-ci doivent aller dentelé, c'est-à-dire qu'ils doivent être séparés par une languette pour indiquer leur imbrication, ce qui facilite l'identification de quelles pièces appartiennent à quelles.
Il faut aussi faire attention à l'espace entre les différents éléments qui composent les déclarations, car une mauvaise utilisation peut générer un problème de lisibilité.
Voyons un exemple de chaque chose, par exemple l'espace entre les éléments, dans l'image nous voyons la forme correcte dans la partie inférieure, où chaque élément est séparé par un espace, cependant dans la partie supérieure dans le mauvais sens nous voyons qu'il n'y a pas d'uniformité dans les espaces.

Dans le graphique suivant, nous voyons comment faire un bloc avec un bonne échancrure, nous pouvons remarquer comment chaque élément est imbriqué et séparé par un saut de ligne.

Documentation
Comme nous l'avons mentionné au début, le Documentation nous permet d'indiquer nos commentaires au sein du code, pour cela nous utiliserons les outils d'écriture commentaires en Java; Par exemple, si nous voulons documenter chaque étape que nous effectuons dans le code, nous pouvons utiliser // pour générer une ligne qui sera omise par le compilateur mais qui pourra être lue à partir du fichier source.
Si au début du cours on fait un bloc de commentaire en utilisant :

 /** /* /* **/ 

Ce que nous écrivons dans ce bloc peut être exporté et utilisé pour générer des documents HTML avec les outils de documentation Java. Nous devons donc utiliser chaque cas en conséquence.
A la fin du tutoriel, nous avons une notion plus large des meilleures pratiques lors de la création de programmes Java afin de collaborer avec le développement au niveau fonctionnel mais aller un peu au-delà de nos responsabilités en tant que bon développeur.Avez-vous aimé et aidé ce tutoriel ?Vous pouvez récompenser l'auteur en appuyant sur ce bouton pour lui donner un point positif