CURSO DE BUENAS PRÁCTICAS EN JAVA

-----------------------------------------------------
1. La identación (la tabulación)
Lo más habitual son dos o cuatro espacios.

2. Saltos de línea
Lo más habitual es que las líneas no excedan de 80 caracteres.

3. Comentarios
Dos tipos distintos:
//
/* */

4. Notación de Camello (CamelCase)

UpperCamelCase: cuando la primera letra de cada una de las palabras es
mayúscula (Ej.: EjemploDeUpperCamelCase).
Utilizada en el nombre de las clases.
lowerCamelCase: igual que la anterior con la excepción de que la primera
letra es minúscula (Ej.: ejemploDeLowerCamelCase).
Utilizada en el nombre de variables y métodos.

5. Notación de Serpiente
No se aplica al nombre de las clases, ya que para ese caso, sólo se utiliza
la notación de Camello.
La notación de serpiente es utilizar un guión bajo entre las palabras que
conforman los nombres de métodos, variables y constantes
(Ej.: ejemplo_de_notacion_de_serpiente).

Recordemos que los nombres de las constantes son completamente en mayúsculas

(Ej.: final int NUMERO_MAXIMO = 10;).

6. Importaciones
Se deben realizar al principio de la clase.

No debemos realizar importaciones tal y como se muestra en el siguiente

ejemplo, ya que importamos, en la mayor parte de los casos,
más de lo que necesitamos, por lo que no se debe hacer (Ej.: import
java.awt.*;).
Siempre debemos ser específicos.

A veces tenemos que utilizar imports concretos, más específicos, dentro de

nuestros métodos. Veamos un ejemplo:

public class main {

public static void main(String[] args) {
java.lang.String dato = new java.lang.String();
}

public class String() {

}
}

Como podemos ver en el ejemplo anterior, tenemos que hacer un import muy
específico dentro del método main(), para diferenciarlo
del nombre de nuestra siguiente clase String(). De esta forma evitamos un
conflicto.

7. Declaración de variables
 Las variables no siempre se pueden colocar justo al inicio de la clase.

Tampoco debemos declarar variables dentro de bucles, a no ser que se desee

hacer así conscientemente, cada vez que se itere el
bucle, se estará creando una nueva instancia de la variable en memoria, cosa
que puede no ser necesaria.
Por ejemplo:
for(int i=0; i<10; i++) {
String dato = "dato";
...
}
Lo que acabamos de ver, no debemos hacerlo así. Mejor hagámoslo así:
String dato = "dato";
for(int i=0; i<10; i++) {
...
}

Las variables del mismo tipo se deben colocar en la misma línea:

String cadena = null;
int numero, edad;
boolean hombre = false;

Los nombres de las variables, métodos y constantes deben ser representativos.

Las variables privadas deben llevar un guión al comienzo de su nombre para

indicar esto mismo, que la variable es privada.
Veámoslo con un ejemplo:
private String _dato;

8. Constantes o variables finales

Las constantes en Java, o mejor dicho, variables finales se deben crear así:
final int NUMERO_MAXIMO = 10;

Como podemos ver:

- Todo en mayúsculas.
- Separación entre palabras con guiones bajos.
- Y definimos su valor con un igual, ya que si no lo hacemos, se entenderá
que el valor de esa variable/constante será
vacío (Ej.: final int NUMERO_MAXIMO;).

9. El idioma
Los nombres de clases, métodos, variables y constantes deben escribirse en
inglés.