Nomenclatura Para Programar

Nomenclatura para programar en Java


Versión 1.0



Tabla de Contenidos
1. Introducción 3
2. Nomenclaturas 3
2.1. Clases 3
2.3. Atributos 4
2.5. Métodos 5

Plan de Desarrollo de SoftwareJava

1.Introducción

El presente documento tiene como objetivo definir un estándar para utilizar nombres descriptivos al momento de desarrollar, y así lograr un diseño claro, flexible y robusto. Para ello sebrindar una serie de reglas las cuales debemos seguir al momento de codificar un proyecto.
2. Nomenclaturas

2.1. Clases

Para nombrar a las clases siempre usar sustantivos, por ejemplo: Autor.

Elnombre de la clase debe:
Estar en singular.
Comenzar con mayúscula.
No estar abreviado.
Ser representativo del objeto que representara, en español.
En caso de estar compuesto por más de una palabra, lasmismas se concatenaran y cada una de ellas comenzará con mayúsculas.
Cada clase debe llenar un encabezado con los datos: Fecha de elaboración, Autor, Descripción.

Ejemplo:/***************************************************************
* Fecha de elaboración: 6 de febrero de 2015 *
* Autor: Alejandro Lara San Juan *
* Descripción: Claseabstracta, para crear las clases * * empleado, alumno, cliente. *
****************************************************************/
abstract publicclass Persona{
………….
………….
………….
………….
}









2.2. Constantes

Por convención y para facilitar la comprensión del código no se dejaran valores constantes en los métodos, si no que se declararan comoconstantes.

//De esta forma no se recomienda
public double calcularCostoDePublicacion(Libro libro)
{
return libro.cantidadDePaginas * 0.15;
}

¿De dónde salió el 0.15? ¿Qué representa?

//Serecomienda crear el código de la siguiente forma
private final double COSTO_DE_IMPRESION_POR_PAGINA = 0.15;

public double calcularCostoDePublicacion(Libro libro)
{
return (libro.cantidadDePaginas *...