Convenciones de Java: Buenas Prácticas para Escribir Código
Las convenciones de codificación en Java son un conjunto de normas establecidas para
mejorar la legibilidad, mantenibilidad y eficiencia del código. Seguir estas prácticas facilita
la colaboración entre desarrolladores y evita errores comunes.
Principales Convenciones de Java
1. Nomenclatura de clase
Las clases deben nombrarse en PascalCase, iniciando cada palabra con mayúscula.
Ejemplo: MiClaseEjemplo
2. Nomenclatura de Métodos
Los nombres de los métodos deben escribirse en camelCase, comenzando con minúscula y
sin espacios.
Ejemplo: obtenerNombreUsuario()
3. Nomenclatura de Variables
Las variables deben seguir camelCase, con nombres descriptivos y sin abreviaturas.
Ejemplo: totalVentasMensuales
4. Nomenclatura de Constantes
Las constantes deben escribirse en mayúsculas separadas por guiones bajos
(SNAKE_CASE).
Ejemplo: PI_VALOR = 3.1416
5. Uso de Sangría y Espaciado
Se recomienda una indentación de 4 espacios para mejorar la lectura del código.
Correcto.-
if (condicion) {
ejecutarAccion();
}
6. Uso de Comentarios
Utilizar comentarios descriptivos para explicar el propósito del código.
Ejemplo:
// Calcula el área del círculo
double area = [Link] * radio * radio;
7. Estructura de Código
Los bloques de código deben abrir y cerrar llaves {} correctamente y sin omitirlas.
8. Uso de Excepciones
Manejar adecuadamente las excepciones con try-catch y evitar throws Exception de
forma genérica.
9. Uso de final en Variables Inmutables
Si una variable no cambia después de ser inicializada, debe declararse como final.
Ejemplo: final double TASA_INTERES = 5.5;
10. Organización de Paquetes
Los paquetes deben nombrarse en minúsculas y reflejar la estructura del proyecto.
Ejemplo: [Link]
Referencias Bibliográficas
Oracle. (2024). Java SE Documentation. Oracle. Recuperado de
[Link]