ASTErix

ASTErixIngegneria del software L-ALuca BettelliSara CristoniMatteo PozzaIntroduzioneSi richiede di realizzare il client di un sistema per la gestione della compravendita di oggetti allasta.Collegandosi ad un server remoto, il client deve permettere ad un utente autenticato di visualizzare le aste inserite da altri utenti, creare nuove aste e proporre offerte al rialzo sulle aste in corso.Il server notificher in tempo reale le modifiche avvenute sulle aste, in modo che tutti i client collegati possano mostrare le attivit degli altri utenti che usufruiscono contemporaneamente del servizio.

Documento dei requisitiGli utenti che intendono usufruire dei servizi offerti dal sistema devono essere registrati. Per ciascun utente il sistema conserva il nome, il cognome, lindirizzo e-mail e la password scelta; lindirizzo e-mail e la password verranno richiesti allutente ogni volta che egli intende autenticarsi nel sistema.Lautenticazione, la registrazione e le modifiche effettuale dallutente autenticato sulle aste presenti nel client, verranno inviate dal client stesso ad un Data Base remoto. Un server remoto osserver le modifiche al Data Base remoto e notificher tutti i client in tempo reale.

Documento dei requisitiLutente pu creare unasta specificando una data e ora di inizio e fine e lammontare dei singoli rialzi. Ogni asta mantiene inoltre il prezzo attuale di vendita raggiunto. Per ogni asta lutente pu vendere un solo oggetto, costituito da un nome, una sola categoria di appartenenza, una descrizione dettagliata, un valore stimato ed eventualmente una immagine.Le immagini degli oggetti vengono inserite nel sistema dallutente che ha definito loggetto. Se alloggetto non stata assegnata una immagine il sistema provvede ad associare allasta unimmagine di default.Le categorie (caratterizzate da un nome) raggruppano oggetti con caratteristiche comuni. Sono predefinite nel sistema.Gli utenti possono proporre unofferta per unasta solo dopo che lasta iniziata e solo se non hanno gi fatto lultima offerta per lasta. Il prezzo attuale dellasta, quando questa inizia, coincide con il valore stimato delloggetto in vendita.

Documento dei requisitiLutente che intende proporre unofferta per unasta deve dichiarare un importo pari o superiore al prezzo attuale pi il rialzo specificato dal venditore. Lutente pu altrimenti dichiarare un importo pari al prezzo iniziale delloggetto associato solamente se il primo utente ad effettuare offerte per quellasta.Alla fine dellasta si aggiudica il relativo oggetto lutente che ha fatto lultima offerta: sar il server a notificare allutente venditore lesito dellasta e leventuale nominativo dellutente compratore che si aggiudicato loggetto. In questo modo lutente venditore potr contattare personalmente lutente compratore per il pagamento e la spedizione delloggetto.Se un utente compratore si aggiudicato lasta, loggetto risulta venduto, quindi lasta e loggetto relativo vengono automaticamente rimossi dal Data Base remoto; in caso contrario il venditore potr scegliere se rimuovere lasta o se riproporre lasta reimpostando la data e lora di inizio e fine.

Documento dei requisitiOgni utente pu vedere le aste inserite nel sistema filtrandole in base alla categoria in cui loggetto stato inserito dal venditore.Gli utenti venditori hanno a disposizione un elenco vendite, che mostra landamento delle aste sui suoi oggetti (evidenziando per tutte le aste iniziate il prezzo attuale di vendita).Lutente compratore che ha proposto una o pi offerte per almeno un oggetto in vendita allasta, ha a disposizione un registro offerte, che mostra il prezzo attuale per gli oggetti a cui interessato.

Casi duso: Gestione Aste

Casi duso: Elenco Aste

Scenario 1: Crea AstaDescrizioneUn utente venditore vuole creare unasta per vendere un oggetto.RelazioniAutenticazione, Gestione Aste, Carica immagineAttoriUtentePrecondizioniLutente deve essersi autenticato nel sistemaScenario principale1.1. Lutente specifica i dati delloggetto che vuole vendere fornendo il nome, la descrizione, il valore stimato, scegliendo una categoria tra quelle presenti nel sistema e pu caricare una immagine.1.2. Il sistema verifica che tutti i dati siano stati forniti e che il valore stimato sia un numero valido.1.3. Lutente specifica la data e ora di inizio e fine dellasta e lammontare dei rialzi.1.4. Il sistema verifica che le date e ore fornite siano valide e successive alla data e ora attuale e che il valore stimato sia un numero valido.1.5. Il sistema invia al Data Base remoto i dati delloggetto e i parametri dellasta.Scenari alternativi1.2.a. Lutente non ha inserito tutti i dati Il sistema comunica allutente che servono tutti i dati per proseguire.1.4.a. Lutente non ha inserito una data successiva a quella attuale o la data di fine asta precede la data di inizio Il sistema comunica allutente di inserire una data corretta.1.4.b. Lutente ha inserito un valore stimato minore di 0 o non numerico Il sistema comunica allutente che ha inserito un numero errato.1.5.a. Il Data Base remoto non raggiungibile Il sistema comunica allutente che loperazione non pu essere portata a termine.Scenario 2: Rimuove AstaDescrizioneUn utente venditore vuole eliminare unasta.RelazioniGestione Aste, AutenticazioneAttoriUtentePrecondizioniLutente deve essersi autenticato nel sistemaScenario principale2.1. Lutente seleziona unasta da rimuovere.2.2. Il sistema chiede conferma allutente.2.3. La richiesta di rimozione viene eseguita sul Data Base remoto, quindi lasta e i relativi dati vengono rimossi.Scenari alternativi2.1.a. Lasta che lutente vuole rimuovere in corso Il sistema comunica allutente che non possibile rimuovere unasta in corso.2.2.a. Lutente non conferma la rimozione Lasta non viene rimossa.2.3.a. Il Data Base remoto non raggiungibile Il sistema comunica allutente che loperazione non pu essere portata a termine.Scenario 3: Propone OffertaDescrizioneLutente stabilisce un importo per unasta in corso. RelazioniGestione Aste, AutenticazioneAttoriUtentePrecondizioniLutente deve essersi autenticato nel sistema.Lasta deve essere in corso.Lasta non deve essere stata creata dallutente stesso.Scenario principale3.1. Lutente inserisce limporto desiderato.3.2. Il sistema chiede conferma allutente.3.3. Il sistema controlla che lofferta sia superiore alla massima offerta finora proposta pi il rialzo e che lasta non sia conclusa.3.4. La nuova offerta viene salvata sul Data Base remoto.Scenari alternativi3.2.a. Lutente non conferma linserimento dellimporto Limporto non viene inserito.3.3.a. Lutente ha inserito un importo non numerico o inferiore alla massima offerta finora proposta pi il rialzo Il sistema comunica allutente di inserire un importo superiore allimporto attuale pi il rialzo.3.3.b. Lasta conclusa Il sistema comunica allutente che lasta si conclusa e che non vengono accettate ulteriori offerte.3.4.a. Il Data Base remoto non raggiungibile Il sistema comunica allutente che loperazione non pu essere portata a termine.Scenario 4: Visualizza Aste InseriteDescrizioneIl sistema mostra le categorie disponibili e le aste presenti nella categoria selezionataRelazioniAutenticazione, Elenco AsteAttoriUtentePrecondizioniLutente deve essersi autenticato nel sistemaScenario principale4.1. Il sistema mostra le categorie disponibili leggendole dal Data Base remoto.4.2. Lutente seleziona la categoria di suo interesse.4.3. Il sistema mostra le aste disponibili allinterno della categoria selezionata.4.4. Lutente seleziona unasta tra quelle disponibili.Scenari alternativi4.1.a. Il Data Base remoto non raggiungibile o loperazione non viene terminata completamente Il caricamento delle aste non pu essere eseguito: lapplicazione viene terminata per evitare che vengano eseguite operazioni su un elenco di aste inconsistente.4.3.a. Allinterno della categoria non sono presenti aste Il sistema segnala allutente che non ci sono aste presenti nella categoria.4.4.a. Al momento della selezione lasta non pi disponibile Il sistema comunica allutente che lasta non pi disponibile.Diagramma delle classi di analisiDiagramma di sequenzaSeconda parteDiagramma delle classi di analisi

Diagramma delle classi di analisiNote:La classe Asta contiene le informazioni inerenti allasta che possono variare nel tempo (ad esempio il prezzo attuale).La classe Periodo contiene la data e ora di inizio e fine dellasta e permette di ricavare la durata complessiva dellasta e il tempo rimanente in base alla data e ora attuali.LOggetto associato univocamente ad unasta e non pu essere modificato. Limmagine in esso contenuta, a seconda di cosa stato scelto dallutente, pu essere ImmagineDaUrl o ImmagineDefault.LImmagineDaUrl contiene un link ad unimmagine esterna.LImmagineDefault viene utilizzata nel caso in cui lURL non sia stato indicato dallutente o se lURL non corrisponde ad unimmagine valida.La classe Categoria un aggregato di oggetti ed usata per raggrupparli quando devono essere visualizzati.La classe Utente mantiene le informazioni relative ad un utente del sistema.La classe Offerta associa unasta ad un Utente che ha proposto unofferta.

Diagramma di sequenza

Invio di una offerta al server:Diagramma di sequenza

Ricezione di una offerta dal server:Fase di progettazioneDesign pattern e principi di progettazioneTerza parteFase di progettazione

Il server (che non fa parte del progetto) mantiene le informazioni relative ad aste e offerte allinterno di un Data Base e si occupa di inviare notifiche ai client in seguito a modifiche avvenute sulla base di dati.Il client riceve le notifiche del server attraverso un Controller, che a sua volta invoca le funzioni necessarie allaggiornamento del Model. Il Model scatena degli eventi a cui le View sono registrate, in modo da mostrare le variazioni in tempo reale. I Gestori sono componenti ausiliari usati dal client per inviare i dati sul Data Base del server.

Diagramma classe Asta

Diagramma classe Oggetto

Diagramma classe Categoria

Diagramma classe Offerta

Diagramma Viste

Diagramma Controller

Servizi Aggiornamento DB

Diagramma classe Program

Pattern SingletonIl pattern singleton ha permesso di evitare che le classi ElencoOfferte, ElencoAste ed ElencoCategorie venissero istanziate pi di una volta, generando inconsistenze nel modello e difficolt di aggiornamento.

Pattern Flyweight e FactoryIn base alle specifiche di progetto, loggetto in vendita allasta pu non avere unimmagine associata. In tal caso il sistema deve associare allasta unimmagine di default.Pattern factory: la classe Oggetto mantiene un riferimento allinterfaccia IImmagine, implementata dalle due sottoclassi ImmagineDaUrl e ImmagineDefault. ImmagineFactory crea una delle due sottoclassi di IImmagine in base al valore della stringa URL passata al metodo statico GetImmagine().Pattern flyweight: ImmagineDefault viene creata una sola volta da ImmagineFactory e ne viene restituito il riferimento a tutti gli Oggetti che la richiedono. ImmagineDefault istanziabile soltanto da ImmagineFactory (perch annidata e privata), e viene condivisa simultaneamente da pi clienti indipendenti tra loro (classi Oggetto).

Pattern MVCPer separare pi facilmente le responsabilit delle varie classi del progetto si pensato di suddividere lapplicazione seguendo un modello simile allMVC

Pattern MVCIl Model composto da ElencoAste, ElencoOfferte e ElencoCategorie e contiene tutte le operazioni necessarie per aggiungere e rimuovere aste e offerte dagli elenchi. Le modifiche al modello scatenano gli eventi che possono essere intercettati dalle viste registrate.Le classi AsteInserite, RegistroOfferte, ElencoVendite e DettagliAsta rappresentano il blocco View dello schema. Si occupano di mostrare le aste che rispondono ai requisiti di progetto e reagiscono agli eventi scatenati dalle classi del Model.Il Controller riceve le notifiche dal server e invoca le funzioni delle classi del Model per modificarne lo stato (ad esempio aggiungendo una nuova asta ad ElencoAste).Le classi GestioneAste, GestioneOfferte e GestioneAutenticazione fanno parte del blocco dei Gestori e si occupano di gestire la comunicazione da e per il Data Base (ad esempio, durante la fase di autenticazione, le-mail e la password vengono inviati al DB tramite una query, e il risultato delloperazione determina laccesso al programma).Principio di inversione delle dipendenzePer disaccoppiare il Server dal Client stata aggiunta linterfaccia IController, implementata da ControllerConcreto.Questo accorgimento rende il client pi flessibile e indipendente dalle modifiche eseguite sul server.Inoltre, affiancando o sostituendo ControllerConcreto con altre classi che implementano IController, possibile ricevere le notifiche attraverso diversi mezzi di comunicazione (via TCP/IP, usando .NET Remoting, interrogando il server in polling, ecc.).