Se il link non funzionasse è comunque possibile visualizzare la documentazione attraverso il file APIdoc.html nella cartella doc.
L'applicazione è fornita attraverso il file studentDB-0.0.1-SNAPSHOT.jar nella cartella bin. Nella stessa cartella è anche fornito un file di configurazione
application.properties
; è possibile ad esempio configurare opportunamente il mail server oppure le ultime due righe consentono di scegliere il porto su cui avviare il server e se utilizzare https o meno. Ci si assicuri che tale file si trovi nella stessa cartella del file jar. Per avviare l'applicazione da terminale:
java -jar studentDB-0.0.1-SNAPSHOT.jar
E' necessario avere una versione di
Java 17
o superiore, reperibile su https://www.oracle.com/it/java/technologies/downloads/.
Nel momento in cui si apportasse qualche modifica al sistema, il file jar deve essere rigenerato. Per farlo seguire i seguenti passaggi:
Per prima cosa scaricare Maven dal link https://maven.apache.org/download.cgi. L'installazione di Apache Maven è un semplice processo di estrazione dell'archivio e aggiunta della cartella bin
con il comando mvn
alla variabile PATH
.
I passi dettagliati sono:
-
Avere un'installazione JDK sul proprio sistema. Settare la variabile d'ambiente
JAVA_HOME
per puntare all'installazione JDK oppure impostare l'eseguibilejava
sulPATH
. -
Estrarre l'archivio della distribuzione in una cartella qualsiasi
unzip apache-maven-3.9.2-bin.zip
oppure
tar xzvf apache-maven-3.9.2-bin.tar.gz
Alternativamente usa il tuo strumento di estrazione archivio preferito.
-
Aggiungere la cartella
bin
della cartella creataapache-maven-3.9.2
alla variabile d'ambientePATH
-
Confermare l'installazione con
mvn -v
in una nuova shell. Il risultato dovrebbe essere simile a:
Apache Maven 3.9.2 (c9616018c7a021c1c39be70fb2843d6f5f9b8a1c)
Maven home: /opt/apache-maven-3.9.2
Java version: 1.8.0_45, vendor: Oracle Corporation
Java home: /Library/Java/JavaVirtualMachines/jdk1.8.0_45.jdk/Contents/Home/jre
Default locale: en_US, platform encoding: UTF-8
OS name: "mac os x", version: "10.8.5", arch: "x86_64", family: "mac"
studentDB
. Eseguire il seguente comando:
mvn clean install
. Alla fine del processo verrà generato il file studentDB-0.0.1-SNAPSHOT.jar
nella cartella studentDB/target
Per avviare l'applicazione da terminale si segua la stessa procedura descritta sopra, ossia si sposti in una stessa directory il file jar precedentemente generato e il file di configurazione fornito ed eseguire il comando java -jar studentDB-0.0.1-SNAPSHOT.jar
Per importare il progetto su Eclipse: Import->Maven->Existing Maven Projects e selezionare la cartella studentDB come root o tramite clone.
Se le dipendenze non dovessero essere risolte automaticamente si può provare, nel file pom.xml, la seguente procedura: tasto destro-> Maven -> Update Project.
Per avviare il server eseguire il file StudentDBApplication.java .
NOTA: Siamo a conoscenza di un bug di Spring Boot per il quale, quando si lancia l'applicazione, a volte non vengono istanziati tutti i Bean necessari (si è osservato che tale comportamento si presenta soprattutto quando vengono modificate le dipendenze nel pom.xml). Nel nostro caso si tratta del Bean JavaMailSender che dovrebbe essere creato automaticamente a partire dal file di configurazione application.properties nel path studentDB/src/main/resources. Se tale problema dovesse presentarsi la soluzione più semplice è quella di spostare il file application.properties in un'altra cartella e riportarlo al path precedente, in modo da forzare un refresh.