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
¿Qué hace exactamente la clase?
¿Cómo realiza sus tareas?
¿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