Como escribir código mantenible - parte 2

Dificultad: Aprendiz

Duración: 10 min

Continuemos con la parte final de como escribir código mantenible.

En el tutorial anterior hable de técnicas para escribir nombres y comentarios fáciles de mantener. Ahora sigamos con el formato del código.

Formato

El formato del código hace que la organización lógica sobresalte. Esto favorece nuestro entendimiento (para cuando ya no nos acordemos que hicimos - porque pasa...) y el entendimiento de otros desarrolladores.

Algunas técnicas:

• Utiliza una cantidad fija de espacios para el indentado. Yo recomiendo seguir la convención de cada lenguaje: en Javascript se suelen usar 2 espacios; en Java, C#, Objectice-C, Swift (si, ya lo he revisado), se suele usar 4 espacios.
• Alinea las llaves con los bloques de código que cierran, y utiliza la convención del lenguaje: en Javascript abren a la derecha, en C# en la linea de abajo. Ej:

• Establece un número de lineas y columnas que el código o comentarios puede tener para evitar tener que hacer scroll para leer. Se suelen usar métodos de aproximadamente 30 lineas de largo y no más anchos de la columna 80.
• Deja una linea en blanco antes y después de cada operador, mejora la visibilidad:

• Utiliza el else solo cuando sea necesario. Si no quedan más opciones que evaluar luego del if, puedes retornar de una vez (Ver ejemplo de código anterior).
• Deja un espacio después de cada coma.

Crea párrafos de código dejando lineas en blanco, así podrás proporcionar mayor entendimiento para lineas que se relacionan entre si:

Evita escribir más de una sentencia por línea (en lo posible).

• Divide el código lógicamente en distintos archivos. (Ej: cada clase en archivos separados).
• No utilices números en forma literal usa variables o constantes para darle un significado.

Utiliza switch cuando aplique, evita esos if, tras if, tras if, "n" cantidad de veces.

Algunas consideraciones especiales

Utilízalas sabiamente cuando apliquen:

• Utiliza variables del tamaño que sean necesarias. En c# a veces un short (entero de 16 bits) puede ser suficiente y no necesitar un int (entero de 32 bits)
• Mantén el alcance de una variable lo más corto posible para evitar confusiones.
• Utiliza funciones y variables para un solo propósito.
• Utiliza solo la cantidad de atributos públicos en una clase como sean necesarios, es mejor crear atributos privados para favorecer al encapsulamiento.
• Evita escribir código SQL del lado de la aplicación, utiliza un ORM.
• Evita hacer casting de objetos y cuando sea necesario y no trivial comenta las razones.
• Captura los errores usando try-catch-finally. Ayudará a hacer más robusta tu aplicación.
• Utiliza logs, te ayudarán a identificar errores.
• Crea tus propias excepciones heredando de "Exception" o su subclase que mejor aplique (SQLException, IndexOutOfRangeException) a tu caso.
• Evita las variables globales en lo posible.

Conclusión

Utilizar técnicas consistentes y buenas prácticas de programación mejoran nuestro código y por tanto la mantenibilidad, entendimiento, extensión y calidad de nuestra aplicación.

Hasta la próxima.

Compártela:

Please enable JavaScript to view the comments powered by Disqus.comments powered by