pfc-prolog-cvs Mailing List for pfc-prolix (Page 4)

SourceForge Headquarters 225 Broadway Suite 1600 San Diego, CA 92101 +1 (858) 422-6466

Update of /cvsroot/pfc-prolog/prolix-doc/pfc-es/proceso
In directory sc8-pr-cvs1:/tmp/cvs-serv21911/proceso

Modified Files:
	proceso.tex 
Added Files:
	iteraciones.tex 
Log Message:
Added iteration planning in doc

--- NEW FILE: iteraciones.tex ---
%
%
%   Proceso de desarrollo :: iteraciones
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

\section{Desarrollo iterativo}

 En la elaboración del programa se ha optado por un proceso de desarrollo iterativo, influenciado por el <<proceso unificado>> descrito en \cite{uml-patrones} y la filosofia XP (eXtreme Programming) descrita en \cite{beck-XP}.

 De esta manera se optó por dividir el desarrollo en etapas/iteraciones, en cada una de las cuales se le añadia una funcionalidad al programa. El plan de iteraciones fue el siguiente:

\begin{enumerate}
  \item \textbf{Iteración 0.} Configuración y preparación del entorno
  \item \textbf{Iteración 1.} Carga y consulta de programas en Prolog con resultados en modo texto.
  \item \textbf{Iteración 2.} Resolución gráfica. Modificar el resultado de la iteración 1 para obtener una representación gráfica del arbol.
  \item \textbf{Iteración 3.} Usuarios. Funcionalidad referida a usuarios y permisos en las operaciones a realizar.
  \item \textbf{Iteración 4.} Biblioteca. Desarrollo e integración de lo relacionado con la biblioteca y gestión de programas.
\end{enumerate}

 A continuación explicamos los pasos más importantes en cada una de las iteraciones.

\subsection{Iteración 0. Configuración y preparación del entorno}

 En este momento se tiene una idea aproximada de la arquitectura y las tecnologias que se van a emplear, despues de una fase de documentación, se instalan y configuran las herramientas, y se practican algunos de los ejemplos que las acompañan, a fin de conseguir un dominio elemental de tecnologias fundamentales como \texttt{Ant} o \texttt{CVS}.

 La instalación necesaria para comenzar el proyecto consiste en el \texttt{servidor de aplicaciones jBoss}, el \texttt{generador de código XDoclet}, la herramienta de compilación \texttt{Ant}, lo necesario para funcionar con el \texttt{CVS} y por supuesto el \texttt{entorno de desarrollo java}.

 Se preparan los interfaces de comunicación con el intérprete, y se establece una estructura básica del código fuente, a fin de reflejarla en el CVS.

 A fin de facilitar la comprensión del problema, se escribe en HTML plano un prototipo hueco, sin funcionalidad de las páginas del sistema y la navegación entre ellas.

 Se da también de alta el proyecto en Sourceforge\cite{sourcerforge-web}, y se crean los módulos en el CVS, las listas de correo, etc\dots.

\subsection{Iteración 1. Carga y consulta en modo texto}

 El objetivo principal es obtener un programa funcional, sobre el que trabajar en las iteraciones posteriores. 

 Las decisiones tomadas en este momento son muy importantes, pues sientan las bases para todo el desarrollo posterior, por lo que se presta mucha atención al diseño. 

 Se toma el primer contacto <<práctico>> con los sessionEJB, HTML y XSLT, y su uso desde JSP. Ajustes fundamentales al XDoclet y las etiquetas a incluir en los ficheros de código. Elaboración del fichero \texttt{buildfile} básico para compilar y desplegar el proyecto. Uso del patrón visitor. Introducción de la tecnologia Struts.

Se planea la iteración en los siguientes pasos:

\begin{enumerate}
 \item Estructura fundamental para interactuar con el intérprete: gestión a traves de un EJB.
 \item Creación de cliente en modo texto para testear el resultado: primera utilización del EJB desde un cliente.
 \item Aplicación patron visitor para obtener un XML simple que represente las soluciones (SolutionXML)
 \item Creación y puesta en marcha de la página <<hola mundo>> en JSP.
 \item Conexión de la página en JSP del EJB: se muestran los resultados en SolutionXML. 
 \item Desarrollo de la hoja de transformación XSLT, para transformar el SolutionXML en HTML.
 \item Utilización del XSLT desde la página JSP
 \item Reelaboración de las páginas en una estructura similar a la del prototipo
 \item Introducción de Struts.
 \item Añadir la funcionalidad <<Siguiente solución>>
\end{enumerate}

 La introducción de Struts fue necesaria para controlar el proceso de navegación entre las páginas web, que ya en este momento se mostró complicado de manejar sin ensuciar el código de las páginas, especialmente debido al manejo de errores. La abundante documentación y la disponibilidad de ejemplos facilito una integración rápida de esta tecnologia en el proyecto.

 Durante la iteración, y ante la dificultad de conseguir el intérprete real adaptado a los interfaces definidos, se escribió un <<dummy-interpreter>>, una simulación que devolvia un arbol predefinido fuese cual fuese el programa o consulta cargado. Se fue mejorando según se necesitaban mas detalles para obtener una funcionalidad un poco mas realista. Posteriormente fue util para demostrar la facilidad de adaptación del sistema a intérpretes diferentes.

 Con todo esto, se consideró acabada la versión 0.1 del programa y se realizó un <<release>> en sourceforge.

\subsection{Iteración 2. Representación gráfica del arbol de resolución}

 En esta iteración el esfuerzo en puntos <<generales>> de la aplicación se reduce considerablemente: la estructura del programa y su representación en el CVS estan hechas, el \texttt{buildfile} solo es necesario ampliarlo y los errores en la configuración de los programas estan solucionados.

 La principal tecnología introducida es el SVG, aunque se utiliza mas exhaustivamente el patrón visitor y el XML.

\begin{enumerate}
  \item Definición del TreeXML, y escritura de su DTD, ampliando el anterior de SolutionXML.
  \item Definir visitors necesarios para obtener el XML del arbol que devuelve el intérprete.
  \item Actualización del cliente texto para comprobar los resultados.
  \item Toma de contacto con DOM para parsear el TreeXML. Pruebas por separado de transformación a SVG.
  \item Integración de SVG en el proyecto: servlets.
  \item Adaptación del cliente web.
\end{enumerate}

 Debido a los problemas de soporte de los navegadores a SVG, la iteración finalizó sin mostrar el SVG, pero con un enlace que permitia descargarlo al ordenador cliente y observarlo desde otro programa.

 Se comenzaron a estudiar alternativas encontrando algunas soluciones interesantes como la biblioteca Batik, finalmente utilizada, y la etiqueta OBJECT para el HTML/JSP de la página.

\subsection{Iteración 3. Sistema de usuarios}

 La principal dificultad radica en la aparición del primer entityBean, y su preparación para desarrollarlo con XDoclet. El arranque y configuración de MySQL y su conector en el jBoss, la instalación y utilización de phpMyAdmin, y la configuración del jBoss para la conexión a la base de datos.

\begin{enumerate}
  \item Implementación y despliegue del Entity EJB.
  \item Gestión de login y logout en el Session EJB desarrollado.
  \item Adaptación del cliente consola para probar estas características
  \item Creación de las páginas web necesarias para el uso de este servicio: login, registro de usuario.
  \item Prueba del accceso por la web
  \item Creación de una página para el administrador donde gestionar usuarios.
\end{enumerate}

 Finaliza la iteración con un sistema de usuarios sencillo, y un tanto esquemático, pero funcional y facilmente ampliable. 

\subsection{Iteración 4. Biblioteca}

 Se introduce un nuevo EntityBean, y en este caso la dificultad reside en establecer correctamente la relación <<uno-muchos>> con el Bean de usuario. Un usuario dispones de muchos programas, el programa pertenece a ún único usuario. XDoclet dispone de abundante y bien explicada documentación al respecto, pero la dificultad y tediosidad de las pruebas dificulta el desarrollo.

\begin{enumerate}
  \item Creación del Entity EJB.
  \item Relación con el Entity EJB de usuario.
  \item Creación de métodos en el SessionBean para la utilización de las nuevas funcionalidades: introducir o eliminar programa,\dots
  \item Creación de las nuevas páginas requeridas en JSP.
\end{enumerate}

 Y al final de esta iteración disponemos de un sistema completo con la funcionalidad deseada.

\subsection{Aspectos generales a todas las iteraciónes}

 Es preciso señalar que la introducción de nuevas páginas JSP en la aplicación conllevaban el correspondiente desarrollo, implementación y configuración de clases en Struts para controlar la navegación.

 Asimismo, el intérprete original a utilizar con la aplicación no pudo estar listo a tiempo. El desarrollo se realizó utilizando la simulación implementada (<<prolix-dummy-interpreter>>, y en la última etapa se pudo utilizar un intérprete real, implementado por D. Berrueta, llamado LUpi. Los cambios a realizar en el código para cambiar el intérprete fueron, como era de esperar, mínimos, por lo que no se esperan grandes problemas para adaptar el intérprete definitivo.

 Algunas tareas no se incluyeron en la planificación inicial de las iteraciones, y su desarrollo se produjo <<bajo demanda>>, pues se consideraron detalles menores que no afectan a la funcionalidad o diseño de la aplicación, a pesar de facilitar su uso:

\begin{itemize}
   \item Recordatorio de consultas: Se almacenan las últimas consultas escritas por el usuario para permitir su re-ejecución si así se desea.
   \item Mostrar usuario logeado: Se muestra en todas las páginas el usuario actualmente logeado junto al botón de logout.
   \item Desarrollo de un sistema para evitar el acceso del usuario sin login a páginas que lo requieren, o al usuario logeado a páginas a las que no tiene permiso: Implementación de una <<custom tag>> (etiqueta de JSP) propia que comprueba el nivel de permisos en cada página.
   \item Transformación de SVG en JPEG para visualizar resultados. Se añadio posteriormente, junto con la capacidad de responder dinámicamente  con SVG o JPEG en función de la capacidad del navegador.
   \item Uso de hojas CSS para el diseño gráfico.
\end{itemize}

\subsection{Tareas realizadas una vez finalizado el desarrollo}

 Una vez considerada la aplicación como en una versión suficientemente estable y que cumple con los requisitos solicitados, se realiza en SourceForge el <<release>> de la versión 0.9. A fin de facilitar su instalación se añade una distribución en binarios, que con pequeñas mejoras constituyen la versión 0.91

 Como ultimo paso, se requiere la ayuda de un diseñador gráfico para obtener un resultado visual más agradable, sobre este aspecto hablamos en las conclusiones más ampliamente.
Index: proceso.tex
===================================================================
RCS file: /cvsroot/pfc-prolog/prolix-doc/pfc-es/proceso/proceso.tex,v
retrieving revision 1.2
retrieving revision 1.3
diff -C2 -d -r1.2 -r1.3
*** proceso.tex	25 Aug 2003 20:56:02 -0000	1.2
--- proceso.tex	26 Aug 2003 13:50:17 -0000	1.3
***************
*** 4,7 ****
  %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

! \input{proceso/herramientas.tex}
! \clearpage
\ No newline at end of file
--- 4,7 ----
  %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

! %\input{proceso/herramientas.tex}
! \input{proceso/iteraciones.tex}
\ No newline at end of file

pfc-prolog-cvs Mailing List for pfc-prolix (Page 4)

pfc-prolog-cvs — mail list with cvs-commit messages