Programmazione ad Oggetti e Ingegneria del Software (pagina principale)

Progetto di laboratorio

In sintesi

Il progetto deve essere sviluppato individualmente o in coppia - non sono ammessi gruppi con più di due studenti.

Il tema è scelto liberamente dallo studente (o dalla coppia di studenti) e deve essere consegnato almeno 7 giorni prima della prova scritta.

Esso è superato se il voto è di almeno 18/30; il voto rimane valido in qualsiasi sessione di esame successiva a quella in cui il progetto viene consegnato. In caso di consegna tardiva, il progetto non viene accettato.

Qualora il progetto venga riconsegnato in un successivo appello d'esame, il voto del progetto precedentemente consegnato viene annullato ed al voto del nuovo progetto consegnato viene applicata una penale di 5/30.

Nel dettaglio

Consiste nella realizzazione di un programma in C#, seguendo la metodologia di sviluppo software ad oggetti presentata durante il corso.

Il tema del progetto è liberamente scelto dallo studente (o dalla coppia di studenti, se viene realizzato in due).

Il docente non si occupa del debugging dei progetti degli studenti, né durante il ricevimento né via e-mail.

Relazione

La relazione, da scrivere in corretta lingua italiana o inglese, può essere in formato PDF, DOC o RTF e deve contenere le seguenti sezioni:

• SPECIFICA DEL PROBLEMA: riportare una descrizione del tema scelto, immedesimandosi in un dirigente che si rivolge ad un team di sviluppo software e che cerca di essere chiaro e non ambiguo per evitare perdite di tempo e di denaro.

• SPECIFICA DEI REQUISITI: riportare una descrizione dettagliata delle funzionalità dell'applicazione espresse mediante diagrammi dei casi d'uso (Use Cases UML) e relative tabelle.

• ANALISI E PROGETTAZIONE: riportare la struttura ed il funzionamento del programma, indicando le principali scelte di progetto che sono state effettuate.
  La struttura delle classi del programma deve essere rappresentata mediante Class Diagram UML.
  È consigliato l'utilizzo di altri diagrammi UML per illustrare anche gli aspetti relativi alla interazione e al comportamento delle parti più critiche programma.

• IMPLEMENTAZIONE: riportare la stampa ben leggibile dei sorgenti del programma, eventualmente accompagnata da parti di testo che illustrino il funzionamento di alcune sue parti.
  Nota: i file di progetto generati interamente dal compilatore/ambiente di sviluppo non devono essere stampati, ma devono comunque essere allegati al progetto per agevolarne la compilazione.

• TEST: riportare la documentazione dei test condotti sfruttando tecniche di tipo white-box e/o black-box, correlando i test ai casi d'uso presentati nella sezione di "Specifica dei Requisiti".

• COMPILAZIONE ED ESECUZIONE: riportare i requisiti e le istruzioni per compilare ed eseguire il programma, citando in particolare:

  • sistema operativo, con relativa versione e architettura (32 o 64 bit), sul quale l'applicazione può essere compilata ed eseguita;

  • nome e versione dell'ambiente di sviluppo o del compilatore utilizzato;

  • altre risorse, requisiti minimi, librerie software non-standard e/o ulteriori strumenti di sviluppo eventualmente impiegati nel progetto;

  • il nome del file di progetto o la linea di comando utile per la compilazione della applicazione;

  • il nome del file eseguibile o la linea di comando (comprensiva di eventuali argomenti) utile per l'esecuzione della applicazione.

Sviluppo del software

Il software sviluppato in C#:

• Deve essere originale, ovvero non copiato da altri studenti, da siti web, o riciclato da progetti proposti in altri esami

  • • la violazione di questa norma comporta l'annullamento del progetto ed una penale variabile da 3 a 5 punti per gli appelli successivi

• Deve essere compilabile senza che vengano segnalati errori o messaggi di warning.

• Lo studente può scegliere di utilizzare uno tra i seguenti ambienti di sviluppo con licenza d'uso gratuita:

  • • Visual Studio Community 2013, 2015, 2017, 2019 o superiore (ambiente di sviluppo installato in laboratorio);

    • Visual Studio Code, MonoDevelop o Xamarin Studio (free version), se si usano sistemi operativi differenti da Windows.

• Tenendo presente che è possibile sviluppare anche più progetti nella stessa soluzione (ad esempio due applicazioni che condividono la stessa libreria), le uniche tipologie di progetto ammissibili sono le seguenti:

  • • applicazione desktop a finestre (Form) per .NET Framework;

    • applicazione desktop a linea di comando (Console) per .NET Framework;

    • applicazione portabile a linea di comando (Console) per .NET Core;

    • libreria di classi (Class Library) a collegamento dinamico (dll) per .NET Standard, oppure specifica per .NET Framework o per .NET Core, utilizzata da almeno una applicazione fra le suddette;

    • progetto per il test di unità (Unit test o xUnit test) applicato ad una delle applicazioni o librerie suddette.
      Nota: non sono ammesse altre tipologie di progetto perché potrebbero richiedere risorse e strumenti non installati nei PC del laboratorio, rendendo quindi complicata la compilazione ed esecuzione da parte del docente, oppure potrebbero non essere portabili in differenti sistemi operativi - come avviene ad esempio per la tipologia WPF, supportata solo da .NET framework in Windows, ma non da Mono in Linux/MacOsX. Inoltre l'obiettivo principale del progetto d'esame è quello di prendere confidenza con la programmazione ad oggetti, per cui l'introduzione di elementi richiesti da altre tipologie di applicazione (ad esempio web/aspnet, android, iOS, ecc.) porterebbe lo studente a deviare da questo obiettivo, nonché il docente a dover valutare anche elementi inessenziali per la OOP ed estranei alle linee guida qui riportate.

• Se il programma utilizza interfacce grafiche (tipologia di progetto Form), la gestione dei componenti visuali, come bottoni, aree di testo, ecc., e degli eventi ad essi associati deve essere fortemente disaccoppiata dalla logica funzionale (o modello) della applicazione, sfruttando pattern architetturali adeguati, come ad esempio MVC, PAC oppure architetture multi-tier o simili.

  • • Nella valutazione del progetto saranno penalizzate le applicazioni form-centric, ovvero quelle in cui la logica funzionale viene prevalentemente implementata all'interno degli stessi file o classi in cui vengono gestiti i componenti visuali e i relativi eventi.

• Se il programma è a linea di comando (tipologia di progetto Console), la gestione dell'input/output su console deve essere fortemente disaccoppiata dalla logica funzionale (o modello) della applicazione, sfruttando pattern architetturali adeguati (vedere punto precedente).

• È permesso l'uso di librerie esterne, purché provenienti dal sito NuGet, https://www.nuget.org.
  Nota: tali librerie possono essere aggiunte al progetto attraverso l'opportuna utilità integrata nell'ambiente di sviluppo, come illustrato ad esempio in https://docs.microsoft.com/en-us/nuget/tools/package-manager-ui per Visual Studio, oppure in https://blog.xamarin.com/xamarin-studio-and-nuget/ per Xamarin.

• Se si realizza un progetto che richiede un database, l'unico ammesso è SQLite (le cui librerie sono disponibil in NuGet, ad esempio in https://www.nuget.org/packages/System.Data.SQLite.Core/).
  Nota: due motivi alla base della scelta di SQLite sono che esso (1) permette la portabilità della applicazione su diversi sistemi operativi, (2) non richiede l'installazione di sistemi di gestione attivi e separati dalla applicazione, ovvero DBMS quali MS SQL Server, MySql o altri.

  • • Nella valutazione del progetto saranno penalizzate le applicazioni con architettura fortemente database-centric, ovvero quelle in cui la gestione del DB prevale sulla programmazione ad oggetti, nelle quali sono implementate classi utili soltanto per contenere dati e vengono trascurati i principi fondamentali della OOP, quali l'ereditarietà e il polimorfismo.

• Deve essere leggibile, ovvero:

  • • privo di scelte di progetto non descritte nella relazione

    • privo di identificatori non evocativi di ciò che rappresentano

    • ben strutturato

    • ben commentato

    • ben indentato

    • ben spaziato

• [FONDAMENTALE] Deve essere basato sui principi della programmazione ad oggetti:

  • • incapsulamento e occultamento della informazione (information hiding)

    • ereditarietà

    • polimorfismo

    • [opzionale] È anche consigliato e incoraggiato l'uso di uno o più design pattern fra quelli presentati nel corso

• Deve sfruttare opportunamente i costrutti del linguaggio:

  • • gestione delle eccezioni

    • generics

    • gestione delle strutture dati di alto livello offerte dalla libreria standard (ad esempio "collezioni" come List, Stack, Queue, Dictionary, ecc.)

• Deve essere valido dal punto di vista della qualità del software, con particolare riferimento alle caratteristiche di:

  • • funzionalità

    • affidabilità

    • usabilità

    • efficienza

    • manutenibilità

    • portabilità

Ogni inosservanza di quanto stabilito sopra a proposito della preparazione della relazione e dello sviluppo del software determina una riduzione nel voto attribuito al progetto.

In particolare, l'assenza dei prinicipi della programmazione ad oggetti, fondamentali per questo insegnamento, determina di per sé l'insufficienza del progetto.

Invio del progetto per posta elettronica

Il progetto, comprensivo di relazione, codice sorgente e altri file utili per la compilazione del programma (file di progetto e risorse), deve essere consegnato per posta elettronica al docente con almeno una settimana di anticipo rispetto alla prova scritta mediante un allegato in formato compresso .zip o .rar o .tar.gz o .7z.

Il docente comunica per posta elettronica la valutazione del progetto uno o due giorni prima della prova scritta.

Evitare problemi di invio dell'allegato per posta elettronica:

• Prima di comprimere l'allegato, si consiglia sempre di escludere da esso tutti gli eseguibili/librerie che possono essere rigenerati mediante compilazione del progetto (operazioni di clean o pulisci soluzione), sia per diminuire la dimensione dell'allegato che per evitare problemi di firewall durante la spedizione per posta elettronica.

  • • Poiché l'operazione di clean integrata nell'ambiente di sviluppo Visual Studio (Express) ignora i file di hosting del processo di debug, si consiglia anche di rimuovere manualmente dalla cartella bin tutti gli eseguibili aventi estensione .vshost.exe.

    • In maniera più radicale è possibile cancellare completamente le cartelle bin e obj in quanto verranno entrambe rigenerate durante la compilazione del progetto.
      N.B.: nella cartella bin, di norma, non dovrebbe essere presente alcun file copiato a mano. Copiare manualmente file in tale cartella, infatti, non è una buona pratica, poiché tutti i file del progetto dovrebbero essere inclusi attraverso l'ambiente di sviluppo, eventualmente specificando se devono essere automticamente copiati o meno nella cartella bin durante la compilazione.

    • Se nel progetto sono inclusi librerie o eseguibili precompilati (.dll e .exe) che non possono essere rigenerati mediante compilazione, come ad esempio le librerie di terze parti per gestire l'interazione con il database sqlite, occorre seguire il punto successivo.

• Se l'allegato è particolarmente voluminoso, ovvero occupa più di 3MB di memoria, oppure se include librerie o eseguibili precompilati che NON possono essere rigenerati mediante compilazione, è fortemente consigliato l'uso di servizi come GoogleDrive, DropBox o simili per depositare l'allegato e renderlo accessibile al docente attraverso un link riportato nel testo della mail.

• Qualche minuto dopo aver spedito la mail, controllare sempre che non sia arrivata una risposta avente per oggetto delivery status notification, o qualcosa di simile, per avvisare che la spedizione è fallita oppure che la mail è stata bloccata dal firewall di posta. In tal caso si consiglia di seguire con maggiore attenzione i diversi punti elencati sopra e spedire una nuova mail.

Prova scritta

La prova scritta, che può essere sostenuta solo se il progetto è stato superato, consiste in 6 domande più 1 esercizio - diviso in due parti - da svolgere in 60 minuti.

Essa è superata se il voto è di almeno 18/30; il voto rimane valido solo per l'appello d'esame in cui la prova scritta viene sostenuta.

Prova orale

La prova orale, che può essere sostenuta solo se il progetto e la prova scritta sono stati superati, consiste in una discussione del progetto e della prova scritta, più ulteriori domande.

La prova orale viene effettuata lo stesso giorno della prova scritta.

Se superata, essa determina un aggiustamento compreso tra -3/30 e 3/30 della media dei due precedenti voti, producendo così il voto finale.