Version 3 (modified by aaraujo, 9 years ago) (diff) |
---|
Tabla de Contenido
- Bienvenido a la wiki del Proyecto Murachí
- Metodología de Desarrollo de Software Libre (MDSL) Versión 2.0
- Análisis del Dominio
- Propuesta de Desarrollo del Proyecto
- Plan del Proyecto
- Estándares de Desarrollo del Proyecto
- Especificación de Requerimientos (Funcionalidades)
- 1. Casos de Uso General
- 1.1 Casos de Uso firmar electrónicamente un documento
- 1.2 Casos de Uso verificar la firma electrónica de un documento
- 1.3 Casos de Uso Descargar contenedor
- 1.4 Casos de Uso Descargar documento firmado electrónicamente
- Flujograma de actividades
- Diagrama de secuencia de proceso de firma
- Codificación
- Análisis y Diseño
- Pruebas
- Liberación
Estándares de Desarrollo del Proyecto
Los estándares de desarrollo constituyen las normas o patrones de referencia que se deben implementar en el desarrollo de aplicaciones de software. Entre los estándares de desarrollo más comunes se encuentran: normas de codificación, normas y esquemas de seguridad, estándares de interfaz u/s, entre otros.
[A continuación se deben identificar los estándares de desarrollo que serán implementados en el desarrollo de la aplicación]
Una guía inicial de estándares https://google-styleguide.googlecode.com/svn/trunk/javaguide.html
Organización de archivos
- Un archivo consiste de secciones que deberían estar separadas por líneas en blanco y un comentario opcional que identifica cada sección.
- Se deberían evitar archivos con más de 2000 líneas.
Archivos fuente
Cada archivo fuente contiene una clase pública o interfaz. Cuando clases privadas e interfaces están asociadas con una clase pública, se pueden colocar en el mismo archivo de la clase pública. La clase pública debería ser la primera clase o interfaz en el archivo.
Los archivos fuentes tienen el siguiente orden:
- Comentarios iniciales
- Declaración de paquete y sentencias para importar
- Declaración de clase e interfaces
Esto es:
1 Documentación de la clase 2 Declaración de la clase 3 Comentario de implementación de clase si es necesario 4 Variables de la clase (primero las públicas, luego las protegidas y luego las privadas) 5 Instancia de variables (primero las públicas, luego las protegidas y luego las privadas) 6 Constructor 7 Métodos
Longitud de línea
Evitar líneas de más de 80 caracteres. Documentación de nos más de 70 líneas.
Líneas extendidas
Cuando una expresión no se ajusta a una sola línea, romperla de acuerdo a los siguientes principios:
- romper después de una coma.
- romper antes de un operador.
- alinear la nueva línea con el inicio de la expresión al mismo nivel de la línea anterior.
Declaraciones
- Una declaración por línea
- Colocar la declaración sólo al inicio de bloques (Un bloque es cualquier código que se encuentra dentro de { } .
- Tratar de inicializar las variables locales cuando son declaradas.
- Al declarar clases e interfaces:
- No dejar espacio entre un nombre de método y el paréntesis.
- La llave { que abre aparece al final de la misma línea de la declaración.
- La llave } inicia una línea para cerrar la abierta previamente.
- Los métodos se separan con una línea en blanco.
Una lista más detallada de estándares adicionales está disponible aquí.
Documentación de código
Se recomienda seguir las recomendaciones establecidas en http://www.oracle.com/technetwork/java/javase/documentation/index-137868.html.