SWEDesigner

Generate code directly from UML.

SWEDesigner è un progetto open-source sviluppato dal gruppo Hivex. Permette di generare un programma Java disegnando dei diagrammi: usiamo un diagramma UML delle classi per generare l'architettura del vostro programma e uno speciale diagramma a blocchi per generare il comportamento di ogni metodo delle classi del vostro programma.

SWEDesigner è un'applicazione web con un back end Java (è ospitato su un server Tomcat) e un front end JavaScript.

Il resto di questo documento vi guiderà nella installazione e/o compilazione del prodotto SWEDesigner. L'installazione e compilazione del prodotto sono state testate sotto i seguenti sistemi operativi:

1. Microsoft Windows 10
2. Canonical Ubuntu 16.04
3. Apple OS X El Capitan

Installazione

Prerequisiti per l'installazione

È necessario avere le seguenti dipendenze installate sul proprio sistema:

1. Tomcat versione 8.0 (o superiore)
2. Java JDK versione 1.7 (o superiore) -- per poter creare un eseguibile del progetto

Deploy

Usare il file WAR desiderato presente nella cartella /release ed effettuare il deploy del package. Ulteriori dettagli sull'utilizzo di Tomcat sono disponibili ai seguenti indirizzi web:

1. https://tomcat.apache.org/tomcat-8.0-doc/deployer-howto.html (data di consultazione 07/05/2017, lingua inglese)
2. https://tomcat.apache.org/tomcat-8.0-doc/manager-howto.html (data di consultazione 07/05/2017, lingua inglese)

Qualora non sia stata correttamente impostata dal processo di installazione del Java JDK, impostare la variabile d'ambiente JAVA_HOME come indicato qui (data di consultazione 07/05/2017, lingua inglese).

Creare una cartella personalizzata per gli upload dei utenti

Di default, gli upload dei file degli utenti e i rispettivi file compilati sono creati nella cartella /home/tomcat/Uploads/. Qualora si desideri modificare il percorso della cartella degli upload, seguire l'intero procedimento; altrimenti è necessario seguire le indicazioni fino al punto 2.

1. Creare una cartella nella posizione desiderata (/home/tomcat/Uploads/)
2. Controllare i permessi della cartella (in lettura e scrittura)
3. Entrare nella cartella di installazione di Tomcat, poi proseguire in webapps/ROOT/WEB-INF/classes/application.properties
4. Modificare il file alla riga uploadsDir = <PATH>
5. Riavviare il server

Al termine della attività di deploy, recarsi all'indirizzo del server (di default /localhost:8080).

Troubleshooting

Viene presentato un errore 404 o un alert vuoto durante la pressione del pulsante "generate"

È necessario che il nome del file WAR sia esattamente ROOT.war in quanto l'applicazione funziona solo come applicazione principale.

Compilazione

Prerequisiti per la compilazione

1. Maven versione 3.5.0 (o superiore)

Maven

1. Portarsi sulla path radice del progetto
2. Eseguire il seguente comando mvn compile war:war
3. Il file WAR sarà generato nella cartella /target con il nome ROOT.war