Contenido


Convención de denominaciones de Java

Facilite su vida

Comments

Utilice descriptores completos que describan la variable, el campo o la clase de manera adecuada

Desarrolle habilidades de este tema

Este contenido es parte de un knowledge path progresivo para avanzar en sus habilidades. Vea Conviértase en un desarrollador Java

Por ejemplo, nombres de usuario como firstName, grandTotal o CorporateCustomer. Aunque nombres como x1, y1 o fn son fáciles de tipear porque son cortos, no brindan ninguna indicación de lo que representan y consecuentemente resultan en un código difícil de entender, mantener y mejorar.

Utilice terminología aplicable al dominio

Si sus usuarios se refieren a sus clientes como consumidores, utilice el término Customer para la clase, no Client. Muchos desarrolladores cometen el error de crear términos genéricos para conceptos cuando ya existen términos perfectamente utilizables en la industria o dominio.

Utilice mayúsculas y minúsculas para que los nombres sean legibles

Debería utilizar letras minúsculas en general, pero utilice mayúscula en la primera letra de nombres de clase y de interfaz, así como la primera letra de cualquier palabra no inicial.

Utilice abreviaturas con moderación e inteligencia

Esto significa que debería mantener una lista estándar de formas cortas (abreviaturas), elegirlas sabiamente y utilizarlas de manera consistente. Por ejemplo, si desea utilizar una forma corta para la palabra number, utilice nbr, no o num, registre el utilizado (no importa cuál) y utilice únicamente ese.

Evite nombres largos (15 caracteres como máximo es una buena idea)

Aunque el nombre de clase PhysicalOrVirtualProductOrService puede parecer un buen nombre en el momento (de acuerdo, los estoy alargando en este ejemplo), este nombre es simplemente demasiado largo y debería considerar cambiarle el nombre a algo más corto (quizás algo como Offering).

Evite nombres que son demasiado parecidos o que difieren sólo en mayúscula o minúscula

Los nombres de variables persistentObject y persistentObjects no deberían ser utilizados juntos, ni tampoco anSqlDatabase y anSQLDatabase.

Utilice mayúscula en la primera letra de acrónimos estándar

Los nombres tendrán por lo general abreviaturas estándar, como SQL por Standard Query Language. Nombres como sqlDatabase para un atributo o SqlDatabase para una clase son más fáciles de leer que sQLDatabase y SQLDatabase.


Recursos para Descargar


Temas relacionados


Comentarios

Inicie Sesión o Regístrese para agregar comentarios.

static.content.url=http://www.ibm.com/developerworks/js/artrating/
SITE_ID=90
Zone=SOA y servicios web
ArticleID=850777
ArticleTitle=Convención de denominaciones de Java
publish-date=12102012