🚗Nombre Clases

📛 Regla General para Nombres de Clases

  • Debe ser Descriptivo: Utiliza sustantivos o frases sustantivas para nombrar tus clases, indicando claramente el propósito o la entidad que representan.

🚫 Ejemplos de Nombres Genéricos a Evitar

  • Manager, Data, Info, Individual, Processor

    • Son demasiado genéricos y pueden llevar a una sobrecarga de responsabilidades en una sola clase.

🎯 Por Qué Evitar Nombres Genéricos

  • Demasiadas Responsabilidades: Una clase con un nombre genérico tiende a acumular muchas funciones o responsabilidades, lo que dificulta su mantenimiento y comprensión.

  • Difícil de Mantener y Actualizar: Cuantas más tareas se asignen a una clase, más compleja se vuelve, aumentando el riesgo de errores y complicaciones al modificarla.

🔠 Uso de UpperCamelCase

  • Convención Estándar: Los nombres de las clases deben escribirse utilizando UpperCamelCase, facilitando su identificación y lectura.

🤔 Preguntas para Validar el Nombre de una Clase

  1. ¿Qué hace exactamente la clase?

  2. ¿Cómo realiza sus tareas?

  3. ¿Hay algún aspecto específico en su utilización o ubicación dentro del proyecto?

❗ No Confundir Especificidad con Longitud

  • Mal Ejemplo Extremo: SpecialViewingCaseMonsterManagerEventsHandleActivitySingleton

    • Aunque descriptivo, es excesivamente largo y puede ser confuso.

  • Mejor Enfoque: Simplificar a algo más manejable como SpecialMonsterManager, manteniendo la claridad sin sobrecargar el nombre.

💡 Simplificación y Claridad

  • Balance Ideal: Un nombre debe ser lo suficientemente descriptivo para indicar la función principal de la clase sin ser excesivamente largo o complicado.

  • Evita la Saturación: Un nombre demasiado largo puede ser un indicativo de que la clase está intentando hacer demasiado.

Última actualización