Tutorial di configurazione e programmazione di OpenSPCoop. Tutorial di configurazione e programmazione di OpenSPCoop

Transcript

1 i Tutorial di configurazione e programmazione di OpenSPCoop

2 ii Copyright Link.it s.r.l.

3 iii COLLABORATORI TITOLO : Tutorial di configurazione e programmazione di OpenSPCoop AZIONE NOME DATA FIRMA A CURA DI 8 settembre 2009 CRONOLOGIA DELLE REVISIONI POSIZIONE DATA DESCRIZIONE NOME

4 iv Indice 1 Introduzione 1 2 Ambiente di sviluppo 1 3 Presentazione degli scenari di riferimento 2 4 Comunicazione Variazione (oneway) Descrizione formale dell Accordo di Servizio: WSDL e WSBL Configurazione Porta di Dominio e Registro Servizi Configurazioni comuni a tutti gli esempi del tutorial Configurazione del registro dei servizi di OpenSPCoop Programmazione Fruitore: Servizio Applicativo del Comune Modalità trasparente Modalità via Integration Manager Erogatore: Servizio Applicativo del CentroAnagrafico Test e verifica Stato Famiglia (sincrono) Descrizione formale dell Accordo di Servizio: WSDL e WSBL Configurazione Porta di Dominio e Registro Servizi Programmazione Test e verifica Stampa Documento (AsincronoAsimmetrico) Descrizione formale dell Accordo di Servizio: WSDL e WSBL Configurazione Porta di Dominio e Registro Servizi Programmazione Test e verifica Identifica Soggetto (AsincronoSimmetrico) Descrizione formale dell Accordo di Servizio: WSDL e WSBL Configurazione Porta di Dominio e Registro Servizi Programmazione Test e verifica

5 v Elenco delle tabelle 1 Dati autenticazione Registro Servizi Dati Soggetto SPCoop Fruitore Connettore del Soggetto SPCoop fruitore Dati Servizio Applicativo Fruitore Dati del Soggetto SPCoop erogatore Connettore del Soggetto SPCoop erogatore Dati Accordo di servizio Dati Servizio dell Accordo Dati delle azioni del servizio Dati Servizio SPCoop Dati Porta Applicativa Dati Servizio Applicativo Dati invocazione Servizio Applicativo Dati Accordo di servizio Dati Servizio dell Accordo Dati delle azioni del servizio Dati Servizio SPCoop Dati Porta Applicativa Dati Servizio Applicativo Dati invocazione Servizio Applicativo Dati Accordo di servizio Dati Servizio dell Accordo Dati delle azioni del servizio Dati Servizio SPCoop Dati Porta Applicativa Dati Servizio Applicativo Dati invocazione Servizio Applicativo Dati Accordo di servizio Dati Servizio Asincrono Simmetrico nell accordo di servizio Dati Servizio Asincrono Simmetrico Correlato nell accordo di servizio Dati Servizio SPCoop Dati Servizio SPCoop correlato Dati Porta Applicativa Dati Servizio Applicativo Erogatore Dati Servizio Applicativo Fruitore Dati invocazione Servizio Applicativo erogatore Dati risposta asincrona Servizio Applicativo fruitore

6 1 / 33 1 Introduzione Questa guida documenta le procedure necessarie per la realizzazione di alcuni scenari tipici di Cooperazione Applicativa. Queste procedure riguardano sia l aspetto di cooperazione, con i passi necessari alla configurazione della Porta di Dominio OpenSPCoop, sia quello di integrazione, con lo sviluppo dei servizi applicativi. Nella figura che segue le entità che collaborano nella realizzazione di uno d interazione tra due servizi applicativi in accordo allo standard SPCoop. Nello figura proposta sono identificabili i due domini che intendono scambiare messaggi tra i rispettivi Servizi Applicativi. Le Porte di Dominio fanno da interfaccia pubblica a tali servizi, comunicando tra loro tramite messaggi secondo le specifiche e-gov. Gli aspetti di cooperazione delle Porte di Dominio coinvolte sono specificati in un Accordo di Servizio, contenuto nel Registro dei Servizi. Questo Registro contiene infatti l elenco dei Soggetti abilitati alle comunicazioni SPCoop, l elenco dei servizi erogati da ogni Soggetto e i relativi accordi di servizio. Per dare maggiore efficacia all esposizione dei contenuti si farà riferimento a quattro scenari di esempio che rappresentano casi abbastanza verosimili nell ambito della cooperazione applicativa. 2 Ambiente di sviluppo L ambiente scelto per provare gli scenari di esempio è quello risultante da un installazione Standard di OpenSPCoop. Avremo quindi a disposizione l interfaccia di gestione web Control Station per la configurazione della Porta di Dominio e del Registro dei Servizi. Nota Per semplificare la realizzazione dello scenario ed evitare il proliferare delle installazioni, erogatore e fruitore del servizio appartengono a domini gestiti della solita installazione della Porta di Dominio SPCoop (modalità loopback) Avendo una sola porta di dominio, questa sarà fruitore degli stessi servizi che eroga, ai fini del funzionamento delle sample application a corredo con il tutorial, anche se gli scenari saranno presentati mostrando fruitore ed erogatore come se fossero appartenenti a domini distinti con Porte di Dominio distinte. Per quanto riguarda i soggetti cooperanti si utilizzeranno come esempio: CentroAnagrafico, che rappresenta una generica amministrazione centrale orientata ai servizi anagrafici (soggetto erogatore)

7 2 / 33 Comune, che rappresenta una generica amministrazione locale che richiede dei servizi anagrafici (soggetto fruitore) Il presente tutorial assume che si siano adottate le impostazioni di default per l installazione di JBoss e che quindi i connettori per entrambi i soggetti coincidano e siano uguali a: Suggerimento Per maggiori informazioni sulle modalità di installazione della Porta di Dominio OpenSPCoop, rimandiamo alla lettura della Guida d Installazione La figura seguente schematizza il comportamento di una Porta di Dominio con soggetti multipli 3 Presentazione degli scenari di riferimento Immaginiamo di dover sviluppare una serie di servizi di carattere anagrafico che utilizzino l infrastruttura fornira da OpenSP- Coop per le proprie comunicazioni. Immaginiamo poi che altri servizi, ad esempio quelli di un generico comune, abbiano bisogno di servirsi dei servizi erogati dall Anagrafe. Tra le varie operazioni da implementare supponiamo che ce ne sia una, che chiameremo Comunicazione Variazione, che prevede l invio di un messaggio contenente le informazioni riguardo una modifica nei dati anagrafici di un soggetto, senza aspettarsi messaggi di risposta. Analizziamo quindi le operazioni che fruitore, che chiameremo Comune, ed erogatore dovranno eseguire per realizzare questo scenario. ComunicazioneVariazione: con questa operazione si inviano i dati anagrafici di un soggetto da sostituire a quelli preesistenti. Non richiede nessuna risposta. (Oneway) RichiestaStatoFamiglia: questa operazione permette di recuperare i dati anagrafici di un soggetto. Nella richiesta viene inserito il codice fiscale di un soggetto e nella risposta saranno inclusi di dati di quel soggetto. (Sincrono) StampaDocumento: viene usato per richiedere la stampa di un documento. Poiché è un operazione che può richiedere giorni per essere portata a termine, la richiesta di stampa e il messaggio che conferma il completamento sono consegnati su connessioni distinte. Immaginiamo inoltre che per questa particolare operazione l infrastruttura del centro Anagrafe non consenta connessioni in uscita, quindi entrambe le connessioni saranno aperte dal Comune. (AsincronoAsimmetrico) IdentificaSoggetto: quest operazione permette di risalire ad un soggetto con i dati di un documento qualora non si disponesse di un codice fiscale. Anche in questo caso l operazione può essere lunga da portare a termine, quindi richiesta e risposta vengono comunicate su differenti connessioni. A differenza dell operazione StampaDocumento, immaginiamo che l infrastruttura del centro Anagrafe consenta connessioni in ingresso e in uscita. (AsincronoSimmetrico) Nei prossimi capitoli vedremo in dettaglio come realizzare gli scenari appena descritti analizzando come creare i descrittori dell Accordo di Servizio, come configurare Porta di Dominio e Registro dei Servizi, come programmare il fruitore e l erogatore dei servizi in questione ed infine come effettuare un test di verifica.

8 3 / 33 4 Comunicazione Variazione (oneway) 4.1 Descrizione formale dell Accordo di Servizio: WSDL e WSBL Il primo passo sarà, per l erogatore del servizio, quello di fornire il WSDL che descrive il servizio che si intende erogare. Il WSDL poi dovrà essere partizionato secondo le specifiche del CNIPA. WSDL Definitorio (definitorio.xsd) <xs:schema xmlns:so=" xmlns:xs=" xmlns:xsd=" targetnamespace=" <xs:element name="comunicazionevariazione"> <xs:complextype> <xs:complexcontent> <xs:extension base="so:personatype"> <xs:attribute name="cf" type="so:codicefiscaletype" use="required"/> </xs:extension> </xs:complexcontent> </xs:complextype> </xs:element> <xs:simpletype name="codicefiscaletype"> <xs:restriction base="xs:string"> <xs:pattern value="[a-za-z]{6}\d\d[a-za-z]\d\d[a-za-z]\d\d\d[a-za-z]"/> </xs:restriction> </xs:simpletype> <xs:complextype name="personatype"> <xs:sequence> <xs:element name="nome" type="xs:string"/> <xs:element name="cognome" type="xs:string"/> <xs:element name="codicefiscale" type="so:codicefiscaletype"/> <xs:element name="nascita" type="xs:date"/> <xs:element name="statocivile" type="xs:string"/> </xs:sequence> </xs:complextype> <xs:element name="notifica"> <xsd:complextype> <xsd:sequence> <xsd:element name="comunicazionevariazione" type="so:comunicazionevariazionetype"/> </xsd:sequence> </xsd:complextype> </xs:element> </xs:schema> WSDL Concettuale (concettuale.wsdl). <wsdl:definitions targetnamespace=" xmlns:xsd=" xmlns:soap=" xmlns:spc=" xmlns:wsdl="

9 4 / 33 <wsdl:import namespace=" location="definitorio.xsd" /> <wsdl:message name="comunicazionevariazionerequest"> <wsdl:part element="spc:notifica" name="comunicazionevariazionepart" /> <wsdl:porttype name="comunicazionevariazione"> <wsdl:operation name="notifica"> <wsdl:input message="spc:comunicazionevariazionerequest" /> </wsdl:operation> </wsdl:porttype> </wsdl:definitions> WSDL Logico Erogatore (logicoerogatore.wsdl). <wsdl:definitions targetnamespace=" xmlns:xsd=" xmlns:soap=" xmlns:spc=" xmlns:wsdl=" <wsdl:import namespace=" location="definitorio.xsd" /> <wsdl:message name="comunicazionevariazionerequest"> <wsdl:part element="spc:notifica" name="comunicazionevariazionepart" /> <wsdl:porttype name="comunicazionevariazione"> <wsdl:operation name="notifica"> <wsdl:input message="spc:comunicazionevariazionerequest" /> </wsdl:operation> </wsdl:porttype> </wsdl:definitions> WSDL Logico Fruitore Il fruitore, per realizzare questo scenario, non ha bisogno di esporre nessun servizio, quindi non ha un WSDL che lo descrive. WSDL Implementativo Erogatore (implementativoerogatore.wsdl). <wsdl:definitions targetnamespace=" xmlns:xsd=" xmlns:soap=" xmlns:spc=" xmlns:wsdl=" <wsdl:import namespace=" location="logicoerogatore.wsdl "/> <wsdl:binding name="comunicazionevariazionebinding" type="spc:comunicazionevariazione"> <soap:binding style="document" transport=" <wsdl:operation name="notifica"> <wsdl:input> <soap:body use="literal"/> </wsdl:input> </wsdl:operation> </wsdl:binding> <wsdl:service name="comunicazionevariazioneservice"> <wsdl:port name="comunicazionevariazioneinterfaceendpoint" binding="spc: ComunicazioneVariazioneBinding">

10 5 / 33 <soap:address location=" </wsdl:port> </wsdl:service> </wsdl:definitions> WSDL Implementativo Fruitore Come per il WSDL Logico Fruitore, non ci sono servizi da implementare per il fruitore del servizio in questo scenario. WSBL Dal momento che lo scenario prevede solo un operazione di tipo Oneway, non c è bisogno di definire alcun WSBL. 4.2 Configurazione Porta di Dominio e Registro Servizi Configurazioni comuni a tutti gli esempi del tutorial Le operazioni descritte in questo paragrafo forniscono entità (soggetti, servizi...) utili per tutti i profili di collaborazione che verranno configurati successivamente. 1. Configuriamo il registro dei servizi attraverso l apposita interfaccia web reperibile all indirizzo Identifichiamoci con diritti di amministratore: Login Password amministratore secret Tabella 1: Dati autenticazione Registro Servizi Una volta effettuato il login, nel menù a sinistra sono elencate le operazioni di modifica e visualizzazione della configurazione. 2. Creazione del Soggetto SPCoop Comune avente il ruolo di fruitore negli esempi del tutorial: Aggiungiamo il soggetto che fruirà del servizio ComunicazioneVariazione. Comune Tabella 2: Dati Soggetto SPCoop Fruitore (a) Selezionare aggiungi nel menù Soggetti SPCoop (b) Utilizzare la form per inserire i parametri del soggetto fruitore del servizio

11 6 / 33 Nota Se non viene indicato il nome della Porta di dominio che ospita il soggetto, viene usato il valore di default: [_Soggetto]SPCoopIT. (c) Premere il pulsante Invia 3. Impostazione del connettore relativo al Soggetto SPCoop Comune. URL Tabella 3: Connettore del Soggetto SPCoop fruitore (a) Dalla lista dei soggetti selezionare visualizza relativamente alla riga del soggetto Comune in corrispondenza della colonna Connettore (b) Utilizzare la form per inserire il valore del connettore (c) Premere il pulsante Invia 4. Creazione del Servizio Applicativo Comune_SA utilizzato per l integrazione del client fruitore nei primi tre scenari: Comune_SA Soggetto SPCoop SPC/Comune Invocazione porta / tipo basic Utente Comune_SA Password Modalità di fault soap Tabella 4: Dati Servizio Applicativo Fruitore (a) Selezionare aggiungi nel menù Servizi Applicativi (b) Utilizzare la form per inserire i parametri del servizio applicativo fruitore (c) Premere il pulsante Invia 5. Creazione del Soggetto SPCoop CentroAnagrafico avente il ruolo di erogatare dei servizi di esempio del tutorial. CentroAnagrafico Tabella 5: Dati del Soggetto SPCoop erogatore

12 7 / 33 (a) Dalla lista dei soggetti selezionare visualizza relativamente alla riga del soggetto Comune in corrispondenza della colonna Connettore (b) Utilizzare la form per inserire il valore del connettore (c) Premere il pulsante Invia 6. Impostazione del connettore relativo al Soggetto SPCoop CentroAnagrafico. URL Tabella 6: Connettore del Soggetto SPCoop erogatore (a) Dalla lista dei soggetti selezionare visualizza relativamente alla riga del soggetto CentroAnagrafico in corrispondenza della colonna Connettore (b) Utilizzare la form per inserire il valore del connettore (c) Premere il pulsante Invia Configurazione del registro dei servizi di OpenSPCoop Una volta creati i descrittori (WSDL) del servizio, possiamo procedere con la creazione dell accordo di servizio nella Control Station. 1. Creazione dell Accordo di Servizio Referente WSDL Definitorio WSDL Concettuale WSDL Logico Erogatore AS_ComunicazioneVariazione SPC/CentroAnagrafico definitorio.xsd concettuale.wsdl logicoerogatore.wsdl Tabella 7: Dati Accordo di servizio (a) Selezionare aggiungi nel menù Accordi servizio (b) Utilizzare la form per inserire i vari parametri dell Accordo

13 8 / Aggiungiamo il Servizio all Accordo: il nome del servizio dovrà avere lo stesso nome del PortType indicato nel WSDL Concettuale. Profilo ComunicazioneVariazione oneway Tabella 8: Dati Servizio dell Accordo (a) Dalla lista degli Accordi di Servizio, selezionare visualizza nella colonna servizi in corrispondenza dell Accordo creato al punto precedente. (b) Selezionare aggiungi e completare la form per l aggiunta di un nuovo servizio. 3. Specifichiamo le azioni del Servizio: le azioni del Servizio corrispondono alle Operation specificate nel WSDL Notifica Tabella 9: Dati delle azioni del servizio (a) Dalla lista degli Accordi di Servizio, selezionare visualizza nella colonna servizi in corrispondenza dell Accordo creato al punto precedente. (b) Selezionare visualizza nella colonna azioni in corrispondenza del servizio ComunicazioneVariazione

14 9 / 33 (c) Selezionare aggiungi e completare la form per l aggiunta di una nuova azione. 4. Aggiungere il servizio SPCoop: Soggetto SPCoop Accordo Servizio Servizio WSDL Implementativo Erogatore SPC/CentroAnagrafico AS_ComunicazioneVariazione ComunicazioneVariazione implementazioneerogatore.wsdl Tabella 10: Dati Servizio SPCoop (a) Nella sezione Servizi SPCoop selezionare Aggiungi. (b) Utilizzare la form per inserire i parametri del Servizio SPCoop (c) Premere il pulsante Invia 5. Aggiungere il soggetto fruitore alla lista dei soggetti che possono fruire del servizio: l installazione standard di OpenSP- Coop attiva di default l autenticazione SPCoop che controlla se il fruitore di un servizio compare nella lista dei fruitori. Per superare questo controllo dobbiamo quindi aggiungere il soggetto Comune ai fruitori del servizio ComunicazioneVariazione (a) Nell elenco dei Servizi SPCoop individuare il servizio ComunicazioneVariazione e selezionare visualizza nella colonna Fruitori: (b) Selezionare Add ed utilizzare la form per inserire i parametri del soggetto fruitore del servizio

15 10 / 33 (c) Premere il pulsante Invia Nota Si tenga presente che l operazione descritta in questo passaggio comporta la creazione automatica di una porta delegata associata al soggetto fruitore appena aggiunto. La porta delegata viene inizializzata con dei valori di default che vanno bene in molti casi. Se si vogliono modificare tali impostazioni si deve procedere con la modifica della porta delegata individuabile nella lista per ciascun soggetto SPCoop. 6. Aggiungere nelle politiche sicurezza il servizio applicativo autorizzato ad invocare il servizio. Quersto passaggio è essenziale ai fini dell autenticazione da parte del servizio applicativo in fase di invocazione della porta delegata. (a) Dall elenco dei fruitori del servizio, in corrispondenza del soggetto Comune, nella colonna politiche sicurezza selezionare visualizza, quindi il pulsante Aggiungi (b) Compilare il form selezionando il servizio applicativo Comune_SA dalla lista a discesa e confermando con il pulsante Invia (c) Premere il pulsante Invia Nota L operazione descritta in questo passaggio, creerà automaticamente un associazione tra il servizio applicativo e la porta delegata creata automaticamente al passo precedente. 7. Aggiungere la Porta Applicativa: aggiungiamo al soggetto SPC/CentroAnagrafico la porta applicativa che si occuperà dello sbustamento delle richieste e-gov dei fruitori e di consegnarle al servizio applicativo erogato. Validazione Contenuti Stateless Gestione Body Gestione Manifest Servizio SPCoop Azione ComunicazioneVariazione_PA disabilitato default none abilitato ComunicazioneVariazione Notifica Tabella 11: Dati Porta Applicativa (a) Selezionare aggiungi nel menù Porte Applicative (b) Utilizzare la form per inserire i parametri della Porta Applicativa per il soggetto CentroAnagrafico.

16 11 / 33 (c) Premere il pulsante Invia 8. Aggiungere il Servizio Applicativo Erogatore: Soggetto SPCoop Tipo invocazione Modalità fault ComunicazioneVariazione_SA CentroAnagrafico nessuna soap Tabella 12: Dati Servizio Applicativo (a) Selezionare aggiungi nel menù Servizi Applicativi (b) Utilizzare la form per inserire i parametri del Servizio Applicativo. (c) Premere il pulsante Invia 9. Impostare i parametri di invocazione del Servizio Applicativo: Sbustamento Get message Connettore abilitato Url connettore Tipo credenziali d accesso ComunicazioneVariazione_SA no disabilitato si none Tabella 13: Dati invocazione Servizio Applicativo (a) Abilitare l invocazione del servizio ComunicazioneServizio_SA dall elenco dei Servizi Applicativi (b) Utilizzare la form per inserire i parametri del Servizio Applicativo. (c) Premere il pulsante Invia 10. Associare alla Porta Applicativa il Servizio Applicativo Erogatore:

17 12 / 33 (a) Dall elenco dei Soggetti SPCoop visualizzare le Porta Applicative associati al soggetto SPC/CentroAnagrafico. Selezionare ComunicazioneVariazione_PA e quindi visualizzare l elenco dei Servizi Applicativi (b) Selezionare add. (c) Selezionare il servizio applicativo creato in precedenza. (d) Premere il pulsante Invia 4.3 Programmazione Fruitore: Servizio Applicativo del Comune Modalità trasparente Cominciamo con la programmazione del fruitore. wsdl2java fornito da CXF. Per completare gli esempi sono stati utilizzati gli stub generati dal tool 1 2 ComunicazioneVariazioneService ss = new ComunicazioneVariazioneService(wsdlURL, SERVICE_NAME); 3 ComunicazioneVariazione port = ss.getcomunicazionevariazioneinterfaceendpoint(); 4 5 /* 6 * Imposto la url della porta di dominio come destinazione 7 * Imposto username e password per l autenticazione 8 */ 9 10 ((BindingProvider)port).getRequestContext().put(BindingProvider.ENDPOINT_ADDRESS_PROPERTY, SOAPUrl); 11 ((BindingProvider)port).getRequestContext().put(BindingProvider.USERNAME_PROPERTY, username); 12 ((BindingProvider)port).getRequestContext().put(BindingProvider.PASSWORD_PROPERTY, password); org.openspcoop.example.comunicazionevariazione_type _notifica_comunicazionevariazionepart = new ComunicazioneVariazione_Type(); 15 _notifica_comunicazionevariazionepart.setcf("bbbccc11f11f111f"); port.notifica(_notifica_comunicazionevariazionepart); Modalità via Integration Manager Un altro modo per inviare i messaggi alla Porta di Dominio è quello di utilizzare il servizio di Integration Manager. Generiamo gli stub partendo dal wsdl del servizio: wsdl2java -all ottenuti gli stub possiamo inviare il messaggio di richiesta: QName SERVICE_NAME = new QName(" " IntegrationManagerService"); try{ URL wsdlurl = new URL(...); } catch (MalformedURLException e) {

18 13 / 33 } e.printstacktrace(); try{ String file = "request.xml"; String PD = "ComunicazioneVariazione_PD"; /* * Creo il port per l IntegrationManager */ IntegrationManagerService ss = new IntegrationManagerService(wsdlURL, SERVICE_NAME); IntegrationManager port = ss.getintegrationmanager(); /* * Invoco il servizio invocaportadelegata */ java.lang.string _invocaportadelegata_portadelegata = PD; SPCoopMessage _invocaportadelegata_msg = new SPCoopMessage(); File xmlmessage = new File(file); byte[] msg = new byte[(int)xmlmessage.length()]; FileInputStream strm = new FileInputStream(xmlMessage); strm.read(msg); _invocaportadelegata_msg.setmessage(msg); System.out.println("Invocazione Comunicazione Variazione via Integration Manager..."); System.out.println("Request Message:"); System.out.println(new String(_invocaPortaDelegata_msg.getMessage())); try { SPCoopMessage _invocaportadelegata return = port.invocaportadelegata( _invocaportadelegata_portadelegata, _invocaportadelegata_msg); System.out.println("\n Response Message:"); System.out.println(new String(_invocaPortaDelegata return.getmessage())) ; } catch (SPCoopException_Exception e) { System.out.println("Expected exception: SPCoopException has occurred."); System.out.println(e.toString()); return; } } catch(exception e){ System.out.println("Errore::::" + e); return; } Erogatore: Servizio Applicativo del CentroAnagrafico Il Servizio Applicativo del Centro Anagrafico deve ricevere il messaggio SOAP senza mandare una risposta. un implementazione con gli skeleton generati dal tool wsdl2java di CXF package org.openspcoop.example;

19 14 / 33 servicename = "ComunicazioneVariazioneService", portname = "ComunicazioneVariazioneInterfaceEndpoint", targetnamespace = " wsdllocation = "file:comunicazionevariazione.wsdl", endpointinterface = "org.openspcoop.example.comunicazionevariazione") public class ComunicazioneVariazioneImpl implements ComunicazioneVariazione { public void notifica(comunicazionevariazione_type comunicazionevariazionepart) { try { System.out.println("========== Ricevuta Comunicazione Variazione ==============") ; System.out.println("== Codice fiscale da modificare: " + comunicazionevariazionepart. getcf()); System.out.println(); System.out.println("== Nuovo nome: " + comunicazionevariazionepart.get()); System.out.println("== Nuovo cognome: " + comunicazionevariazionepart.getcognome()); System.out.println("== Nuovo codice fiscale: " + comunicazionevariazionepart. getcodicefiscale()); System.out.println("== Nuova data di nascita: " + comunicazionevariazionepart. getnascita()); System.out.println("== Nuovo stato civile: " + comunicazionevariazionepart. getstatocivile()); } catch (Exception ex) { ex.printstacktrace(); throw new RuntimeException(ex); } } } 4.4 Test e verifica Seguendo le istruzioni fornite con i sorgenti per la configurazione, compilazione ed esecuzione degli esempi, avviamo il test per il servizio ComunicazioneVariazione Il Client invierà il messaggio di richiesta alla Porta Delegata: (Messaggio 1 e 4 in figura) POST /tutorial/ HTTP/1.1 Content-Type: text/xml; charset=utf-8 SOAPAction: tutorial Content-Length: 504 Cache-Control: no-cache Pragma: no-cache User-Agent: Java/1.5.0_11 Host: :8888 Accept: text/html, image/gif, image/jpeg, *; q=.2, */*; q=.2 Connection: keep-alive <soapenv:envelope xmlns:soapenv=" xmlns:xsd=" xmlns:xsi=" <soapenv:body> <Notifica xmlns="

20 15 / 33 <comunicazionevariazione CF="BBBCCC11F11F111F"> <nome>mario</nome> <cognome>rossi</cognome> <codicefiscale>dddfff22g22g222g</codicefiscale> <nascita> t12:00:00.000z</nascita> <statocivile>celibe</statocivile> </comunicazionevariazione> </Notifica> </soapenv:body> </soapenv:envelope> La Porta di Dominio recupera le informazioni necessarie alla gestione della richiesta, riconosce che il tipo di comunicazione è Oneway e si occupa quindi di generare sia la risposta di OK da inviare al client di Comune, sia di imbustare la richiesta da inviare alla Porta di Dominio di destinazione. La risposta inviata al client è questa (Messaggio 2 in figura): HTTP/ OK Server: Apache-Coyote/1.1 X-Powered-By: Servlet 2.4; JBoss GA_CP04 (build: CVSTag= jbossas/tags/jboss_4_0_5_ga_cp04 date= )/tomcat-5.5 SPCoopTipoMittente: SPC SPCoopID: Comune_ComuneSPCoopIT_ _ _10:56 SPCoopServizio: ComunicazioneVariazione SPCoopDestinatario: CentroAnagrafico SPCoopTipoDestinatario: SPC SPCoopAzione: Notifica SPCoopTipoServizio: SPC SPCoopMittente: Comune Content-Length: 0 Date: Thu, 31 Jul :56:56 GMT La Porta di Dominio invia quindi la richiesta alla Porta di Dominio destinataria, nel nostro caso a se stessa, arricchita dell header e-gov (Messaggio 3 in figura): <soapenv:envelope xmlns:soapenv=" xmlns:xsd=" xmlns:xsi=" <soapenv:header> <egov_it:intestazione SOAP_ENV:actor=" SOAP_ENV:mustUnderstand="1" xmlns:soap_env=" xmlns:egov_it=" /"> <egov_it:intestazionemessaggio> <egov_it:mittente> <egov_it:identificativoparte tipo="spc">comune</egov_it:identificativoparte> </egov_it:mittente> <egov_it:destinatario> <egov_it:identificativoparte tipo="spc">centroanagrafico</egov_it: IdentificativoParte> </egov_it:destinatario> <egov_it:profilocollaborazione>egov_it_messaggiosingolooneway</egov_it: ProfiloCollaborazione> <egov_it:servizio tipo="spc">comunicazionevariazione</egov_it:servizio> <egov_it:azione>notifica</egov_it:azione> <egov_it:messaggio> <egov_it:identificatore>comune_comunespcoopit_ _ _12:07</egov_it: Identificatore> <egov_it:oraregistrazione tempo="egov_it_spc"> t12:07:05.897</egov_it: OraRegistrazione> </egov_it:messaggio> <egov_it:profilotrasmissione confermaricezione="false" inoltro=" EGOV_IT_ALPIUUNAVOLTA"/>

21 16 / 33 </egov_it:intestazionemessaggio> <egov_it:listatrasmissioni> <egov_it:trasmissione> <egov_it:origine> <egov_it:identificativoparte tipo="spc">comune</egov_it:identificativoparte> </egov_it:origine> <egov_it:destinazione> <egov_it:identificativoparte tipo="spc">centroanagrafico</egov_it: IdentificativoParte> </egov_it:destinazione> <egov_it:oraregistrazione tempo="egov_it_spc"> t12:07:05.897</egov_it: OraRegistrazione> </egov_it:trasmissione> </egov_it:listatrasmissioni> </egov_it:intestazione> </soapenv:header> <soapenv:body> <comunicazionevariazione CF="BBBCCC11F11F111F" xmlns=" "> <nome>mario</nome> <cognome>rossi</cognome> <codicefiscale>dddfff22g22g222g</codicefiscale> <nascita> t12:00:00.000z</nascita> <statocivile>celibe</statocivile> </comunicazionevariazione> </soapenv:body> </soapenv:envelope> Controllando il file openspcoop.log possiamo verificare il corretto funzionamento della porta: ComuneSPCoopIT.RicezioneContenutiApplicativiWS < T11:18:49.369> (infoopenspcoop) ID:Comune_ComuneSPCoopIT_ _ _11:18 PD:ComunicazioneVariazione_PD SA: Anonimo FR:SPC/Comune -> S:SPC/CentroAnagrafico_SPC/ComunicazioneVariazione_Notifica Ricevuta richiesta di servizio dal Servizio Applicativo Anonimo verso la porta delegata ComunicazioneVariazione_PD ComuneSPCoopIT.InoltroBusteEGov < T11:18:49.476> (infospcoop) ID: Comune_ComuneSPCoopIT_ _ _11:18 PD:ComunicazioneVariazione_PD SA:Anonimo FR:SPC/Comune -> S:SPC/CentroAnagrafico_SPC/ComunicazioneVariazione_Notifica Invio Messaggio SPCoop con identificativo [Comune_ComuneSPCoopIT_ _ _11:18] in corso (location: CentroAnagraficoSPCoopIT.RicezioneBusteEGovWS < T11:18:49.559> (infospcoop) ID: Comune_ComuneSPCoopIT_ _ _11:18 FR:SPC/Comune -> S:SPC/ CentroAnagrafico_SPC/ComunicazioneVariazione_Notifica Ricevuto messaggio SPCoop con identificativo [Comune_ComuneSPCoopIT_ _ _11 :18] inviata dalla parte mittente [SPC/Comune]. CentroAnagraficoSPCoopIT.Sbustamento < T11:18:49.605> (infoopenspcoop) ID: Comune_ComuneSPCoopIT_ _ _11:18 FR:SPC/Comune -> S:SPC/ CentroAnagrafico_SPC/ComunicazioneVariazione_Notifica Ricevuta Busta EGov [Comune_ComuneSPCoopIT_ _ _11:18], con l attributo ALPIUUNAVOLTA nel profilo di trasmissione: Busta salvata nell History delle buste ricevute. CentroAnagraficoSPCoopIT.ConsegnaContenutiApplicativi < T11:18:49.624> (infospcoop ) ID:Comune_ComuneSPCoopIT_ _ _11:18 SA:ComunicazioneVariazione_SA FR:SPC /Comune -> S:SPC/CentroAnagrafico_SPC/ComunicazioneVariazione_Notifica

22 17 / 33 Invio Messaggio SPCoop con identificativo [Comune_ComuneSPCoopIT_ _ _11:18] in corso (location: CentroAnagraficoSPCoopIT.ConsegnaContenutiApplicativi < T11:18:49.635> (infospcoop ) ID:Comune_ComuneSPCoopIT_ _ _11:18 SA:ComunicazioneVariazione_SA FR:SPC /Comune -> S:SPC/CentroAnagrafico_SPC/ComunicazioneVariazione_Notifica Messaggio applicativo con ID [Comune_ComuneSPCoopIT_ _ _11:18], generato dal mittente [SPC/Comune], consegnato al servizio applicativo [ComunicazioneVariazione_SA] mediante connettore [http] (location: con codiceconsegna: 200 ComuneSPCoopIT.InoltroBusteEGov < T11:18:49.703> (infospcoop) ID: Comune_ComuneSPCoopIT_ _ _11:18 PD:ComunicazioneVariazione_PD SA:Anonimo FR:SPC/Comune -> S:SPC/CentroAnagrafico_SPC/ComunicazioneVariazione_Notifica Messaggio SPCoop con identificativo [Comune_ComuneSPCoopIT_ _ _11:18] inviato alla parte destinataria [SPC/CentroAnagrafico] mediante connettore [http] ( location: con codiceconsegna: Stato Famiglia (sincrono) 5.1 Descrizione formale dell Accordo di Servizio: WSDL e WSBL Come per il servizio ComunicazioneVariazione, creiamo un accordo di servizio fornendo i wsdl e wsbl che descrivono il servizio applicativo in questione. I wsdl in questione sono forniti insieme ai sorgenti degli esempi: WSDL Definitorio (definitorio.xsd) <?xml version="1.0" encoding="utf-8"?> <xs:schema xmlns:so=" xmlns:xs=" XMLSchema" xmlns:xsd=" targetnamespace=" openspcoop.org/example"> <xs:simpletype name="codicefiscaletype"> <xs:restriction base="xs:string"> <xs:pattern value="[a-za-z]{6}\d\d[a-za-z]\d\d[a-za-z]\d\d\d[a-za-z]"/> </xs:restriction> </xs:simpletype> <xs:complextype name="personatype"> <xs:sequence> <xs:element name="nome" type="xs:string"/> <xs:element name="cognome" type="xs:string"/> <xs:element name="codicefiscale" type="so:codicefiscaletype"/> <xs:element name="nascita" type="xs:date"/> <xs:element name="statocivile" type="xs:string"/> </xs:sequence> </xs:complextype> <xs:element name="richiestastatofamiglia" type="so:codicefiscaletype"/> <xs:element name="statofamiglia" type="so:personatype"/> </xs:schema> WSDL Concettuale (concettuale.wsdl). <?xml version="1.0" encoding="utf-8"?> <wsdl:definitions targetnamespace=" xmlns:xsd=" xmlns:soap=" xmlns:spc=" xmlns:wsdl="

23 18 / 33 <wsdl:import namespace=" location="definitorio.xsd"> </wsdl:import> <wsdl:message name="statofamigliaresponse"> <wsdl:part name="statofamigliaresponsepart" element="spc:statofamiglia"> <wsdl:message name="statofamigliarequest"> <wsdl:part name="statofamigliarequestpart" element="spc:richiestastatofamiglia"> <wsdl:porttype name="richiestastatofamiglia"> <wsdl:operation name="acquisisci"> <wsdl:input message="spc:statofamigliarequest"> </wsdl:input> <wsdl:output message="spc:statofamigliaresponse"> </wsdl:output> </wsdl:operation> </wsdl:porttype> </wsdl:definitions> WSDL Logico Erogatore (logicoerogatore.wsdl). <?xml version="1.0" encoding="utf-8"?> <wsdl:definitions targetnamespace=" xmlns:xsd=" xmlns:soap=" xmlns:spc=" xmlns:wsdl=" <wsdl:import namespace=" location="definitorio.xsd"> </wsdl:import> <wsdl:message name="statofamigliaresponse"> <wsdl:part name="statofamigliaresponsepart" element="spc:statofamiglia"> <wsdl:message name="statofamigliarequest"> <wsdl:part name="statofamigliarequestpart" element="spc:richiestastatofamiglia"> <wsdl:porttype name="richiestastatofamiglia"> <wsdl:operation name="acquisisci"> <wsdl:input message="spc:statofamigliarequest"> </wsdl:input> <wsdl:output message="spc:statofamigliaresponse"> </wsdl:output> </wsdl:operation> </wsdl:porttype> </wsdl:definitions> WSDL Logico Fruitore Il fruitore, per realizzare questo scenario, non ha bisogno di esporre nessun servizio, quindi non ha un WSDL che lo descrive. WSDL Implementativo Erogatore (implementativoerogatore.wsdl). <?xml version="1.0" encoding="utf-8"?> <wsdl:definitions targetnamespace=" xmlns:xsd=" xmlns:soap=" xmlns:spc=" xmlns:wsdl=" <wsdl:import namespace=" location="logicoerogatore.wsdl "> </wsdl:import> <wsdl:binding name="richiestastatofamigliabinding" type="spc:richiestastatofamiglia"> <soap:binding style="document" transport=" <wsdl:operation name="acquisisci"> <wsdl:input>

24 19 / 33 <soap:body use="literal"/> </wsdl:input> <wsdl:output> <soap:body use="literal"/> </wsdl:output> </wsdl:operation> </wsdl:binding> <wsdl:service name="richiestastatofamigliaservice"> <wsdl:port name="richiestastatofamigliainterfaceendpoint" binding="spc: RichiestaStatoFamigliaBinding"> <soap:address location=" </wsdl:port> </wsdl:service> </wsdl:definitions> WSDL Implementativo Fruitore Come per il WSDL Logico Fruitore, non ci sono servizi da implementare per il fruitore del servizio in questo scenario. 5.2 Configurazione Porta di Dominio e Registro Servizi Eseguiamo la configurazione sulla Control Station sulla falsariga di quanto fatto per lo scenario oneway visto in precedenza. Una volta creati i descrittori WSDL del servizio, possiamo procedere con la creazione dell accordo di servizio. 1. Creazione dell Accordo di Servizio con i dati riportati in Tabella 14. Referente WSDL Definitorio WSDL Concettuale WSDL Logico Erogatore AS_RichiestaStatoFamiglia SPC/CentroAnagrafico definitorio.xsd concettuale.wsdl logicoerogatore.wsdl Tabella 14: Dati Accordo di servizio 2. Aggiungiamo il Servizio all Accordo: il nome del servizio dovrà avere lo stesso nome del PortType indicato nel WSDL Concettuale. Profilo RichiestaStatoFamiglia sincrono Tabella 15: Dati Servizio dell Accordo 3. Specifichiamo le azioni del Servizio: le azioni del Servizio corrispondono alle Operation specificate nel WSDL Acquisisci Tabella 16: Dati delle azioni del servizio 4. Aggiungere il servizio SPCoop con i dati riportati in Tabella Aggiungere il soggetto fruitore alla lista dei soggetti che possono fruire del servizio: avendo attiva di default l autenticazione SPCoop dobbiamo aggiungere il soggetto Comune ai fruitori del servizio RichiestaStatoFamiglia

25 20 / 33 Soggetto SPCoop Accordo Servizio Servizio WSDL Implementativo Erogatore SPC/CentroAnagrafico AS_RichiestaStatoFamiglia RichiestaStatoFamiglia implementazioneerogatore.wsdl Tabella 17: Dati Servizio SPCoop 6. Aggiungere nelle politiche sicurezza il servizio applicativo autorizzato ad invocare il servizio. Questo passaggio è essenziale ai fini dell autenticazione da parte del servizio applicativo in fase di invocazione della porta delegata. (a) Dall elenco dei fruitori del servizio, in corrispondenza del soggetto Comune, nella colonna politiche sicurezza selezionare visualizza, quindi il pulsante Aggiungi (b) Compilare il form selezionando il servizio applicativo Comune_SA dalla lista a discesa e confermando con il pulsante Invia (c) Premere il pulsante Invia Nota L operazione descritta in questo passaggio, creerà automaticamente un associazione tra il servizio applicativo e la porta delegata creata automaticamente al passo precedente. 7. Aggiungere la Porta Applicativa: aggiungiamo al soggetto SPC/CentroAnagrafico la porta applicativa che si occuperà dello sbustamento delle richieste e-gov dei fruitori e di consegnarle al servizio applicativo erogato. Validazione Contenuti Stateless Gestione Body Gestione Manifest Servizio SPCoop Azione RichiestaStatoFamiglia_PA disabilitato default none abilitato RichiestaStatoFamiglia Acquisisci Tabella 18: Dati Porta Applicativa 8. Aggiungere il Servizio Applicativo Erogatore: Soggetto SPCoop Tipo invocazione Modalità fault RichiestaStatoFamiglia_SA CentroAnagrafico nessuna soap Tabella 19: Dati Servizio Applicativo 9. Impostare i parametri di invocazione del Servizio Applicativo con i valori riportati in Tabella 20: 10. Associare alla Porta Applicativa il Servizio Applicativo

26 21 / 33 Sbustamento Get message Connettore abilitato Url connettore Tipo credenziali d accesso RichiestaStatoFamiglia_SA no disabilitato si none Tabella 20: Dati invocazione Servizio Applicativo 5.3 Programmazione La programmazione di un servizio ed un client sincrono è molto simile a quella di un Oneway, tranne per il fatto che il servizio in questo caso restituisce un messaggio SOAP in risposta ad una richiesta. Nella programmazione dei servizi a livello di operazioni, questo si traduce in un operazione con un oggetto di ritorno invece di void. public interface RichiestaStatoFamiglia { = "statofamiglia", targetnamespace = " ", partname = = "Acquisisci") public PersonaType = "statofamigliarequestpart", name = "richiestastatofamiglia", targetnamespace = " java.lang.string statofamigliarequestpart ); 5.4 Test e verifica Seguendo le istruzioni fornite con i sorgenti per la configurazione, compilazione ed esecuzione degli esempi, avviamo il test per il servizio RichiestaStatoFamiglia. 6 Stampa Documento (AsincronoAsimmetrico) 6.1 Descrizione formale dell Accordo di Servizio: WSDL e WSBL Creiamo un accordo di servizio fornendo i wsdl che descrivono il servizio applicativo in questione. I wsdl in questione sono forniti insieme ai sorgenti degli esempi: WSDL Definitorio (definitorio.xsd) <?xml version="1.0" encoding="utf-8"?> <xs:schema xmlns:so=" xmlns:xs=" XMLSchema" xmlns:xsd=" targetnamespace=" openspcoop.org/example"> <xs:simpletype name="codicefiscaletype"> <xs:restriction base="xs:string"> <xs:pattern value="[a-za-z]{6}\d\d[a-za-z]\d\d[a-za-z]\d\d\d[a-za-z]"/> </xs:restriction> </xs:simpletype> <xs:complextype name="richiestadocumento"> <xs:sequence> <xs:element name="codicedocumento" type="xs:string"/> </xs:sequence>

27 22 / 33 </xs:complextype> <xs:element name="stampadocumento"> <xs:complextype> <xs:complexcontent> <xs:extension base="so:richiestadocumento"> <xs:attribute name="cf" type="so:codicefiscaletype" use="required"/> </xs:extension> </xs:complexcontent> </xs:complextype> </xs:element> <xs:element name="presaconsegnastampa"> <xs:complextype> <xs:sequence> <xs:element name="idstampa" type="xs:long"/> <xs:element name="stimacompletamento" type="xs:date"/> </xs:sequence> </xs:complextype> </xs:element> <xs:element name="statodocumento" type="xs:long"/> <xs:element name="esito" type="xs:string"/> </xs:schema> WSDL Concettuale (concettuale.wsdl). <?xml version="1.0" encoding="utf-8"?> <wsdl:definitions targetnamespace=" xmlns:xsd=" xmlns:soap=" xmlns:spc=" xmlns:wsdl=" <wsdl:import namespace=" location="definitorio.xsd"> </wsdl:import> <wsdl:message name="stampadocumentoresponse"> <wsdl:part name="stampadocumentoresponsepart" element="spc:presaconsegnastampa"> <wsdl:message name="statodocumentorequest"> <wsdl:part name="statodocumentorequestpart" element="spc:statodocumento"> <wsdl:message name="stampadocumentorequest"> <wsdl:part name="stampadocumentorequestpart" element="spc:stampadocumento"> <wsdl:message name="statodocumentoresponse"> <wsdl:part name="statodocumentoresponsepart" element="spc:esito"> <wsdl:porttype name="stampadocumento"> <wsdl:operation name="stampa"> <wsdl:input message="spc:stampadocumentorequest"> </wsdl:input> <wsdl:output message="spc:stampadocumentoresponse"> </wsdl:output> </wsdl:operation> <wsdl:operation name="stato"> <wsdl:input message="spc:statodocumentorequest"> </wsdl:input> <wsdl:output message="spc:statodocumentoresponse"> </wsdl:output> </wsdl:operation> </wsdl:porttype>

28 23 / 33 </wsdl:definitions> WSDL Logico Erogatore (logicoerogatore.wsdl). <?xml version="1.0" encoding="utf-8"?> <wsdl:definitions targetnamespace=" xmlns:xsd=" xmlns:soap=" xmlns:spc=" xmlns:wsdl=" <wsdl:import namespace=" location="definitorio.xsd"> </wsdl:import> <wsdl:message name="stampadocumentoresponse"> <wsdl:part name="stampadocumentoresponsepart" element="spc:presaconsegnastampa"> <wsdl:message name="statodocumentorequest"> <wsdl:part name="statodocumentorequestpart" element="spc:statodocumento"> <wsdl:message name="stampadocumentorequest"> <wsdl:part name="stampadocumentorequestpart" element="spc:stampadocumento"> <wsdl:message name="statodocumentoresponse"> <wsdl:part name="statodocumentoresponsepart" element="spc:esito"> <wsdl:porttype name="stampadocumento"> <wsdl:operation name="stampa"> <wsdl:input message="spc:stampadocumentorequest"> </wsdl:input> <wsdl:output message="spc:stampadocumentoresponse"> </wsdl:output> </wsdl:operation> <wsdl:operation name="stato"> <wsdl:input message="spc:statodocumentorequest"> </wsdl:input> <wsdl:output message="spc:statodocumentoresponse"> </wsdl:output> </wsdl:operation> </wsdl:porttype> </wsdl:definitions> WSDL Logico Fruitore Il fruitore, per realizzare questo scenario, non ha bisogno di esporre nessun servizio, quindi non ha un WSDL che lo descrive. WSDL Implementativo Erogatore (implementativoerogatore.wsdl). <?xml version="1.0" encoding="utf-8"?> <wsdl:definitions targetnamespace=" xmlns:xsd=" xmlns:soap=" xmlns:spc=" xmlns:wsdl=" <wsdl:import namespace=" location="logicoerogatore.wsdl "> </wsdl:import> <wsdl:binding name="stampadocumentobinding" type="spc:stampadocumento"> <soap:binding style="document" transport=" <wsdl:operation name="stampa"> <wsdl:input> <soap:body use="literal"/> </wsdl:input> <wsdl:output> <soap:body use="literal"/>

29 24 / 33 </wsdl:output> </wsdl:operation> <wsdl:operation name="stato"> <wsdl:input> <soap:body use="literal"/> </wsdl:input> <wsdl:output> <soap:body use="literal"/> </wsdl:output> </wsdl:operation> </wsdl:binding> <wsdl:service name="stampadocumentoservice"> <wsdl:port name="stampadocumentointerfaceendpoint" binding="spc:stampadocumentobinding "> <soap:address location=" </wsdl:port> </wsdl:service> </wsdl:definitions> WSDL Implementativo Fruitore Come per il WSDL Logico Fruitore, non ci sono servizi da implementare per il fruitore del servizio in questo scenario. 6.2 Configurazione Porta di Dominio e Registro Servizi Una volta creati i descrittori del servizio, possiamo procedere con la creazione dell accordo di servizio. 1. Creazione dell Accordo di Servizio Referente WSDL Definitorio WSDL Concettuale WSDL Logico Erogatore AS_StampaDocumento SPC/CentroAnagrafico definitorio.xsd concettuale.wsdl logicoerogatore.wsdl Tabella 21: Dati Accordo di servizio 2. Aggiungiamo il Servizio all Accordo: il nome del servizio dovrà avere lo stesso nome del PortType indicato nel WSDL Concettuale. Profilo StampaDocumento asincronoasimmetrico Tabella 22: Dati Servizio dell Accordo 3. Specifichiamo le azioni del Servizio: le azioni del Servizio corrispondono alle Operation specificate nel WSDL Stampa Stato Tabella 23: Dati delle azioni del servizio