Informática

Guía del desarrollador: Nomenclatura. I.

15 marzo, 2017
guia del desarrollador

Con este post pretendo iniciar una serie de recomendaciones, no solo mías sino también de grandes gurús del mundo de la programación. Todos estos consejos aparecen recopilados en el excelente libro “Clean code” de Robert C. Martin. Así que, sin más dilación, abrimos el telón…

Primera ley de la nomenclatura: Usa nombres con sentido.

Cuando escribimos código estamos también contando una historia. Debemos tener claro que cada palabra cuenta, cada palabra debe aportar información y sentido. Establecer nombres de variables que no representen el valor que almacenan no tiene sentido.

Primer corolario: Si una variable necesita comentario, el nombre es incorrecto.

Debemos tener claro que “no nos van a cobrar por cada letra que escribamos en el nombre de una variable” y tampoco va a afectar al rendimiento de nuestra aplicación así que, establece nombres apropiados.

int d; // tiempo transcurrido en días.

int elapsedTimeInDays;

Como se observa, la información es similar, pero gracias al nombre de la variable seremos conscientes en todo momento de lo que representa esa variable.

Segundo corolario: Si un método no expresa su función, la nomenclatura es incorrecta.

Cuanto mayor es el uso de una nomenclatura incorrecta, mucho más complejo es entender ese código.

 

Una función o procedimiento escrito de esta manera plantea más incógnitas de las que resuelve, por lo tanto, deberemos revisarlo: ¿Qué es exactamente lo que hace? ¿A qué corresponde “theList” ? ¿Cuál es el motivo por el que se almacenan estos valores en esas posiciones?…

Con un cambio en los nombres pero no en la lógica ya se observa una mejor. Usar variables en lugar de números enteros facilita la lectura del código y aporta mucha más información. Pero aún podríamos clarificar el código creando nuestras propias clases y métodos convirtiendo nuestro código en uno mucho más legible.

Con el desarrollo de la clase Cell y los métodos isEmpty(), que comprobará que la celda está vacía, y isNextTo(Cell cell), que comprobará que se encuentra en diagonal en un margen de una celda, simplificamos el código y lo acercamos al lenguaje natural.

Recuerda: ¡La nomenclatura importa!


SEAS Estudios Superiores Abiertos. Solicita información.Si quieres ampliar tus conocimientos de programación, SEAS imparte mucha formación relacionada, como por ejemplo el Máster en Desarrollo de Aplicaciones Multiplataforma, con el que podrás aprender a gestionar y desarrollar software para escritorio, web y móvil.

Puedes compartir este artículo en:

    Deja un comentario

    Información básica acerca de cómo protegemos tus datos conforme al Reglamento General de Protección de Datos (Reglamento UE 2016/679) y en la Ley Orgánica 3/2018, de 5 de diciembre, de Protección de Datos Personales y garantía de los derechos digitales

    De conformidad con lo establecido en el Reglamento General de Protección de Datos, te informamos de:

    - Quien es el responsable del tratamiento: SEAS, Estudios Superiores Abiertos S.A.U con NIF A-50973098, dirección en C/ Violeta Parra nº 9 – 50015 Zaragoza y teléfono 976.700.660.

    - Cuál es el fin del tratamiento: Gestión y control de los comentarios del blog de SEAS. 

    - En que basamos la legitimación: En tu consentimiento.

    - La comunicación de los datos: No se comunicarán tus datos a terceros.

    - Los criterios de conservación de los datos: Se conservarán mientras exista interés mutuo para mantener el fin del tratamiento o por obligación legal. Cuando dejen de ser necesarios, procederemos a su destrucción.

    - Los derechos que te asisten: (i) Derecho de acceso, rectificación, portabilidad y supresión de sus datos y a la limitación u oposición al tratamiento, (ii) derecho a retirar el consentimiento en cualquier momento y (iii) derecho a presentar una reclamación ante la autoridad de control (AEPD).

    - Los datos de contacto para ejercer tus derechos: SEAS, Estudios Superiores Abiertos S.A.U. C/ Violeta Parra nº 9 –
    50015 Zaragoza (España) o través de correo electrónico a lopd@estudiosabiertos.com

    - También puedes ponerte en contacto con nuestro Delegado de Protección de Datos en dpd@estudiosabiertos.com

    Información adicional: Puedes consultar la información adicional y detallada sobre nuestra política de privacidad