Actividades / Productos de Trabajo Tareas Teoría Actividad de Aprendizaje


Actividad 5 En base al anexodms_anexo_1.docx



Descargar 2,12 Mb.
Página5/17
Fecha de conversión12.01.2017
Tamaño2,12 Mb.
1   2   3   4   5   6   7   8   9   ...   17

Actividad 5

En base al anexodms_anexo_1.docx

Realizar las siguientes actividades:
Descargar Anexo: Anexo 1

(dms_anexo_1.docx)
1.- Realice el diagrama de clases

2.- Realice el diagrama de secuencia








Pantalla 7

Documentación de Código

La documentación interna de un programa incluye elementos cuyo objetivo es facilitar la inteligibilidad del mismo.No es lo mismo tardar 5 minutos en entender un código que tardar un par de horas en intentar saber que es lo que hace porque no tiene unos buenos comentarios y no está correctamente estructurado. La mayoría de los desarrollos de sistemas se llevan a cabo por parte de un equipo. Una buena documentación interna del código que se está desarrollando favorece la comunicación entre los distintos miembros del equipo, mejorando su productividad.
Los tres elementos más significativos de la documentación de código son la elección de nombres significativos, los comentarios y la indentación. Veremos, a continuación, cada uno de ellos:


Elección de nombres significativos
La elección de nombres significativos para los identificadores (tanto de constantes, como variables, funciones...) es crucial para que un programa sea inteligible.
Consideremos las siguientes sentencias
código:
e = v * t

espacio = velocidad * tiempo


La primera de las sentencias es más concisa, pero la segunda aporta mucha más información al lector de la misma.
El nombre de los identificadores debe elegirse de forma que no deje lugar a duda sobre su objetivo o el significado del valor que va a contener.
Comentarios
La posibilidad de expresar comentarios en lenguaje natural como parte del listado del código fuente es algo que aparece en todos los lenguajes de programación. Los comentarios permiten al programador comunicarse con otros lectores del código, resultando una clara guía de comprensión durante las etapas de mantenimiento.

Indotación
La forma en que el código fuente aparece en el listado supone una importante contribución a la legibilidad del mismo. La indentación realza las construcciones lógicas y los bloques del código.
No es lo mismo:
Código

C:
#include


int main ()

{

int y, a;



for (y=0;y<=10;y++)

for (a=0;a<=10;a++)

printf("%i x %i = %in", y, a, y*a);

return 0;

}
Que:
Código

C:
#include


int main ()

{

int y, a;



for (y=0;y<=10;y++)

for (a=0;a<=10;a++)

printf("%i x %i = %in", y, a, y*a);
return 0;

}
Aunque ejecute lo mismo. El segundo trozo de código es más legible que el primero.



Notación Húngara
Es un método ampliamente usado sobre todo para convención de nombres de variables. El inventor de esta notación, Charles Simonyi, nació en Hungría, por eso el nombre. Consiste en tener variables autodocumentadas agregando un prefijo de tres caracteres o menos para indicar su tipo. Las abreviaturas de los tipos de datos pueden variar dependiendo del lenguaje de programación.
Algunos ejemplos:
b Booleano (int)

by BYTE o UCHAR (unsigned char)

c Carácter (un byte)

dw Entero largo de 32 bits sin signo (doubleword)

f Flags empaquetados en un entero de 16 bits

h Manipulador de 16 bits (handle)

l Entero largo de 32 bits

lbl Objeto Label

lp Puntero a entero largo de 32 bits

lpfn Puntero largo a una función que devuelve un entero

lpsz Puntero largo a una cadena terminada con cero

n Entero de 16 bits

p Puntero a entero de 16 bits

e Enumeración

pt Coordenadas (x, y) empaquetadas en un entero de 32 bits

rgb Valor de color RGB empaquetado en un entero de 32 bits

sz Cadena terminada en cero

txt Cajas de texto

w Entero corto de 16 bits sin signo (word)
En un sentido más categórico, si tengo un contador, primero van las letras que me dicen que es un número entero (n) y luego el nombre de la variable que sea significativo para su uso.
Por ejemplo un contador que me sirve para saber cuántos hay conectados en una página:
intnContPerPag; n de número entero, Cont de contador, Per de personas, Pag de pagina.


Notación camello
La notación Camel consiste en escribir los identificadores con la primera letra de cada palabra en mayúsculas y el resto en minúscula: EndOfFile. Se llama notación “Camel” porque los identificadores recuerdan las jorobas de un camello. Existen dos variantes:
Existen en principio dos variantes de esta notación, la UpperCamelCase y la lowerCamelCase. La principal diferencia entre ambas es que en el caso del upper la primera letra siempre se escribirá en mayúscula mientras que en la segunda la primera palabra siempre será entera en minúsculas.
UpperCamelCase: la primera letra es mayúscula.
lowerCamelCase: la primera letra es minúscula.
En el lenguaje Java, se usa la notación CamelCase en identificadores para clases. La notación Camel se utiliza también en publicidad y marcas comerciales: PlayStation, easyJet, etc









MoProSoft

Pantalla 8


¿Qué es MoProSoft?

El Modelo de Procesos para la Industria de Software (MoProSoft) es un conjunto integrado de procesos de Gestión e Ingeniería de Software, compuesto por prácticas reconocidas.








1   2   3   4   5   6   7   8   9   ...   17


La base de datos está protegida por derechos de autor ©absta.info 2019
enviar mensaje

    Página principal