martes, 1 de octubre de 2013

Estándares / convenciones al programar en Java ? ? ? ?

De chismosa en código ajeno, noté que el nombre de un paquete iniciaba con mayúscula, lo cual a simple vista me pareció erróneo ... pero... quién dice qué esto es correcto o no?

Recordando en todos mis días de escuela nunca nadie me lo dijo... pero entonces.. porqué los nombres de las clases inician con mayúsculas? ó los nombres de los métodos con minúsculas?...

Bueno muchos lo hemos aprendido empíricamente, pero existe un documento que contiene todas estas indicaciones... hago un resumen de las reglas que considero todos debemos saber.

  • Archivos
    • Evitar archivos muy grandes, para mi gusto archivos muy grandes son de más de 1500 líneas pero en el estándar indican que son más de 2000 líneas.
  • Código
    • Usar indentación (4 espacios o un tabulador)
    • Los nombres de las clases comienzan con mayúsculas y generalmente son sustantivos
    • Los nombres de los métodos comienzan con minúscula y utilizan el estilo "camelCase", normalmente son verbos.
    • Si se declara algún tipo de constantes, sus nombres se escriben en mayúsculas


Referencia bibliográfica http://www.oracle.com/

Documento completo sobre las convenciones

2 comentarios:

  1. Respuestas
    1. Respecto al nombramiento de los "package" en el documento de oracle mencionan:

      " 9 - Naming Conventions
      Packages
      The prefix of a unique package name is always written in all-lowercase ASCII letters and should be one of the top-level domain names, currently com, edu, gov, mil, net, org, or one of the English two-letter codes identifying countries as specified in ISO Standard 3166, 1981.

      Subsequent components of the package name vary according to an organization's own internal naming conventions. Such conventions might specify that certain directory name components be division, department, project, machine, or login names."
      Referencia

      Eliminar