Este proyecto se trata de una aplicación web realizada para la asignatura "Sistemas Distribuidos e Internet", utilizando la plataforma Node Js. Está divido en 2 partes:
- Una aplicación web tradicional, en la que se utiliza un patrón similar al Modelo-Vista-Controlador (MVC). En la capa del "modelo" no hay a su vez una capa de "lógica de negocio", sino que el "controlador" interactua directamente con la capa de "persistencia" (perteneciente al modelo) debido a la sencillez de la aplicación.
- La implementación de una API RESTful y un cliente jQuery que consume dicha API, para crear una Single Page Application (SPA).
- La carpeta red-social-node contiene la aplicación web.
- La carpeta red-social-node-test contiene un proyecto Java JUnit con una serie de pruebas unitarias, empleando el framework Selenium. Estas comprueban el correcto funcionamiento de la aplicación web.
- El pdf Instrucciones explica los requisitos necesarios que han de satisfacer tanto la aplicación como los tests.
- El pdf Documentacion explica cómo se han implementado la aplicación y los tests.
Esta aplicación utiliza una base de datos MongoDB en la nube. Concretamente, utiliza los servicios de MLab. Por tanto, la base de datos original sólo es accesible desde mi cuenta de MLab.
Sin embargo, se puede crear una cuenta en MLab y crear una nueva base de datos propia para probar la aplicación. Una vez creada la base de datos, se debe crear un usuario para la misma.
Una vez tenemos todo creado, hay que acceder al fichero app.js del proyecto red-social-node y modificar la cadena de conexión a la base de datos. En la línea app.set('db', "mongodb://admin:sdi_2018@ds129593.mlab.com:29593/sdi2-uo250707"); hay que cambiar la cadena entre comillas dobles por la que nos indica MLab ( debe sustituirse por el nombre del usuario de la BD, y por su contraseña).
Del mismo modo, si se usa una BD propia en MLab, hay que acceder al proyecto red-social-node-test y, en la clase Mongo.java, modificar:
- El nombre de la base de datos por el nuevo en la línea
private static String database = "sdi2-uo250707";. - La cadena de conexión en la línea
MongoClientURI connectionString = new MongoClientURI("mongodb://admin:sdi_2018@ds129593.mlab.com:29593/sdi2-uo250707");.
Es necesario tener instalado Node.js en el SO. En caso de no tenerlo instalado, se puede desarcargar desde el siguiente enlace https://nodejs.org/es/download/package-manager/. (Para seguir con el desarrollo de esta aplicación también es necesario instalar npm, pero ya se instala directamente al instalar Node).
Hay varias formas para ejecutar, entre ellas:
- Desde línea de comandos: Situarse en la carpeta red-social-node desde la línea de comandos y ejecutar el comando:
node app.js. Para parar el servidor, pulsarControl + C. - Utilizando el IDE WebStorm: Abrir el proyecto red-social-node utilizando WebStorm. Hacer click derecho en el archivo app.js y seleccionar Run 'app.js'.
- Utilizando el IDE Eclipse: Instalar y habilitar el plugin Nodeclipse del eclipse Marketplace. Importar el proyecto red-social-node en un workspace. Hacer click derecho en el archivo app.js y seleccionar Run as -> Node.js Application.
Para visualizar la web, abrir un navegador y visitar la siguiente URL: http://localhost:8081/.
Para probar la aplicación se utiliza una versión antigua de un navegador Firefox. En concreto, la versión 46. Este Firefox en particular no guarda datos en caché, por lo que es perfecto para probar la aplicación mientras está en desarrollo.
Es necesaria una versión de Firefox 47 o inferior, debido a que a partir de la 48 Mozilla no permite utilizar Selenium.
Una vez tenemos dicho Firefox, hay que acceder al fichero Tests.java del proyecto red-social-node-test y modificar la ruta donde se encuentra dicha versión de Firefox. Para ello, hay que cambiar la línea static String PathFirefox = "/Applications/Firefox.app/Contents/MacOS/firefox-bin"; e indicar ahí la ruta.
Importar el proyecto en un workspace de Eclipse. Hacer click derecho en el archivo Tests.java y seleccionar Run as -> JUnit Test.