Working with Mailboxes

Sobre la interfaz web de la biblioteca digital, desplegada en el componente gráfico de IU_LibraryClient, el Lector Remoto hace clic sobre el enlace de descarga de un contenido; a través del método hyperlinkUpdate(), HTMLViewer detecta que se ha generado un evento que corresponde a una solicitud de descarga de contenidos, así que ejecuta el método downloadingRequestSYN() de RequestManager para verificar que la descarga solicitada no se encuentre en trámite, y en vez de direccionar la solicitud hacia la biblioteca digital lo hace hacia la Aplicación Servidor mediante el procedimiento setPage() de HTMLViewer. Éste realiza la petición GET HTTP para que el método doGet() del servlet Downloadings de la Aplicación Servidor sea ejecutado; doGet() invoca a su vez a processRequest(), método encargado de tratar la solicitud de descarga y cuya primera acción es responder a la Aplicación Cliente con el JSP success; cuando HTMLViewer recibe el JSP, su método setPage() modifica el componente gráfico de IU_LibraryClient, donde el Lector Remoto visualiza el mensaje que le indica que la descarga efectivamente se encuentra en trámite (Figura 3-33).

En la Aplicación Cliente, el método downloadingRequestSYN() prosigue su ejecución, y en su siguiente paso agrega las propiedades de la descarga en trámite al documento XML de descargas, gracias al procedimiento addNode() de XMLDownloadingManager; los cambios hechos al documento XML se guardan con la ejecución del método saveDocument(), también de XMLDownloadingManager. Para mostrar al Lector Remoto el porcentaje de fragmentos de archivo obtenidos durante el proceso de descarga de un contenido, se invoca al procedimiento addProgressBar() de IU_LibraryClient. Finalmente restartConnectionManager() de ConnectionManager se ejecuta para iniciar el proceso de recepción de los mensajes y unión de los fragmentos de archivo (Figura 3-32).

ACCESO A BIBLIOTECAS DIGITALES DESDE REDES DE BAJA VELOCIDAD CAPITULO III. ARQUITECTURA DEL SOFTWARE

63

Figura 3-33. Diagrama de Secuencia para el Casos de Uso Descargar Contenidos - Parte 1.

Figura 3-34. Diagrama de Secuencia para el Casos de Uso Descargar Contenidos - Parte 2.

En la Aplicación Servidor, el método processRequest() del servlet Downloadings continúa ejecutándose, y en el próximo paso acude al procedimiento isSetFile() de FileProperties, con el ánimo de fijar los valores respectivos a todas las propiedades necesarias para que el proceso de descarga se complete exitosamente; luego se ejecuta isDownloaded() de FileDownloader, el cual realiza la petición HTTP de descarga a la Biblioteca Digital EHAS y obtiene el archivo de contenido. Posteriormente, es necesario recurrir al método isFileCut() de FileCut, que fija valores a todas las propiedades necesarias para que la

ACCESO A BIBLIOTECAS DIGITALES DESDE REDES DE BAJA VELOCIDAD CAPITULO III. ARQUITECTURA DEL SOFTWARE

64

compresión y fragmentación del archivo sea exitosa; FileCut ejecuta el procedimiento executeAction() de FileCutter, que es el encargado de comprimir y fragmentar el archivo de contenido (Figura 3-35). Finalmente, mediante el procedimiento sendMailAttachment() de SenderMailAttachment, se envía a través del Servidor de Correo Electrónico del Hospital cada fragmento del archivo como adjunto en un mensaje que tiene como destino el Servidor de Correo Electrónico del Puesto de Salud (Figura 3-36).

Figura 3-35. Diagrama de Secuencia para el Casos de Uso Descargar Contenidos - Parte 3.

ACCESO A BIBLIOTECAS DIGITALES DESDE REDES DE BAJA VELOCIDAD CAPITULO III. ARQUITECTURA DEL SOFTWARE

65

El proceso de recepción de los mensajes y unión de los fragmentos en la Aplicación Cliente se ejecuta en el hilo correspondiente a la clase ConnectionManager, que se encuentra suspendido. A través del método restartConnectionManager(), que a su vez invoca a notify(), se cambia su estado para que continúe con la ejecución; cuando el hilo se reactiva otorga un margen de espera parametrizado mediante el método stopConnection(), mientras la Aplicación Servidor termina el envío de los mensajes al Servidor de Correo Electrónico del Hospital y el Lector Remoto finaliza su navegación por la biblioteca digital; el valor por defecto de este parámetro es de 15 minutos. Cuando ese tiempo de espera llega a su fin, por medio de isConnected() la Aplicación Cliente verifica que haya conexión e invoca el método executetMailTransfer() de EmailsDonwloaderClient (Figura 3-37), el cual, a través de un socket TCP interacciona con el subsistema EmailsDownloader para que active la transmisión de mensajes desde el Servidor de Correo Electrónico del Hospital al Servidor de Correo Electrónico del Puesto de Salud. Mientras dicha transmisión toma lugar, el actual procedimiento en trámite se detiene mediante la ejecución nuevamente del método stopConnection() de ConnectionManager (Figura 3-38).

Figura 3-37. Diagrama de Secuencia para el Casos de Uso Descargar Contenidos - Parte 5.

ACCESO A BIBLIOTECAS DIGITALES DESDE REDES DE BAJA VELOCIDAD CAPITULO III. ARQUITECTURA DEL SOFTWARE

66

El proceso se reanuda con la instancia de la clase EmailsProcess, que con el ánimo de evitar problemas de sincronización en el mecanismo de descarga; inicia un nuevo proceso independiente al anterior a través de la ejecución del método run(), el cual, ordena la descarga de todos los mensajes del Servidor de Correo Electrónico del Puesto de Salud mediante el procedimiento retrieveMessages() de RetrieverMail; para luego extraer de cada uno de ellos el fragmento de archivo adjunto y almacenarlo en el directorio indicado, tarea realizada por saveAttachment(); cada vez que se obtiene un fragmento se invoca al

método updateXMLDownloadingDescriptor() de XMLDownloadingManager, para

actualizar las propiedades de la descarga (Figura 3-39), y a setDownloadingBarValue() de IU_LibraryClient, para actualizar el estado de la barra de progreso que indica al Lector Remoto el porcentaje de fragmentos de archivo obtenidos (Figura 3-40).

Figura 3-39. Diagrama de Secuencia para el Casos de Uso Descargar Contenidos - Parte 7.

Figura 3-40. Diagrama de Secuencia para el Casos de Uso Descargar Contenidos - Parte 8.

Finalmente, cuando se han conseguido todos los fragmentos de archivo que conforman la descarga, es preciso acudir a los métodos isFilesGet() e isFilesGetter() de FileGet para fijar valores a todas las propiedades necesarias para que la descompresión y unión de los fragmentos de archivo sea exitosa; FileGet ejecuta el procedimiento executeAction() de

ACCESO A BIBLIOTECAS DIGITALES DESDE REDES DE BAJA VELOCIDAD CAPITULO III. ARQUITECTURA DEL SOFTWARE

67

FileGetter, encargado de descomprimir y unir el archivo de contenido (Figura 3-41). Una vez obtenido el contenido completo, es indispensable apelar al método downloadingRequestFIN() de RequestManager, que envía una petición GET HTTP a la Aplicación Servidor, la cual responde inmediatamente a la solicitud para que en ambas aplicaciones se ejecuten los procesos respectivos. En la Aplicación Servidor, a través del método delDirectory() de Parent, se elimina el directorio en él cual están resguardados el archivo de contenido y los respectivos fragmentos, y en la Aplicación Cliente se elimina del documento XML de descarga las propiedades de la descarga que acaba de finalizar, a través del método delNode() de XMLDownloadingManager; los cambios realizados al documento XML se guardan con la ejecución del método saveDocument() también de XMLDownloadingManager (Figura 3-42).

Figura 3-41. Diagrama de Secuencia para el Casos de Uso Descargar Contenidos - Parte 9.

ACCESO A BIBLIOTECAS DIGITALES DESDE REDES DE BAJA VELOCIDAD CAPITULO III. ARQUITECTURA DEL SOFTWARE

68