Universidad de los Andes

Ingeniera de Sistemas y
Computacin
Algortmica y Programacin por Objetos 1

Ejercicio Nivel 5
Visor Libreta


Objetivos del ejercicio

En el presente ejercicio usted trabajar en:
Diseo e implementacin de una interfaz grfica de usuario.

Los siguientes pasos conforman el plan sugerido para desarrollar el ejercicio.

Este ejercicio debe ser realizado de manera INDIVIDUAL.

Preparacin

1. Descargue del sitio web del curso el archivo demo de la aplicacin
(n5_visorLibreta_demo.exe) y ejectelo para conocer el funcionamiento
esperado del programa.
2. Descomprima el archivo esqueleto.zip e importe el proyecto en Eclipse llamado
n5_visorLibreta.
3. Lea el enunciado del problema disponible en:
n5_visorLibreta/docs/specs/Descripcion.pdf.
4. Estudie el modelo del mundo ModeloConceptual.jpg disponible en:
n5_visorLibreta/docs/specs. Identifique las clases, relaciones entre clases,
constantes, atributos y mtodos. Lea tambin el documento
RequerimientosFuncionales.pdf que se encuentra en el mismo directorio.
5. Desde Eclipse revise la documentacin de las clases del mundo. Esto le permitir
entender para qu sirve cada mtodo y cada uno de los atributos.
6. Ejecute las pruebas del mundo desde Eclipse para verificar que no hay errores en
el cdigo fuente de las clases del mundo. Para esto, desde Eclipse, abra el
paquete uniandes.cupi2.visorLibreta.test ubicado en la carpeta
n5_visorLibreta/test/source:
Seleccione el archivo ContactoTest.java, haga clic con el botn derecho del
ratn y seleccione la opcin Run as JUnit Test.
Seleccione el archivo LibretaContactosTest.java, haga clic con el botn
derecho del ratn y seleccione la opcin Run as JUnit Test.


Parte 1: Creacin de la interfaz grfica

El objetivo de este ejercicio es que usted cree la interfaz grfica de la aplicacin
n5_visorLibreta. El modo como debe lucir dicha Interfaz puede encontrarlo en el
documento Descripcion.pdf. Su comportamiento se ilustra en la demostracin del
ejercicio n5_visorLibreta_demo.exe.
No puede utilizar herramientas de generacin de interfaces para construir la interfaz
grfica. Las clases que componen la interfaz deben construirse segn la arquitectura
vista en el curso.
Las clases de la interfaz deben quedar ubicadas en el paquete
uniandes.cupi2.visorLibreta.interfaz. Para crear el paquete siga los
siguientes pasos:

1. Ubquese en la carpeta source, haga clic derecho y seleccione la opcin New
del men contextual. Luego seleccione Package.



2. En el cuadro de dialogo ingrese el nombre del paquete:
uniandes.cupi2.visorLibreta.interfaz.



Para crear la clase principal de la interfaz (la que corresponde a la ventana principal
de la aplicacin) siga las siguientes instrucciones:

1. Ubquese en el directorio uniandes.cupi2.visorLibreta.interfaz,
haga clic derecho y seleccione la opcin New del men contextual. Luego
seleccione Class.


2. En el cuadro de dialogo ingrese el nombre de la clase: InterfazVisorLibreta
(nombre sugerido) y seleccione la opcin para crear de forma automtica el
mtodo main.



Al escribir el mtodo constructor de la ventana principal e inicializar la asociacin a la
clase principal del mundo usando el mtodo constructor de la clase LibretaContactos,
no olvide encerrar en un try-catch el llamado a este mtodo para capturar la posible
excepcin que se puede lanzar si falla la lectura de la informacin de los contactos
desde un archivo.
Juegue con los elementos grficos vistos en el nivel para obtener la vista esperada.
Busque el layout conveniente (BorderLayout o GridLayout) y combnelo con bordes
vacos para acomodar correctamente los elementos.
Si desea separar verticalmente los elementos grficos distribuidos con un GridLayout,
puede hacer uso del mtodo setVgap(), como se aprecia a continuacin:

GridLayout layout = new GridLayout( 2, 2 );
layout.setVgap( 5 );
panelX.setLayout( layout );

Debe incluir en su desarrollo el manejo de extensiones del ejercicio (la parte
correspondiente a la interfaz), es decir, los mtodos reqFuncOpcion1( ) y
reqFuncOpcion2( ). Estos mtodos llaman al metodo1() y metodo2() del mundo
respectivamente y muestran una ventana de dialogo con la respuesta (String)
generada por estos mtodos.
La interaccin con las clases del mundo, debe establecerla estudiando las clases y los
mtodos correspondientes.


Parte 2: Javadoc

Cuando haya verificado que todas las pruebas de la aplicacin sean exitosas, genere el
Javadoc del proyecto. Para esto es necesario hacer doble clic sobre el archivo
doc.bat (ubicado en n5_visorLibreta/bin/win para Windows) o doc.sh (ubicado en
n5_visorLibreta /bin/mac para Mac) por fuera de Eclipse.

La documentacin se genera en el subdirectorio n5_visorLibreta/docs/api. En caso de no
aparecer el directorio api, modifique las variables de ambiente siguiendo las instrucciones
proporcionadas en el siguiente documento (revise solo a partir del paso 8):

http://cupi2.uniandes.edu.co/sitio/images/recursos/herramientas/InstalacionJDK.pdf

Una vez generada la documentacin empiece por leer el archivo:

n5_ visorLibreta/docs/api/index.html

Revise la documentacin html de las clases del mundo y verifique las responsabilidades
de los mtodos, constantes y atributos.

Explore la documentacin html de las clases de la interfaz.


Validacin

Para comprobar el funcionamiento de su ejercicio usted puede:
1. Ejecutar nuevamente las pruebas disponibles en el ejercicio (validacin funcional
del mundo).
2. Ejecutar el programa e interactuar con todas las opciones disponibles en la
interfaz.


Entrega

1. Construya el archivo entregable con el ejercicio completo. No olvide revisar que su
entrega cumple con lo especificado en las normas del curso referentes a entregas
de ejercicios. Las puede consultar en:
http://cupi2.uniandes.edu.co/sitio/index.php/cursos/apo1/normas-administrativas
2. Entregue el archivo del ejercicio va SicuaPlus, de acuerdo con las normas, fecha y
hora de entrega definidas en su seccin.