<WEB SERVICE> PROPOSTA DEI SERVIZI

Transcript

1 <WEB SERVICE> PROPOSTA DEI SERVIZI Per I gruppi dedicati al Mobile [Il gruppo Web Service è alla base della comunicazione tra le altre applicazioni (Mobile) per fornire la corretta trasmissione dei dati tramite interfaccia. Permette il collegamento al database principale, dove sono memorizzati i dati richiesti.] Indice Panoramica attività (Paragrafo 1)...Pag.2 Struttura Database...Pag.2 Struttura C#...Pag. 2 Problemi Aperti...Pag. 2 Il codice (Paragrafo 2)...Pag.3 Linguaggio XML...Pag.3 Linguaggio C#...Pag.3/ 4 Esempi Request e Response...Pag. 4 1

2 PANORAMICA ATTIVITA Il gruppo si appoggia al database principale, chiamato HPCOMPLIANCE. Al suo interno, si considera la Stored Procedure chiamata WS_GET_ATTIVITAISTANZE: contiene il Titolo, che fa riferimento all azione che l utente deve compiere in quel momento; Descrizione: rappresenta il messaggio che comparirà al momento dell utilizzo del servizio. Note: eventuali note esterne; Data Inizio: la data che contiene il giorno e l ora prefissata in un dato momento. Struttura Database [Il gruppo ha utilizzato le Stored Procedure come riferimento (i dati contenuti al suo interno sono fondamentali per l impostazione di una sveglia)]. Al suo interno, è stato creato: <Query#1: al suo interno, sono state dichiarate le variabili Username, di tipo string, TimeStamp, di tipo DateTime, e Password, di tipo String.> <InnerJoin#2: è stata utilizzata per unire le tabelle dove erano presenti I dati necessari.> Struttura C# [Per la struttura del programma, sono stati utilizzati diversi componenti.] <Linguaggio XML #1: Il gruppo ha utilizzato questa tipologia di linguaggio per definire la stringa di connessione al database. > <Linguaggio C# #2: Il codice C# scritto ha più funzionalità: - Gestione della connessione al database, appoggiandosi alla stringa di connessione definita con il linguaggio XML (connectionstring) e creando un oggetto SqlDataReader che fa riferimento al comando per connettersi al database, gestito tramite un ciclo while in cui sono letti i dati e mostrati all interno del metodo AttivitaIstanzeEntity nel quale sono state inizializzate le variabili: Titolo, DataInizio, Descrizione, Note. - Gestione delle variabili username, timestamp e password, verificando che non siano occupate come variabili string (metodo string.empty()); Il blocco successivo delle operazioni controlla che la richiesta del contesto di username, timestamp e password non sia ne nulla ne vuota, in questo caso si inserisce nelle variabili (username, timestamp e password) la richiesta. - Gestione di due tipi di status, success e error: con il primo I dati vengono trovati e mostrati in modo corretto, con il secondo viene mostrato un messaggio con l errore commesso nel campo message che può essere di quattro tipi (bad username, bad password, no data found ed impossibile stabilire una connessione con il database).> Problemi Aperti Il gruppo ha completato correttamente l implementazione del codice per la realizzazione del web service, si deve procedere alla pubblicazione. 2

3 IL CODICE Linguaggio XML <add key="connectionstring" value="data Source=hs1dev09; Initial Catalog=hpcompliance; User Id=HPuser; Password=Ciao1234"/> Linguaggio C# FRAMMENTO DI CODICE SqlCommand cmd = _createcommand("ws_get_attivitaistanze", scconn); cmd.parameters.addwithvalue("@username", username); cmd.parameters.addwithvalue("@password", cmd.parameters.addwithvalue("@timestamp", password); timestamp); FUNZIONALITÀ Gestisce la connessione al database, istanziando le variabili Username, Timestamp e Password utilizzate per il login. while (sdr.read()) { } AttivitaIstanzeEntity ai = new AttivitaIstanzeEntity(); ai.titolo = sdr["titolo"].tostring(); ai.datainizio = (DateTime)sdr["DataInizio"]; ai.descrizione = sdr["descrizione"].tostring(); ai.note = sdr["note"].tostring(); lai.add(ai); Finché il programma ha dati da leggere, istanziamo un nuovo oggetto AttivitaIstanzeEntity, che inizializza StandardResponse.Status = "success"; Ogni qualvolta i dati vengono acquisiti, si possono verificare due situazioni: success and error. La situazione di success si verifica quando i dati vengono acquisiti in modo corretto, e visualizzati correttamente. 3

4 StandardResponse.Status = "error"; Ogni qualvolta i dati vengono acquisiti, si possono verificare due situazioni: success and error. La situazione di error si verifica per quattro condizioni: 1) Bad username; 2) Bad password; 3) Cannot connect to database; 4) No data found; 4

5 Request e response Request NAME=pzdiabeteUCC&PASSWORD=pzdiabeteUCC&timestamp= (password = H2efRmTw/HkGXST/w3CYpQ==) Response json: xml: {"Status":"success","Data":[{"Titolo":"Pressione 7:00","Descrizione":"Buongiorno, si misuri la pressione","note":"","datainizio":" t07:00:00"}],"message":""} <note> <status> Success </status> <data> Titolo : Pressione 7:00 Descrizione":"Buongiorno, si misuri la pressione" "DataInizio":" T07:00:00" </data> <message> OK </message> </note> Quando la richiesta è inviata correttamente lo status risulterà Success, nel campo Data ci saranno i dati richiesti e nel campo message sarà presente OK per segnalare che non ci sono stati errori di alcun tipo. 5

6 Request con username errato json: XML: {"Status":"error","Data":null,"Message":"bad username"} <note> <status> Success </status> <data> null </data> <message> bad username </message> </note> Quando l username è errato viene restituito lo status Success, il campo data è NULL e il messaggio esplicita bad username per evidenziare l errore e permettere al client di capire il problema avvenuto. Request con timestamp errato json: XML: {"Status":"error","Data":null,"Message":"impossibile stabilire connessione con database"} <note> <status> error </status> <data> null </data> <message> impossibile stabilire connessione con database </message> </note> Quando il timestamp è errato lo status restituisce error, il campo data è NULL ed il messaggio esplicita impossibile stabilire connessione con database. 6