Prog2@UniMI Handouts

Questo repository contiene gli handout dell'insegnamento di Programmazione II del corso di laurea in Informatica dell'Università degli Studi di Milano.

Il materiale di questo repository (aggiornato periodicamente) consiste nella collezione del materiale didattico prodotto dal docente sostanzialmente nella forma in cui si trova al termine di ciascuna lezione. Per questa ragione il suo contenuto non è assolutamente inteso come sostituivo dei libri di testo e della documentazione suggerita e in nessun caso è da ritenersi esaustivo e privo di errori, ma è provvisto al solo scopo di consentire agli studenti di ripercorrere i passi visti a lezione e suggerire alcuni esercizi.

Come ottenere ed utilizzare questo materiale sul proprio computer

Può scaricare un archivio zip del contenuto di questo repository usando il link in questa frase, oppure il bottone verde "Clone or download" in altro a destra nella pagina dove sta leggendo questo README.md.

Al fine di consentire l'automazione di alcuni compiti, tra i quali la compilazione, l'esecuzione dei test black-box la generazione della documentazione, questo materiale fa uso di un build automation tool denominato Gradle unitamente al testing framework Jubbiot basato su JUnit.

Una conoscenza approfondita del funzionamento di tali strumenti non è affatto necessaria per lo svolgimento degli esercizi, o per il superamento dell'esame, perché sono completamente predisposti e configurati dal docente, come illustrato nelle sezioni seguenti.

L'unica cosa che è necessario fare è installare il Java Developer Kit (JDK) in una versione sufficientemente recente (la configurazione provvederà poi ad installre automaticamente sia la versione 21 del JDK che Gradle e Jubbiot/JUnit).

Come compilare ed eseguire i test e il codice

Una volta ottenuta una copia locale può procedere a compilare il codice con il comando:

./gradlew build

se usa una ragionevole versione di GNU/Linux, oppure se usa Windows (qui e di seguito) può sostituire ./gradlew con gradlew.bat; questo comando provvederà anche ad eseguire tutti i test specificati nella directory tests.

Può eseguire il codice di una specifica classe, ad esempio it.unimi.di.prog2.h02.SalveMondo con il comando

./gradlew runClass -PmainClass=it.unimi.di.prog2.h02.SalveMondo

Per maggiori informazioni sul funzionamento dei test consulti l'esempio d'uso di Jubbiot; in particolare presti attenzione alla sezione sulla generazione degli output dello studente.

Come generare la documentazione

Può generare la documentazione in locale con il comando:

./gradlew javadoc

tale comando è configurato per riportare un errore in caso di warning, al fine di aiutarla nel comprendere se la documentazione è, almeno dal punto di vista sintattico, completa.

È possibile accedere direttamente ad una copia già compilata della documentazione del codice in questo repository.

Approcci alternativi

Chi non intendesse usare il build automation tool può comunque compilare ed eseguire il codice e i test, nonché generare la documentazione, usando la linea di comando, oppure un IDE a sua scelta.

NOTA BENE: nel caso del progetto non sarà valutato alcun codice che presenti errori (o warning) di compilazione (sia nella parte di Java che di Javadoc).

Per questa ragione si consiglia, qualora si decida di usare gli usuali comandi del JDK, di aggiungere sempre le opzioni -Xlint:all -Werror al comando javac e -Xdoclint:all -Werror al comando javadoc (sia da riga di comando che attraverso l'IDE scelto).

È del tutto evidente che il docente non fornirà alcun supporto per l'uso di approcci differenti da quello basato sul build automation tool. suggerito e preconfigurato.

Il materiale degli scorsi anni accademici

Gli studenti che hanno frequentato nei precedenti anno accademici possono trovare il materiale nel

• branch dell'AA 2019/20,
• branch dell'AA 2020/21,
• branch dell'AA 2021/22,
• branch dell'AA 2022/23,
• branch dell'AA 2023/24.