Piazza Multicanale. Caso di Studio: Progetto di sistema. Realizzato da: Addante Michele Daddario Fabio De Vito Francesco Cania Lagrotta Piero

Transcript

1 Ingegneria del Software Caso di Studio: Piazza Multicanale Progetto di sistema Realizzato da: Addante Michele Daddario Fabio De Vito Francesco Cania Lagrotta Piero

2 Indice Parte III: Progetto di Sistema 1 Architettura 1.1 Livelli Architetturali Diagramma delle Componenti Diagramma di Configurazione 8 2 Progetto di dettaglio 2.1 Diagramma delle classi presentazione Diagramma delle classi dominio Specifica delle classi presentazione Specifica delle classi dominio Diagrammi di sequenza 36 3 Progetto dei dati 3.1 Database 3.2 Diagramma delle dipendenze dei dati 3.3 Vincoli di progetto 3.4 Modello del database 3.5 Dettaglio dei dati 4 Appendice 4.1 Pattern utilizzati 2

3 Architettura 1.1. Livelli Architetturali 3

4 1.2. Diagramma delle Componenti: presentazione 4

5 1.3. Diagramma delle Componenti: dominio 5

6 1.4. Diagramma delle Componenti: sorgente dati Inserimento dati: E la componente in cui sono racchiuse le classi per mezzo delle quali l utente inserisce i dati da memorizzare nel sistema. La componente comprende: Il form di login, il form di registrazione; Il form di creazione di un nuovo gruppo; Il form di modifica dei dati di un gruppo esistente; Il form di inserimento di un nuovo evento; Il form di modifica di un evento esistente; Il form di selezione gruppo; Il form di iscrizione di un utente ad un gruppo. Le classi contenute all interno della componente utilizzano le interfacce prodotte dalla componente Intercepting Filter e dalla componente Front Controller. Interazione utente: E la componente in cui sono racchiuse le classi per mezzo del quale il sistema accetta i comandi e visualizza le informazioni richieste dall utente. La componente comprende: Pagina di eliminazione degli eventi storici; Pagina di gestione dei gruppi; Modulo di eliminazione dei gruppi; Modulo di eliminazione degli eventi; Modulo di invio delle ; Modulo di invio degli SMS; Pagina di visualizzazione calendario per mese; Pagina di visualizzazione calendario per settimane; Pagina di visualizzazione calendario per giorno; Pop-up visualizzazione evento Selezione Lingua Accesso alla guida in linea. 6

7 Le classi contenute all interno della componente utilizzano le interfacce prodotte dalla componente Front Controller. Intercepting Filter: Nel sistema è la componente che si occupa di verificare la compatibilità dei dati inseriti dall utente con il dominio applicativo. Se i dati sono conformi provvede ad inoltrarli al sistema utilizzando le interfacce prodotte dalla componente Front Controller, altrimenti restituisce alle componenti che l hanno invocata il messaggio d errore. Front Controller: Nel sistema è la componente che si occupa di intercettare le richieste provenienti dal livello di presentazione ed inoltrarle verso il livello di dominio utilizzando l interfaccia offerta dalla componente Business Delegate. Business Delegate: E la componente che si occupa di intercettare le richieste dirette al livello di Dominio e smistarle tramite l interfaccia prodotta dalla componente Facade alle classi contenute nel livello. Facade: E la componente che racchiude tutti i moduli per mezzo dei quali il sistema svolge tutte le operazioni. Sono incluse al suo interno: crea_gruppo_facade; login_facade; visualizzazione_calendario_facade; _manager_facade; inserisci_evento_facade; sms_manager_facade; gestione_selezione_gruppo_facade; elimina_evento_facade; registrazione_facade; eventi_storici_facade; modifica_evento_facade; visualizza_evento_facade; Le classi contenute all interno della componente utilizzano le interfacce prodotte dalla componente Data Mapper. Data Mapper: E la componente che si occupa di intercettare le richieste di accesso ai dati provenienti dalla componente Facade e di smistarle verso la componente Entity usando l interfaccia da essa prodotta. Entity: E la componente che si occupa dell accesso al livello Sorgente Dati. Riceve le richieste dal Data Mapper ed invia le query al DBMS. Questa componente contiene i metodi per istanziare ed utilizzare gli oggetti delle seguenti classi: user gruppi user_eventi user_iscritto al gruppo sms 1.4.Diagramma di configurazione 7

8 Progetto di dettaglio 8

9 2. Diagramma delle Classi: Presentazione 9

10 10

11 11

12 2.2. Diagramma delle Classi: Dominio 12

13 13

14 2.3. Specifiche delle Classi:Presentazione Nome Classe: BOUNDARY Mostra Gruppi Livello Architetturale: Presentazione Istanziata da: nessuna classe Istanzia: front controller visualizza_gruppo(); Descrizione: È la classe boudary responsabile della visualizzazione delle informazioni di un gruppo. Nome Classe: BOUNDARY Form Iscrizione Gruppo Livello Architetturale: Presentazione Istanziata da: nessuna classe Istanzia: front controller settaggio_opzioni_sms_ed_ (); Descrizione: Permette di settare le opzioni di ricezione sms ed durante l iscrizione ad un gruppo. Nome Classe: BOUNDARY Form Creazione Gruppo Livello Architetturale: Presentazione Istanziata da: nessuna classe Istanzia: intercepting filter inserimento_nome_gruppo(); inserimento_descrizione_gruppo(); inserimento_immagine_gruppo(); Descrizione: Tramite questa classe, l amministratore può inserire i dati del nuovo gruppo da creare nell apposito form contenente un numero fisso di campi da compilare. 14

15 Nome Classe: BOUNDARY Form Modifica Gruppo Livello Architetturale: Presentazione Istanziata da: nessuna classe Istanzia: intercepting filter accesso_al_form_di_modifica(); modifica_info_gruppo(); Descrizione: Visualizza le informazioni del gruppo che si vuole modificare inserendole negli appositi campi del form di modifica, permettendo all amministratore di apportare modifiche per ciascuno dei campi del form. Nome Classe: BOUNDARY Cancella Gruppo Livello Architetturale: Presentazione Istanziata da: nessuna classe Istanzia: front controller cancella_gruppo(); Descrizione: E la classe boundary responsabile di richiedere la cancellazione del gruppo scelto. Nome Classe: BOUNDARY Form Login Livello Architetturale: Presentazione Istanziata da: nessuna classe Istanzia: intercepting filter inserimento username() inserimento password() Metodi privati Descrizione: È la classe boundary che gestisce la visualizzazione del form di login e permette al visitatore di inserire username e password necessari all autenticazione. 15

16 Nome Classe: BOUNDARY Form Registrazione Livello Architetturale: Presentazione Istanziata da: nessuna classe Istanzia: intercepting filter inserimento username() inserimento password() inserimento password2() inserimento nome() inserimento cognome() inserimento () inserimento numero telefono() inserimento data() inserimento sesso() Descrizione: ha il compito di visualizzare il form di registrazione Nome Classe: BOUNDARY Form di inserimento evento Livello Architetturale: Presentazione Istanziata da: nessuna classe Istanzia: front controller inserimento titolo() inserimento descrizione() inserimento contatti() inserimento immagine() inserimento giorno() inserimento mese() inserimento anno() inserimento opzioni() Descrizione: ha il compito di visualizzare il form di inserimento evento Nome Classe: BOUNDARY Eventi storici Livello Architetturale: Presentazione Istanziata da: nessuna classe Istanzia: front controller accesso agli eventi storici() conferma eliminazione eventi storici() rifiuta eliminazione eventi storici() Descrizione: È la classe boundary che permette all amministratore di visualizzare gli eventi storici 16

17 Nome Classe:BOUNDARY Menù gruppi Livello Architetturale: Presentazione Istanziata da: nessuna classe Istanzia: front controller Accesso_menù_gruppi Seleziona_gruppo Descrizione: È la classe boudary responsabile della visualizzazione di un menù dove sono elencati i gruppi attivi nel calendario; permette inoltre di selezionare uno dei gruppi visualizzati nel menù Nome Classe:BOUNDARY Vista giorno Livello Architetturale: Presentazione Istanziata da: nessuna classe Istanzia: front controller Richiesta_eventi_giorno_corrente Richiesta_eventi_giorno_successivo Richiesta_eventi_giorno_precedente Descrizione: È la classe boudary responsabile della visualizzazione degli eventi la cui data corrisponde con quella del giorno in cui si sta utilizzando il sistema ( in alternativa precedente o successiva alla data visualizzata). Inoltre verranno visualizzati solo gli eventi appartenenti al gruppo precedentemente selezionato dall utente generico. Nome Classe:BOUNDARY Vista settimana Livello Architetturale: Presentazione Istanziata da: nessuna classe Istanzia: front controller Richiesta_eventi_settimana_corrente Richiesta_eventi_settimana _successivo Richiesta_eventi_settimana _precedente Descrizione: È la classe boudary responsabile della visualizzazione degli eventi la cui data appartiene alla settimana corrente. E possibile anche visualizzare gli eventi che appartengono alla settimana immediatamente precedente o successiva a quella visualizzata. Inoltre verranno visualizzati solo gli eventi appartenenti al gruppo precedentemente selezionato dall utente generico. 17

18 Nome Classe:BOUNDARY Vista mese Livello Architetturale: Presentazione Istanziata da: nessuna classe Istanzia: front controller Richiesta_eventi_mese_corrente Richiesta_eventi_mese_successivo Richiesta_eventi_mese _precedente Descrizione: È la classe boudary responsabile della visualizzazione degli eventi la cui data appartiene alla mese corrente. E possibile anche visualizzare gli eventi che appartengono al mese immediatamente precedente o successivo a quello visualizzato. Inoltre verranno visualizzati solo gli eventi appartenenti al gruppo precedentemente selezionato dall utente generico. Nome Classe: Pop Up Evento Livello Architetturale: Presentazione Istanziata da: nessuna classe Istanzia: Front Controller VisualizzaEvento Descrizione: E la classe Boundary responsabile della visualizzazione degli eventi; è messa a disposizione dell attore Utente Generico. Nome Classe: Elimina Evento Livello Architetturale: Presentazione Istanziata da: nessuna classe Istanzia: Front Controller RichiestaCancellazioneEvento Descrizione: E la classe Boundary responsabile della cancellazione degli eventi; è messa a disposizione dell attore Amministratore. 18

19 Nome Classe: Form Modifica Evento Livello Architetturale: Presentazione Istanziata da: nessuna classe Istanzia: Intercepting Filter VisualizzaFormModificaEvento InserisciTitolo Inserisci_Descrizione InserisciContatti InserisciImmagine InserisciGiorno InserisciMese InserisciAnno InserisciOpzioniSms Descrizione: E la classe Boundary responsabile della modifica dei dati relativi ad un evento precedentemente inserito; è messa a disposizione dell attore Amministratore. Nome Classe: Visualizza SMS per domani Livello Architetturale: Presentazione Istanziata da: nessuna classe Istanzia: Front Controller VisualizzaSmsPerDomani ConfermaInvioSms RifiutaInvioSms Descrizione: E la classe Boundary responsabile della visualizzazione del conteggio e dell invio degli SMS di tutti gli eventi previsti per il giorno successivo a quello corrente suddivisi per evento e gruppo di appartenenza; è messa a disposizione dell attore Amministratore. Nome Classe: Visualizza per domani Livello Architetturale: Presentazione Istanziata da: nessuna classe Istanzia: Front Controller Visualizza PerDomani ConfermaInvio RifiutaInvio Descrizione: E la classe Boundary responsabile della visualizzazione del conteggio e dell invio delle di tutti gli eventi previsti per il giorno successivo a quello corrente suddivisi per evento e gruppo di appartenenza; è messa a disposizione dell attore Amministratore. 19

20 Nome Classe: Intercepting Filter Livello Architetturale: Presentazione Istanziata da: Form Creazione Gruppo, Form Modifica Gruppo, Menù gruppi, Form login; Form registrazione; Form di inserimento evento, FormModificaEvento. Istanzia: front controller, filtro selezione gruppo, filtro campi vuoti, filtro immagine, filtro password, Filtro Titolo Vuoto, Filtro Giorno Vuoto, Filtro Mese Vuoto, Filtro Anno Vuoto, Filtro Descrizione Vuoto, Filtro Contatti Vuoto, Filtro Controllo Grandezza, Filtro Controllo Estensione invio_info_gruppo(); get_info_gruppo(); Controllo_selezione_gruppo(); controllo_inserimento_dati(); controllo dati login() controllo dati di registrazione() inserisci evento intercepting filter () filtro inserisci evento() modifica evento intercepting filter() Descrizione: E la classe boundary responsabile del controllo dei campi inseriti dall amministratore nella creazione e modifica dei gruppi. Nome Classe: Filtro Campi Vuoti Livello Architetturale: Presentazione Istanziata da: Intercepting Filter Istanzia: Metodi pubici Controllo_campi_vuoti_login() controllo_campi_vuoti_reg(); controllo_campi_vuoti_gruppo() controllo_data_vuoto() controllo_nome_gruppo(); controllo_descrizione_gruppo(); controllo_immagine_vuota(); controllo_username_vuota(); controllo_password_vuota(); controllo_password2_vuota(); controllo_nome_vuoto(); controllo_cognome_vuoto(); controllo_ _vuota(); controllo_numero_telefono_vuoto(); controllo_sesso_vuoto(); giorno_vuoto(); mese_vuoto(); anno_vuoto(); titolo_vuoto(); descrizione_vuota(); controllo_contatti_vuoto(); 20

21 descrizione_grande() immagine_vuota() Descrizione: E la classe boundary responsabile del controllo dei campi vuoti. Nome Classe: Filtro Immagine Livello Architetturale: Presentazione Istanziata da: Intercepting Filter Istanzia: controllo_immagine(); controllo_immagine_p(); ImmagineVuoto controllo_dimensione(); controllo_estensione(); Descrizione: L immagine inserita non deve essere maggiore di 100 kb e deve avere solo le seguenti estensioni:.jpg,.bmp,.gif,.png Nome Classe: filtro selezione gruppo Livello Architetturale: Presentazione Istanziata da: intercepting filter Istanzia: filtro selezione gruppo() controllo selezione errata() Descrizione: Controlla se l utente generico seleziona correttamente un gruppo! La selezione non è corretta se l utente clicca sul tasto submit senza selezionare alcun gruppo. Nome Classe: filtro password Livello Architetturale: Presentazione Istanziata da: intercepting filter Istanzia: controllo_password() controllo_password_uguali() Descrizione: Tale filtro verifica che le due password inserite coincidano 21

22 Nome Classe: Filtro Titolo Vuoto Livello Architetturale: Presentazione Istanziata da: Campi Vuoti Istanzia: TitoloVuoto() Descrizione: E la classe control che si occupa di controllare se il campo del titolo dell evento è stato lasciato vuoto dall utente che inserisce o modifica un evento. Nome Classe: Filtro Descrizione Vuoto Livello Architetturale: Presentazione Istanziata da: Campi Vuoti Istanzia: DescrizioneVuoto() Descrizione: E la classe control che si occupa di controllare se il campo della descrizione dell evento è stato lasciato vuoto dall utente che inserisce o modifica un evento. Nome Classe: Filtro Contatti Vuoto Livello Architetturale: Presentazione Istanziata da: Campi Vuoti Istanzia: ContattiVuoto() Descrizione: E la classe control che si occupa di controllare se il campo dei contatti dell evento è stato lasciato vuoto dall utente che inserisce o modifica un evento. Nome Classe: Filtro Giorno Vuoto Livello Architetturale: Presentazione Istanziata da: Campi Vuoti Istanzia: GiornoVuoto() Descrizione: E la classe control che si occupa di controllare se il campo del giorno dell evento è stato lasciato vuoto dall utente che inserisce o modifica un evento. 22

23 Nome Classe: Filtro Mese Vuoto Livello Architetturale: Presentazione Istanziata da: Campi Vuoti Istanzia: MeseVuoto() Descrizione: E la classe control che si occupa di controllare se il campo del mese dell evento è stato lasciato vuoto dall utente che inserisce o modifica un evento. Nome Classe: Filtro Anno Vuoto Livello Architetturale: Presentazione Istanziata da: Campi Vuoti Istanzia: AnnoVuoto() Descrizione: E la classe control che si occupa di controllare se il campo dell anno dell evento è stato lasciato vuoto dall utente che inserisce o modifica un evento. Nome Classe: Filtro Controllo Grandezza Livello Architetturale: Presentazione Istanziata da: Controllo Immagine Istanzia: ControllaGrandezza() Descrizione: E la classe control che si occupa di controllare se la grandezza dell immagine inserita è superiore a 100kb. Nome Classe: Filtro Controllo Estensione Livello Architetturale: Presentazione Istanziata da: Controllo Immagine Istanzia: ControllaEstensione() Descrizione: E la classe control che si occupa di controllare se l estensione dell immagine inserita è accettabile. 23

24 Nome Classe: Front Controller Livello Architetturale: Presentazione Istanziata da: Mostra Gruppi, Form Iscrizione Gruppo, Intercepting Filter, Form Modifica Gruppo, Cancella Gruppo, Menù gruppi, Vista Giorno,Vista settimana, Vista mese, Eventi storici, Pop Up Evento, Elimina Evento,Visualizza Sms Per Domani, Visualizza Per Domani. Istanzia: Business Delegate. recupera_nome_gruppo(); recupera_descrizione_gruppo(); recupera_immagine_gruppo(); Memorizza_opzioni_iscrizione(); foward_return(); invio_nome_gruppo(); Seleziona_gruppo() Visualizza_titolo_eventi_giorno_corrente() Visualizza_titolo_eventi_giorno_precedente() Visualizza_titolo_eventi_giorno_successivo() Visualizza_titolo_eventi_settimana_corrente() Visualizza_titolo_eventi_ settimana _precedente() Visualizza_titolo_eventi_ settimana _successivo() Visualizza_titolo_eventi_ mese _corrente() Visualizza_titolo_eventi_ mese _precedente() Visualizza_titolo_eventi_mese_successivo() recupera dati login() invio dati per la registrazione() inserisci evento foward return() invio richiesta eliminazione eventi storici() RichiamaEvento() CancellazioneEvento() RichiamaDatiEvento() Modifica evento forward return() VisualizzaSmsPerDomaniDivisiPerGruppi() CalcolaNumeroSmsDaInviare() InviaTuttiGliSmsEventoSelezionato() NonInviareSmsEventoSelezionato() Visualizza PerDomaniDivisiPerGruppi() CalcolaNumero DaInviare() InviaTutteLe EventoSelezionato() NonInviare EventoSelezionato() Descrizione: Intercetta le richieste dell utente dalle interfacce per inoltrarle a livello di dominio, elabora i dati provenienti dal dominio per visualizzarli all utente. 24

25 2.4. Specifiche delle Classi:Dominio Nome Classe: Business Delegate Livello Architetturale: Dominio Istanziata da: Front Controller Istanzia: Registra Iscrizione Facade, Crea Gruppo Facade, Gestione Dati Facade, Elimina Dati Gruppo Facade, Gestione selezione gruppo facade, Visualizzazione calendario giorno facade, Visualizzazione calendario settimana facade, Visualizzazione calendario mese facade; login facade; registrazione facade; aggiunta evento facade; eventi storici facade, VisualizzaEventoFacade, EliminaEventoFacade, ModificaEventoFacade, SmsManagerFacade, ManagerFacade Data Mapper. fai_prendere_info_gruppo(); fai_memorizzare_opzioni_iscrizione(); fai_gestire_creazione_gruppo(); fai_recuperare_info_gruppo(); fai_inviare_nome_gruppo(); Richiedi_nomi_gruppi() Richiedi_id_gruppo() Richiedi_titolo_eventi_giorno_corrente() Richiedi_ titolo_eventi_giorno_precedente() Richiedi_ titolo_eventi_giorno_successivo() Richiedi _titolo_eventi_settimana_corrente() Richiedi _titolo_eventi_settimana _precedente() Richiedi _titolo_eventi_settimana _successivo() Richiedi _titolo_eventi_mese _corrente() Richiedi _ titolo_eventi_mese_precedente() Richiedi_ titolo_eventi_mese_successivo() fai cercare dati login() fai registrare() fai inserire evento() fai cercare numero eventi storici() fai eliminare gli eventi storici() fai modificare evento() FaiRichiamareEvento() FaiCancellareEvento() FaiRichiamareDatiEvento() FaiInviareDatiEvento() FaiVisualizzareSmsPerDomaniDivisiPerGruppi() FaiCalcolareNumeroSmsDaInviare() FaiInviareTuttiGliSmsEventoSelezionato() NonFareInviareSmsEventoSelezionato() FaiVisualizzare PerDomaniDivisiPerGruppi() FaiCalcolareNumero DaInviare() FaiInviareTutteLe EventoSelezionato() NonFareInviare EventoSelezionato() crypt_pass() Descrizione: Si limita a passare i dati tra il livello della presentazione e quello di dominio. 25

26 Nome Classe: Crea Gruppo Facade Livello Architetturale: Dominio Istanziata da: Business Delegate Istanzia: Data Mapper. gestisci_creazione_gruppo(); controllo_se_gia_presente(); Descrizione: Controlla che il gruppo che si vuole creare non sia già presente all interno del database. Se non esiste, allora permette al Data Mapper di inserirlo nel database. Nome Classe: Gestione Dati Facade Livello Architetturale: Dominio Istanziata da: Business Delegate Istanzia: Data Mapper. recupera_info_gruppo(); gestisci_creazione_gruppo(); controllo_se_gia_presente(); Descrizione: E la classe responsabile di recuperare le informazioni di un gruppo e controlla che il nuovo gruppo modificato non sia già presente all interno del database. Se non esiste, allora permette al Data Mapper di inserirlo nel database. Nome Classe: Elimina Dati Gruppo Facade Livello Architetturale: Dominio Istanziata da: Business Delegate Istanzia: Data Mapper. invio_nome_gruppo(); Descrizione: E la classe responsabile di inviare la richiesta di eliminare dal database tutte le informazioni, le iscrizioni degli utenti e gli eventi, del gruppo che si è scelto di cancellare. 26

27 Nome Classe: Gestione selezione gruppo facade Livello Architetturale: Dominio Istanziata da: Business delegate Istanzia: Data mapper Recupera_nomi_gruppo() Recupera _id_gruppo() Controllo_selezione_vuota() Descrizione: Recupera le informazioni per l inserimento dei nomi dei gruppi necessari al menù di selezione gruppo.si occupa anche del recupero del id del gruppo precedentemente selezionato dall utente nel menù di selezione gruppo. Nome Classe: Data mapper Livello Architetturale: Dominio Istanziata da: login facade, registrazione facade, aggiunta evento facade, eventi storici facade, gestione dati facade, business delegate, crea gruppo facade, gestione dati facade, elimina dati gruppo facade, gestione selezione gruppo facade,visualizzazione calendario_giorno facade, visualizzazione calendario_settimana facade, visualizzazione calendario_mese facade, VisualizzaEventoFacade, EliminaEventoFacade, ModificaEventoFacade, SmsManagerFacade, ManagerFacade Istanzia: gruppi, user iscritto al gruppo, user eventi, SMS, , User. prendi_info_gruppo(); inserimento_iscrizione_utente(); lettura_gruppi_esistenti(); inserimento_dati_gruppo(); prendi_dati_registrazione_gruppo(); cancella_struttura_dati_gruppo(); lettura dati login() lettura dati registrazione() inserisci dati registrazione() lettura numero eventi storici() lettura eventi storici() elimina eventi storici() elimina_ () elimina_sms() elimina_evento() estrai id_evento () inserisci evento() modifica immagine() inserisci sms() inserisci () richiesta_nomi_gruppo() richiesta_id_gruppo() richiesta_titolo_eventi_giorno_corrente() richiesta_titolo_eventi_giorno_precedente() richiesta_titolo_eventi_giorno_successivo() 27

28 richiesta_titolo_eventi_settimana_corrente() richiesta_titolo_eventi_settimana_precedente() richiesta_titolo_eventi_settimana_successiva() richiesta_titolo_eventi_mese_corrente() richiesta_titolo_eventi_mese_precedente() richiesta_titolo_eventi_mese_successivo() RitrovaEvento() CancSms() Canc () CancEvento() PrelevaEvento() PrelevaOpzioniSms() ModificaEvento() ModificaSms() EstraiEventi() EstraiGruppi() PrelevaUtentiIscrittiAlGruppo() PrelevaNumeriTelefoniciDestinatari() PrelevaDescrizioneEvento() CancellaSms() PrelevaIndirizziDestinatari () Cancella () controllo titolo presente() crea nome immagine() codifica opzioni sms() unlink vecchia immagine() uplink nuova immagine() Descrizione: Collega il livello di dominio con il database, recuperando da esso i dati persistenti del sistema. Nome Classe: Visualizzazione calendario giorno facade Livello Architetturale: Dominio Istanziata da: Business delegate Istanzia: data mapper Recupera_titolo_eventi_giorno_corrente() Recupera_ titolo_eventi_giorno_successivo() Recupera_ titolo_eventi_giorno_precedente() controllo_esistenza_eventi() Descrizione: Recupera le informazioni necessarie al sistema per visualizzare gli eventi la cui data corrisponde a quella in cui si sta navigando( in alternativa precedente o successiva alla data visualizzata). 28

29 Nome Classe: Visualizzazione calendario settimana facade Livello Architetturale: Dominio Istanziata da: Business delegate Istanzia: data mapper Recupera_titolo_eventi_settimana_corrente() Recupera_ titolo_eventi_settimana_successivo() Recupera_ titolo_eventi_settimana_precedente() controllo_esistenza_eventi() Descrizione: Recupera le informazioni necessarie al sistema per visualizzare gli eventi la cui data appartiene alla settimana corrente( in alternativa precedente o successiva alla settimana visualizzata). Nome Classe: Visualizzazione calendario mese facade Livello Architetturale: Dominio Istanziata da: Business delegate, Istanzia: data mapper Recupera_titolo_eventi_mese_corrente() Recupera_ titolo_eventi_mese_successivo() Recupera_ titolo_eventi_mese_precedente() controllo_esistenza_eventi() Descrizione: Recupera le informazioni necessarie al sistema per visualizzare gli eventi la cui data appartiene al mese corrente( in alternativa precedente o successiva al mese visualizzato). Nome Classe: Login facade Livello Architetturale: Dominio Istanziata da: Business delegate Istanzia: user ricerca dati login() controllo username() controllo password() Descrizione: Svolge una funzione di ricerca per i dati di login. 29

30 Nome Classe: Eventi storici facade Livello Architetturale: Dominio Istanziata da: Business delegate Istanzia: data mapper richiedi numero eventi storici() richiedi eliminazione eventi storici() estrazione nome e immagine() elimina () elimina sms() elimina evento() elimina immagine() Descrizione: Svolge una funzione di ricerca per gli eventi storici e il loro numero Nome Classe: Aggiunta evento facade Livello Architetturale: Dominio Istanziata da: Business delegate Istanzia: user eventi inserimento evento() codifica opzioni sms() crea nuova immagine() inserisci immagine() Descrizione: : E il punto di riferimento per tutti i servizi che necessitano di interagire con il database Nome Classe: Registrazione facade Livello Architetturale: Dominio Istanziata da: Business delegate Istanzia: data mapper nessuno delega registrazione() controllo username() controllo password() Descrizione: E il punto di riferimento per tutti i servizi che necessitano di interagire con il database,preoccupandosi di elaborare i dati attenuti dal data mapper per essere utilizzati nel dominio. 30

31 Nome Classe: Visualizza Evento Facade Livello Architetturale: Dominio Istanziata da: Business Delegate Istanzia: Data Mapper PrendiDatiEvento() Descrizione: E la classe Control responsabile del coordinamento delle operazioni necessarie alla visualizzazione di un evento tramite Pop Up. Nome Classe: Elimina Evento Facade Livello Architetturale: Dominio Istanziata da: Business Delegate Istanzia: Data Mapper CancellaEvento() UnlinkImmagine() Descrizione: E la classe Control responsabile del coordinamento delle operazioni necessarie alla cancellazione di un evento. Nome Classe: Modifica Evento Facade Livello Architetturale: Dominio Istanziata da: Business Delegate Istanzia: Data Mapper ChiamaEvento() ModificaDatiEvento() DecodificaOpzioniSms() CreaNomeImmagine() CodificaOpzioniSms() UnlinkVekkiaImmagine() UplinkNUovaImmagine() Descrizione: E la classe Control responsabile del coordinamento delle operazioni necessarie alla modifica dei dati relativi ad un evento precedentemente inserito. 31

32 Nome Classe: Sms Manager Facade Livello Architetturale: Dominio Istanziata da: Business Delegate Istanzia: Data Mapper EstrazioneEventi() ConteggioSms() InvioSms() NonInvioSms() SelezionaGruppiCheHannoEventiPrevistiPerDomani() CalcoloSmsDaInviarePerEventoCorrente() CostruisciInviaSms() Descrizione: E la classe Control responsabile del coordinamento delle operazioni necessarie per il conteggio e l invio degli Sms. Nome Classe: Manager Facade Livello Architetturale: Dominio Istanziata da: Business Delegate Istanzia: Data Mapper EstrazioneEventi() Conteggio () Invio () NonInvio () SelezionaGruppiCheHannoEventiPrevistiPerDomani() Calcolo DaInviarePerEventoCorrente() CostruisciInvia () Descrizione: E la classe Control responsabile del coordinamento delle operazioni necessarie per il conteggio e l invio delle . Nome Classe: Gruppi Livello Architetturale: Dominio Istanziata da: Data mapper Istanzia: get_nomi_gruppo(id_user) get_nomi_gruppo() get_id_gruppo(nome_gruppo) get_info_gruppo(); leggi_gruppi(); inserisci_dati_gruppo(); get_dati_registrazione_gruppo(); cancella_info_gruppo(); 32

33 Descrizione: Classe entity che contiene i dati necessari alla visualizzazione delle informazioni relative ai gruppi attivi nel calendario. In particolare contiene id, nome, descrizione e immagine di ogni gruppo. Nome Classe: User Iscritto al Gruppo Livello Architetturale: Dominio Istanziata da: Data mapper Istanzia: cancella_iscrizione_utenti_al_gruppo(); Descrizione: Classe entity che contiene le informazioni degli utenti iscritti ad un gruppo. Nome Classe: user_eventi Livello Architetturale: Dominio Istanziata da: Data_mapper Istanzia: id_eventi, id_gruppo, id_user, titolo, descrizione, contatti, immagine, giorno, mese, anno, approvato. leggi_numero_eventi_storici() leggi_eventi_storici() estrai id even() del_evento() get_titolo_eventi_giorno_corrente(day,month,year) get_titolo_eventi_giorno_precedente(day,month,year) get_titolo_eventi_giorno_successivo(day,month,year) get_titolo_eventi_settimana_corrente(day,month,year) get_titolo_eventi_settimana_precedente(day,month,year) get_titolo_eventi_settimana_successivo(day,month,year) get_titolo_eventi_mese_corrente(day,month,year) get_titolo_eventi_mese_precedente(day,month,year) get_titolo_eventi_mese_successivo(day,month,year) get_evento() upload_evento() cancella_eventi_del_gruppo(); user_eventi() write_id_eventi(id_eventi) write_id_gruppo(id_gruppo) write_id_user(id_user) write_titolo(titolo) write_descrizione(descrizione) write_contatti(contatti) write_immagine(immagine) write_giorno(giorno) write_mese(mese) write_anno(anno) 33

34 read_id_eventi() read_id_gruppo() read_id_user() read_titolo() read_descrizione() read_contatti() read_immagine() read_giorno() read_mese() read_anno() is_event_approved() approva() disapprova() esiste_evento() put_evento() get_evento(id_evento) update_evento() delete_evento(id_evento) get_eventi_in_data(giorno, mese, anno) componi_query(cod_query, lista) Descrizione: Classe entity che contiene le informazioni degli eventi precedentemente inseriti dagli utenti o dall amministratore. Nome Classe: Sms Livello Architetturale: Dominio Istanziata da: Data Mapper Istanzia: sms() del_sms() read_id_sms() read_id_evento() read_opzioni() write_id_sms(id_sms) write_id_evento(id_evento) write_opzioni(opzioni) get_sms(id_evento) update_sms() delete_sms(id_evento) get_conteggio_sms(id_evento, id_gruppo) put_sms() get_testo_sms(id_evento) upload_sms() put sms() componi_query(cod_query, lista) decodifica_opzioni(opzioni) attributi_utente(row) 34

35 confronto(evento, utente) Descrizione E la classe entity che si occupa di manipolare le informazioni del database relative agli sms. Nome Classe: Livello Architetturale: Dominio Istanziata da: Data Mapper Istanzia: () del_ () read_id_ () read_id_eventi() write_id_ (id_ ) del_ (id_eventi) put_ () get_conteggio_ (id_gruppo) get_body_ (id_evento) upload_ () put () Descrizione: E la classe entity che si occupa di manipolare le informazioni del database relative alle Nome Classe: User Livello Architetturale: Dominio Istanziata da: Data Mapper Istanzia: id_user, login, password, nome, cognome, telefono, , sesso, giorno, mese, anno. get dati login() leggi dati registrazione() put dati registrazione() user() read_id_user() read_login() read_password() read_nome() read_cognome() read_telefono() read_ () read_sesso() read_giorno() read_mese() read_anno() write_id_user(id_user) write_login(login) write_password(password) 35

36 write_nome(nome) write_cognome(cognome) write_telefono(telefono) write_ ( ) write_sesso(sesso) write_giorno(giorno) write_mese(mese) write_anno(anno) get_numeri_telefonici(id_evento, id_gruppo) get_address(id_gruppi) componi_query(cod_query, lista) Descrizione: E la classe entity che si occupa di manipolare le informazioni del database relative agli utenti iscritti al portale 36

37 2.5.Diagrammi di sequenza LOGIN BASE LOGIN ALTERNATIVO 1 37

38 LOGIN ALTERNATIVO 2 REGISTRAZIONE 38

39 REGISTRAZIONE ALTERNATIVO 1 REGISTRAZIONE ALTERNATIVO 2 39

40 REGISTRAZIONE ALTERNATIVO 3 ELIMINAZIONE EVENTI STORICI BASE 40

41 ELIMINAZIONE EVENTI STORICI 1 ELIMINAZIONE EVENTI STORICI 2 41

42 AGGIUNTA EVENTO BASE AGGIUNTA EVENTO alternativo 1 42

43 AGGIUNTA EVENTO alternativo 2 AGGIUNTA EVENTO alternativo 3 43

44 VISUALIZZA CALENDARIO PER GIORNO BASE VISUALIZZA CALENDARIO PER GIORNO ALTERNATIVO 44

45 VISUALIZZA CALENDARIO PER SETTIMANA BASE 45

46 VISUALIZZA CALENDARIO PER SETTIMANA ALTERNATIVO 46

47 VISUALIZZA CALENDARIO PER MESE BASE VISUALIZZA CALENDARIO PER MESE ALTERNATIVO 47

48 SELEZIONE GRUPPO BASE SELEZIONE GRUPPO ALTERNATIVO 1 SELEZIONE GRUPPO ALTERNATIVO 2 48

49 ELENCO EVENTI DEL GRUPPO VISUALIZZAZIONE GRUPPO ISCRIZIONE GRUPPO 49

50 CREAZIONE GRUPPO BASE CREAZIONE GRUPPO ALTERNATIVO 1 50

51 CREAZIONE GRUPPO ALTERNATIVO 2 CREAZIONE GRUPPO ALTERNATIVO 3 51

52 MODIFICA GRUPPO BASE 52

53 MODIFICA GRUPPO ALTERNATIVO 1 MODIFICA GRUPPO ALTERNATIVO 2 53

54 MODIFICA GRUPPO ALTERNATIVO 3 ELIMINA GRUPPO 54

55 MODIFICA EVENTO BASE 55

56 MODIFICA EVENTO ALTERNATIVO 1 56

57 MODIFICA EVENTO ALTERNATIVO 2 MODIFICA EVENTO ALTERNATIVO 3 57

58 VISUALIZZA EVENTO ELIMINAZIONE EVENTO BASE 58

59 ELIMINAZIONE EVENTO ALTERNATIVO INVIO SMS BASE 59

60 INVIO SMS ALTERNATIVO 60

61 INVIO BASE INVIO ALTERNATIVO 61

62 Progetto dei dati 3.1. Database : Diagramma delle dipendenze 62

63 3.2. Database: Modello del database 63

64 3.3. Database:dettaglio dei dati USER CAMPO CHIAVE TIPO DESCRIZIONE #id_user Primaria Integer Identificativo univoco per ogni utente. Login - Stringa Nome univoco per l autenticazione al sistema. Password - Stringa Password segreta per l autenticazione al sistema. Nome - Stringa Nome dell utente. Cognome - Stringa Cognome dell utente. Telefono - Stringa Telefono dell utente. - Stringa dell utente Sesso - Stringa Sesso dell utente. Id_data Esterna Stringa Serve a verificare il giorno, il mese e l anno. DATA CAMPO CHIAVE TIPO DESCRIZIONE #id_data Primaria Integer Identificativo univoco per ogni data. Day - Stringa Indica il giorno. Month - Stringa Indica il mese. Year - Stringa Indica il anno. GRUPPI CAMPO CHIAVE TIPO DESCRIZIONE #id_gruppi Primaria Integer Identificativo univoco per ogni gruppo. Nome - Stringa Indica il nome del gruppo. Descrizione - Stringa Indica la descrizione del gruppo. Immagine - Stringa Indica l immagine del gruppo. 64

65 USER EVENTI CAMPO CHIAVE TIPO DESCRIZIONE #id_eventi Primaria Integer Identificativo univoco per ogni evento. Id_gruppi Esterna Integer Identificativo univoco per ogni gruppo. Id_user Esterna Integer Identificativo univoco per ogni utente. Id_dettaglio_eventi Esterna Integer Identificativo univoco per i dettagli di ogni evento. approvato - Boolean Indica se un evento è stato approvato. DETTAGLIO EVENTI CAMPO CHIAVE TIPO DESCRIZIONE #id_dettaglio_eventi Primaria Integer Identificativo univoco per i dettagli di ogni evento. Titolo - String Indica il titolo di un evento. Descrizione - String Indica la descrizione di un evento. Contact - String Indica i contatti di un evento. Immagine - String Indica l immagine di un evento. Id_data Esterna Integer Identificativo univoco per ogni data. USER ISCRITTO AL GRUPPO CAMPO CHIAVE TIPO DESCRIZIONE #id_gruppi Primaria Integer Identificativo univoco di ogni gruppo. Id_user Esterna Integer Identificativo univoco per ogni 65

66 utente. Opzioni di iscrizione - String Indica le opzioni di iscrizione al gruppo. SMS CAMPO CHIAVE TIPO DESCRIZIONE #id_sms Primaria Integer Identificativo univoco di ogni sms. Id_eventi Esterna Integer Identificativo univoco per ogni evento che deve essere inviato tramite sms.. Opzioni invio sms - String Serve a stabilire a chi deve essere inviato l sms. CAMPO CHIAVE TIPO DESCRIZIONE #id_ Primaria Integer Identificativo univoco di ogni e- mail Id_eventi Esterna Integer Identificativo univoco per ogni evento che deve essere inviato tramite . 66

67 4.1. Pattern utilizzati Appendice 67

68 4.2 Motivazioni La scelta di utilizzare un architettura a tre livelli è stata considerata in seguito alla necessità di dover suddividere l interfaccia utente, di tipo GUI, il livello di dominio e quindi di elaborazione dati, nonché la sorgente dati, quale é il database, a favore della manutenibilità del software. Di conseguenza si è rivelato necessario l utilizzo dei pattern sopra citati, in quanto l Intercepting filter, il Front Controller, il Business Delegate e il Data Mapper svolgono, nel nostro progetto, il compito di intermediari tra i vari livelli. A livello di presentazione, l intercepting filter si occupa di verificare la compatibilità dei dati inseriti dall utente con il dominio applicativo. Se i dati sono conformi provvede ad inoltrarli al sistema attraverso il Front Controller che permette di centralizzare la richiesta dei servizi fatta dall utente. In questo modo abbiamo la possibilità di passare a livello di dominio tutti i dati necessari. A livello di dominio è il business delegate che gestisce gli accessi alle varie classi in maniera centralizzata, secondo le richieste fatte dal livello di presentazione. In questo livello abbiamo utilizzato anche classi control di tipo Facade per dare a esso una gerarchizzazione che rende più efficiente il sistema, dato che saranno le control ad accedere ai servizi delle varie entity, rendendo il software più modulare possibile. In fine è il Data Mapper che gestisce l interazione tra sistema e archivio dati, rendendo indipendenti la logica di business, dalla organizzazione dei dati. Tutto questo a favore oltre che della manutenibilità del software, anche della modularità e dell information hiding. 68