Il progetto UNIMIB Modules è un progetto all'interno del quale gestire e compilari i questionari, dotata di alta usabilità, tolleranza ai guasti e performance.
È possibile usare il servizio a questo link.
Documentazione OpenAPI
Documentazione tecnica
Documentazione JavaDOC
Elenco release
- Progetto Java:
src - Progetto AngularJS:
src/main/resources/static - Database:
sql
- Per l'esecuzione dal binario è necessario Java 11 o superiore;
- Per la compilazione e il download delle dipendenze del progetto Java è necessario Maven 3.8.3 o superiore;
- Per il download delle dipendenze del progetto AngularJS è necessario Yarn 1.22.17 o superiore;
- Un database MariaDB o MySQL.
- Nella cartella
src/main/resources/staticeseguire il comando:yarn install - Nella radice del progetto eseguire il comando:
mvn clean verify - Al termine della compilazione il binario si troverà nella cartella
targete potrà essere avviato col comandojava -jar target/unimibmodules.jar
È possibile usare il servizio senza avviarlo in locale a questo link.
In alternativa è possibile avviarlo da codice sorgente o da binario seguendo le seguenti istruzioni:
- Avvio da codice sorgente
- Creare un database per il progetto (chiamarlo, per esempio, unimibdb);
- Aprire il file
src/main/resources/application.propertiese impostare le seguenti proprietà:spring.datasource.url: inserire l'url nel formato JDBC per il database (esempio:jdbc:mysql://indirizzodatabase:porta/nomedatabase?eventualiparametri=valore);spring.datasource.username: nome utente per l'accesso al database;spring.datasource.password: password per l'accesso al database.
Non è possibile avviare il server senza aver configurato il database.
- Aprire il file
src/main/java/it/unimib/unimibmodules/controller/AWSToken.javae impostare le seguenti chiavi:ACCESS_KEY_ID: inserire l'username della route fornita dal servizio AWS;ACCESS_KEY_VALUE: inserire la passsword della route fornita dal servizio AWS.
È possibile avviare il server senza configurare AWS, ma non sarà possibile effettuare il caricamento delle immagini
- Aprire il file
src/main/java/it/unimib/unimibmodules/service/MailServiceImpl.javae impostare le seguenti informazioni:EMAIL_USERNAME: l'indirizzo email;EMAIL_PASSWORD: la password per accedere all'indirizzo email;EMAIL_SMTP_HOST: l'indirizzo dell'host SMTP;EMAIL_SMTP_AUTH:truese è richiesta l'autenticazione,falsealtrimenti;EMAIL_SMTP_PORT: la porta del server SMTP;EMAIL_SMTP_TLS:truese è richiesto TLS,falsealtrimenti.
Potrebbe essere necessario abilitare le applicazioni non sicure sul proprio provider email.
È possibile avviare il server senza configurare SMTP. ma non sarà possibile effettuare l'invio delle e-mail
- Avviare il progetto da un IDE o dal binario compilato.
- Avvio da binario:
- Per avviare l'esecuzione da binario, è sufficiente utilzzare il comando
java -jar unimibmodules-1.0.0-SNAPSHOT.jar;
- Per avviare l'esecuzione da binario, è sufficiente utilzzare il comando
Dopo averlo avviato, il progetto sarà raggiungibile all'URL localhost:5000.
Attenzione: se dovesse essere necessario riavviare il programma è consigliabile impostare la proprietà spring.jpa.hibernate.ddl-auto a none oppure validate.
Al primo avvio potrebbero verificarsi errori del tipo SQLException; questi sono causati da errori di Hibernate durante la creazione del database. In questo caso è sufficiente lanciare nuovamente l'applicazione. Se, dopo aver avviato il progetto una seconda volta, si dovessero verificare ulteriori problemi di questo tipo, è possibile creare il database usando lo script all'interno della cartella sql.
Se dovessero presentarsi altri eccezioni di Hibernate o riguardanti la creazione di bean, è possibile che si sia verificato un errore nella connessione al database.