Convenciones sobre nombres de clases, métodos, interfaces, variables y constantes en java.

En cada lenguaje de programación existen convenciones de algún tipo, en java existen varias, un grupo que posee particular importancia son las conveciones de nombre

En cada lenguaje de programación existen convenciones de algún tipo, en java existen varias, un grupo que posee particular importancia son las conveciones de nombre, aquí podemos encontrar una explicación detallada del tema, pero el resumen es que debemos cumplir con algunos requisitos al estructurar nuestro código, por ejemplo al definir nuestras variables, en este caso algunos de estos requisitos son:

Convenciones para nombrar una variable:

  • Primera letra en minúscula.
  • No pueden comenzar por números (Error: Syntax error on token) .
  • Si está conformada por dos palabras, la primera de estas deberá estar en minúsula y la segunda en mayúscula o ambas separadas por guión bajo (camel case, underscore).
  • Evitar nombres de una sola letra, con excepción de variables temporales(i, j, m, n).
  • No deben comenzar con guión bajo _ o signo dólar $( no es obligatorio, java lo permite).
  • No deben comenzar con caracteres extraños */+- (Error: cannot be resolved to a variable).
  • Poner nombres descriptivos es incluso mejor que comentariar el código( mi criterio).

Ejemplos: animalSalvaje, animal_salvaje

Convenciones para nombrar una clase:

  • Primera letra en mayúsculas.
  • Sustantivos y singular.
  • Si está compuesta por más de una palabra usar pascal case(cada palabra comienza con mayúsculas).
  • Nombre simples y descriptivos.
  • Usar palabras completas, evitar acrónimos y abreviaturas en caso de no ser representativos, por ejemplo URL.

Ejemplos: Animal, AnimalSalvaje

Convenciones para nombrar una interfaz.

  • Aplican las mismas reglas que para las clases
  • En algunos casos se adiciona la letra I al inicio del nombre, no es obligatorio.

Ejemplos: Felino, AnimalMamífero

Convenciones para nombrar un método:

  • Deben comenzar con infinitivos
  • Notación camel case( primera palabra en minúsculas y las siguientes con la primera letra en mayúsculas)
  • Es común asociar el nombre del método con la acción que ejecuta (insertar(), eliminar(), actualizar())
  • Poner nombres descriptivos es incluso mejor que comentariar el código( mi criterio)

Ejemplos: obtenerPago(), armar(), insertarPago().

Convenciones para nombrar constantes:

  • Nombre con todas sus letra en mayúsculas y las palabras separadas por guión bajo.

Ejemplos: URL_ENDPOINT, SERVER_PORT, IP_ADDRESS.

Espero este artículo te fuera útil, nunca dejes de aprender, el cielo es el límite.

1 thought on “Convenciones sobre nombres de clases, métodos, interfaces, variables y constantes en java.

Comments are closed.