Sharlay - Share and Play

Universitat Pompeu Fabra (UPF) 2020 - Software Engineering of Web Applications

Name: Àngel Herrero Díaz
NIA: 205310
Emails: [email protected] / [email protected]

Name: Paula Janer Talamàs
NIA: 204809
Emails: [email protected]

Name: Mireia Espuga López
NIA: 206319
Emails: [email protected]

Name: David Ciria Mayordomo
NIA: 206038
Emails: [email protected]

Introduccion d'ús en local

Instalació

Eclipse

Hem emprat l'IDE Eclipse per desenvolupar el projecte. Es pot descarregar fàcilment desde la pàgina oficial: https://www.eclipse.org/

IMPORTANT: Instalar la versió "Eclipse IDE for Java EE Developers".

Tomcat

Per al desenvolupament de l'aplicació s'ha usat el servidor Tomcat en la versió 9. Per instalar-lo és necessari descarregar el arxiu zip core desde el següent enllaç: https://tomcat.apache.org/download-90.cgi

Seguir el següent link per la seva instal·lació: http://www.coreservlets.com/Apache-Tomcat-Tutorial/tomcat-7-with-eclipse.html

Projecte

Existeixen dues alternatives per descarregar el projecte:

1. Github

Realitzarem un git clone del següent respositori al nostre workspace d'Eclipse: https://github.com/davidciria/Sharlay/

2. Fitxer WAR

Importarem el fitxer WAR a Eclipse. Els passos son els següents:

1. Desde el menú accedir a: File --> Import
2. Desplegar carpeta Web i seleccionar WAR file. Fer click a Next.
3. Fer un browse del fitxer .war i assegurar-nos que esta seleccionat a l'apartat Target runtime el servidor Apache Tomcat v9.0.
4. Fer click a Finish.

SQL DUMP

Un cop instal·lat el servidor Tomcat procedirem a carregar la base de dades de prova.

En primer lloc crearem un nou usuari anomenat mysql amb el password prac:

CREATE USER 'mysql'@'localhost' IDENTIFIED BY 'prac';
GRANT ALL PRIVILEGES ON *.* TO 'mysql'@'localhost';

Tot seguit, obrirem l'script Sharlay_Dump_1.1.sql i realitzarem una execució completa.

Context de les fotografies de perfil

Sharlay permet pujar fotografies de perfil en format .png. Per que aquesta funcionalitat funcioni correctament cal configurar el context on es troben les imatges.

Per configurar el context ens dirigirem al fitxer server.xml.

Dins del fitxer afegirem la següent linia dins l'etiqueta <Host> especificant la ruta local de la carpeta ProfileImages del nostre projecte.

<Context docBase="ruta_a_la_carpeta_ProfileImages" path="/Sharlay/ProfileImages" />

Exemple: <Context docBase="C:\Users\david\eclipse-workspace\Sharlay\WebContent\ProfileImages" path="/Sharlay/ProfileImages" />

També caldrà modificar la ruta al controlador UploadProfileImage.java

Cambiar la variable path per la ruta local del projecte on es troben les imatges (la mateixa que l'anterior):

Execució

Ja tenim tot el workspace llest, podem executar el projecte desde eclipse fent clic l'icona de play (). Assegurat d'utilitzar Tomcat en la versió 9 per executar el projecte.

Email de verificació

Quan un usuari es registra a la plataforma s'envia un email de verificació. Fins que l'usuari no confirma el correu, no pot iniciar sessió.

Es pot canviar el correu origen (direcció desde on s'envien els correus de verificació) a la classe EmailSender situada al package utils.

En el cas que no arribi l'email de verificació a l'usuari es pot modificar l'atribut regVerified de la taula Users a true.

Usuaris de prova

Hem creat una base de dades adient a la temàtica gamer del nostre Twitter. Per accedir als usuaris haurem de fer login amb les següents dades:

• Usuari: [email protected]
• Contrasenya: Test1234

Els usuaris son accessibles des de la vista com a usuari anònim tant cercant-los amb la barra de cerca del menú com veient els tweets globals. Per accedir a l'administrador de Sharlay haurem de fer login amb les següents dades:

• Usuari: [email protected]
• Contrasenya: Admin1234