realizzare un framework di test con soapui

1

Realizzare un framework di Test con SOAPUI

Rosario Turco

SoapUI è uno strumento Java Open Source estremamente utile e semplice, specie in ambito architetture

SOA e utilizzabile su piattaforme qualsiasi (Windows/Unix/Linux etc) grazie alla neutralità di Java ed adatto

per:

test di servizi web (http/https/jms), per creare stub di servizi offerti da un server o per creare client

di servizi;

test di connettività dei servizi e scambio WSDL;

verifica di correttezza;

test di un servizio sviluppato che ha bisogno di altri servizi esterni da simulare (to mock external

service);

risparmio di memoria in ambienti di test, poiché gli stub ottenibili pesano pochissimo e possono

essere messi su PC;

automatizzazione dei i test, a partire dalle WSDL;

predisposizione di un catena di test;

predisposizione di un Load Test.

Impiego rapido in Metodologie Agili e di Continuos Testing

Il vantaggio che fornisce è quello di rendersi indipendenti dai sistemi, che offrono i servizi e di disporre di

un framework open source gratuito e robusto, che permette rapidamente di testare quanto sviluppato, sia

a livello di test unitario che di test di sistema.

Ci soffermeremo soprattutto sul come utilizzare in questo caso SOAPUI, ovviamente iniziate prima a

scaricarvi l’ultima versione, che attualmente è 3.6.1. Vi consiglio di unzippare il tutto sotto C:\Tools\soapui-

3.6.1. In Tools io di solito metto tutti i prodotti Java necessari ai miei sviluppi. Da C:\Tools\ soapui-3.6.1\bin

create uno shortcut sul desktop del file soapui.bat ed ora cliccate sul file batch e siete pronti ad iniziare.

Nell'esempio di seguito viene descritto come disporre SOAPUI per testare dei servizi. Faremo due scenari di

due tipi di test diversi.

SCENARIO A – Servizio Stub esposto che fornisce una Response

Ipotizziamo un servizio che deve essere simulato PrepaidMobileNumberInformationQuery con l’operation

getCreditoInfo e che restituisce, quindi, su http delle informazioni (sarebbe analogo anche su https o su

JMS).

Predisposizione delle WSDL e degli XSD e controlli IP e porta

Le WSDL e gli XSD relativi sono disponibili in APPENDICE per fare un semplice “past & cut” per le prove di

apprendimento. Aprirle con un editor XML/WSDL adeguato in una cartella del desktop.

Innanzitutto cambiare nella WSDL, in fondo nel binding, cambiare l’IP con quello del proprio PC e

controllare che sul sistema Windows o Unix (dove cioè è presente SOAPUI running) non fosse già in uso la

porta 8088 che è quella di default usata da SOAPUI, altrimenti cambiarla; ad esempio sul Windows da

comandi DOS con nestat –a | find “<porta>” oppure su Unix con netstat –a | grep <porta>.

2

Ovviamente il servizio chiamante sotto test deve essere configurato per chiamare l’IP del PC e la porta

prescelta.

Creazione Progetto

Su SOPAUI nel menu selezionare "File" → "Nuovo soapUI Project". Impostare il nome del progetto, ad

esempio "PrepaidMobileStub".

Impostare l'iniziale WSDL_PrepaidMobileNumberInformationQuery_Concrete-v1.wsdl e premere OK.

Creazione MockService

A questo punto occorre creare il mock service, poggiando il puntatore del mouse su

PrepaidMobileNumberInformationQueryBinding e con tasto destro fare Generate Mock Service e accettare

il nome proposto, mentre in path occorre mettere ciò che contiene la WSDL cioè:

/IB/services/PrepaidMobileNumberInformationQuery-v1

Questo deve essere visibile anche dal MockService Properties a sinistra.

Spesso su PC sia per la request che per per la response (vedi MockService Properties di entrambi), occorre

mettere l’alias con cui è visto il PC e non l’IP ad esempio:

http://NBW72006184478:8088/IB/services/PrepaidMobileNumberInformationQuery-v1

Se occorresse cambiare (se il test non funziona) basta farlo con doppio click su Request che apre l’editor

per lanciare il test e una location per modificare la url (usare Edit current).

Valorizzare Request e Response

Valorizzate la parte XML della request (doppio click su Request a sinistra) e della response (analogamente)

riempendo dove vi sono i ?.

Start Minimized e test se OK

A questo punto si può fare sul Mock Service tasto destro e Start Minimized.

Per fare un test che è tutto OK mandate una request valorizzata (triangolo verde in alto) e vedrete sempre

nell’editor della request (a destra, l’altra porzione di finestra la risposta) . A questo punto il vostro Mock

Service è uno STUB pronto a ricevere richieste dal servizio sviluppato reale che dovete testare.

Suggerimento

Salvate sempre il progetto e accumulate i file di test da fare (le request) con un Test case, questo vi

permetterà di attrezzarvi per le regressioni. Suggerimento denominate le request secondo il caso di test

della vostra progettazione Request-OK-12, Request-NOK-13 etc e alla fine l’obiettivo è di predisporre in

sequenza tutti i test. E’ possibile anche predisporre il risultato atteso (lo vedremo nel prossimo esempio).

SCENARIO B – Mocking external service

Ipotizziamo un servizio che calcola, ad esempio, il prezzo di un viaggio (TripPriceService) e per farlo, ad

esempio, sono invocati un servizio che restituisce i prezzi per le camere d'albergo (HotelPriceService) ed un

servizio che restituisce i prezzi dei soli voli (FlightPriceService).

3

Qua ipotizziamo che TripPriceService è un servizio da voi effettivamente sviluppato e deployato, mentre gli

altri due servizi sono servizi elementari esterni da richiamare da TripPriceService e da cui ottenere risposta

e sono quest’ultimi da sottoporre a mocking.

La formula del calcolo sarà semplicemente:

price = duration * rooms * getRoomPrice() + adults * getFlightPrice(from, to)

In sostanza il prezzo da pagare dipende dalla durata (o numero di giorni), dal numero di stanze, dal prezzo

per stanza, dal numero di adulti e il prezzo del volo da una partenza ad una destinazione.

In APPENDICE sono mostrate le WSDL dei tre servizi: TripPriceService.wsdl, HotelPriceService.wsdl,

FlightPriceService.wsdl. Per la prova, basterà per voi fare “past & cut” di esse dall’APPENDICE e creare le

WSDL in una cartella sul desktop con un opportuno editor che tratta XML/WSDL a grid e text

Dall’APPENDICE createvi le WSDL in una cartella sul desktop.

Creare un progetto SOAPUI con un servizio reale da testare e non da esporre su SOAPUI

Nel menu selezionare "File" → "Nuovo soapUI Project". Impostare il nome del progetto, ad esempio "trip-

prezzo-servizio". Poiché il servizio TripPriceService è sviluppato e deployato (ad esempio su TIBCO) ed è

quello a cui siamo interessati per il test, mentri gli altri servizi saranno degli STUB, qua Initial WSDL occorre

fare l’invocazione:

"http://localhost:8080/trip-price-0.0.1-SNAPSHOT/webservices/TripPriceService?wsdl" .

Dopo fare clic su OK.

Ora per i servizi che invoca TripPriceService e che dovremmo esporre come STUB su SOAPUI ipotizzeremo

che siano su porta 8088 di default di SOAPUI; però conviene sempre controllare che sul sistema Windows o

su Unix (dove cioè funziona SOAPUI) non fosse già in uso; ad esempio sul Windows da comandi DOS con

nestat –a | find “<porta>” oppure su Unix con netstat –a | grep <porta>

Ricordarsi ora che per i due servizi STUB occorre cambiare nella WSDL in fondo nel binding IP e/o porta di

dove è SOAPUI e analogamente occorre configurare TripPriceService per puntare ad essi.

Come risultato, si ottiene il progetto "trip-prezzo-servizio" che contiene l'interfaccia

"TripPriceServiceFacadeServiceSoapBinding".

Se cliccate su TripPriceServiceFacadeServiceSoapBinding e successivamente su Service Endpoints vedrete le

attuali configurazioni. Cliccando su Request 1 vedrete un messaggio di prova che successivamente potrete

popolare dopo. I “?” sono da valorizzare.

4

Generare una suite di test

Fare clic col tasto destro destro sull'interfaccia "TripPriceServiceFacadeServiceSoapBinding" e selezionare

"Generate TestSuite" e click OK.

Inserire un nome per la piattaforma di test, consiglio ad esempio

"TripPriceServiceFacadeServiceSoapBinding TestSuite" e click OK.

Come risultato si ottiene il "TripPriceServiceFacadeServiceSoapBinding TestSuite", che include il

"getTripPrice TestCase" caso di test.

Il caso di test contiene già generato la richiesta "getTripPrice" test.

Configurare il caso di test (Test Case)

L'impostazione di un timeout per il test è una buona pratica, in modo che il test non rimanga in attesa

infinita, in caso qualcosa vada storto. A sinistra col tasto destro del mouse sul TestCase, fare clic su

Options. Impostare TestCase timeout in millisecondi, per esempio "5000". Fare clic su OK.

Configurare la richiesta di test

Fare doppio clic sulla richiesta "getTripPrice" Test e modificare la Request in modo da chiedere il prezzo dei

viaggi seguenti: da Berlino a Parigi, per 2 adulti, della durata di 3 giorni, una camera necessarie. Potete per

prova fare “past & cut” del messaggio successivo e incollarlo al posto della Request 1:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"

xmlns:trip="http://trip.price.service">

<soapenv:Header/>

<soapenv:Body>

<trip:getTripPrice>

<trip>

<adults>2</adults>

<duration>3</duration>

<from>Berlin</from>

<rooms>1</rooms>

<to>Paris</to>

</trip>

5

</trip:getTripPrice>

</soapenv:Body>

</soapenv:Envelope>

Fare clic su "Invia la richiesta di URL specificato endpoint" tasto (triangolo verde in alto alla finestra della

Request 1). Come primo risultato, otteniamo un errore SOAP, perché i servizi esterni di cui abbiamo

bisogno non sono disponibili.

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">

<soap:Body>

<soap:Fault>

<faultcode>soap:Server</faultcode>

<faultstring>Could not send Message.</faultstring>

</soap:Fault>

</soap:Body>

</soap:Envelope>

Mock servizi esterni - Importare il file WSDL del servizio esterno

Sul nome del progetto a sinistra fare ADD WSDL e Impostare il percorso WSDL di HotelPriceService.wsdl.

Fare clic su "OK". Come risultato, si aggiunge una nuova interfaccia per il progetto:

"HotelPriceServiceFacadeServiceSoapBinding".

Aggiungere una risposta mock al caso di test

Torniamo a getTripPrice Test Case. Tasto destro del mouse e selezionare "Aggiungi Step" -> "Mock

Response". Specificare un nome per il nuovo passaggio, per esempio "getRoomPrice Mock Response" e fare

clic su OK.

Selezionare l'operazione "getRoomPrice" di interfaccia "HotelPriceServiceFacadeServiceSoapBinding".

Impostare il percorso (prelevabile dalla WSDL):

/external-services-0.0.1-SNAPSHOT/webservices/HotelPriceService

Porta 8088.

Fare clic su OK. Modificare la response generata, per restituire un prezzo, per esempio "55.0". Impostare la

fase di avvio della risposta mock (start step) nel "MockResponse Properties" a "getTripPrice". Così il servizio

mock inizierà ad ascoltare le richieste non appena la richiesta è getTripPrice.

Aggiungere un’assert per la richiesta getRoomPrice

Attivare una richiesta al servizio mock, così questo renderà più facile la configurazione dell’assertion. Fare

clic su triangolo verde nell'editor caso di test. Si dovrebbe vedere una richiesta nell'editor risposta mock.

Fare clic sulla scheda "Assertions". Cliccare sul pulsante "Add an Assertion for this item ". Selezionare

"Schema Compliance" e fare clic su OK. Controllare l'url definizione da convalidare e fare clic su OK.

L'assertion deve apparire come valido.

6

Ripetiamo con FlightPriceService

Fare clic destro sul project e selezionare "Aggiungi WSDL". Impostare il percorso WSDL

FlightPriceService.wsdl. Fare clic su OK. Come risultato, si aggiunge una nuova interfaccia per il progetto:

"FlightPriceServiceFacadeServiceSoapBinding". Sempre sul TestCase tasto destro del mouse e selezionare

"Aggiungi Step" -> "Mock Response". Specificare un nome per il nuovo passaggio, per esempio

"getFlightPrice Mock Response" e fare clic su OK. Selezionare l'operazione "getFlightPrice" di interfaccia

"FlightPriceServiceFacadeServiceSoapBinding". Impostare la porta, qui "8088".

Impostare il percorso, qui /external-services-0.0.1-SNAPSHOT/webservices/FlightPriceService e fare clic su

OK.

Modifica la risposta generata, per restituire un prezzo, ad esempio, "49,99". Impostare la fase di avvio della

risposta mock nel "MockResponse Properties" a "getTripPrice". Così il servizio mock inizierà ad ascoltare le

richieste non appena la richiesta inviata è getTripPrice.

Avviare (triangolo verde) il Test Case. Si dovrebbe vedere una richiesta nell'editor risposta mock.

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">

<soap:Body>

<ns2:getFlightPrice xmlns:ns2="http://external.services/flight">

<from>Berlin</from>

<to>Paris</to>

</ns2:getFlightPrice>

</soap:Body>

</soap:Envelope>

Fare clic sulla scheda "asserzioni". Clicca sul pulsante "Add an assertion of this item". Selezionare "Schema

Compliance" e fare clic su OK.

Controllare l'url di definizione da convalidare e fare clic su OK. L'affermazione dovrebbe apparire come

valida.

Clicca sul pulsante "Add an assertion of this item". Selezionare "XPath Match" e fare clic su "OK", si aprirà la

finestra di configurazione XPath Match. Fare clic su "dichiarare" per generare automaticamente le

dichiarazioni

declare namespace soap='http://schemas.xmlsoap.org/soap/envelope/';

declare namespace ns2='http://external.services/flight';

Query the "from" field //ns2:getFlightPrice/from

Impostare il risultato atteso, in questo esempio "Berlin". Fare clic su "Salva"

L'affermazione dovrebbe apparire come valido. Fare lo stesso per il campo "A" e controllare che sia Parigi.

7

Verificare la risposta

Eseguire il caso di test, ora dovrebbe avere successo. Aprire l'editor richiesta di test. Fare clic sulla scheda

"asserzioni". Aggiungere un "Schema Compliance" affermazione, per verificare lo schema di risposta.

Aggiungere un "Non SOAP Fault" affermazione, per verificare la risposta non è un errore SOAP. Aggiungere

un "SOAP Response" affermazione, per verificare la risposta è una risposta SOAP. Aggiungere un "XPath

Match" affermazione di controllare il prezzo .

XPath Expression

declare namespace soap='http://schemas.xmlsoap.org/soap/envelope/';

declare namespace ns2='http://trip.price.service';

//ns2:getTripPriceResponse/return

Expected Result : 264.98

(3 * 1 * 55 + 2 * 49.99) (3 * 1 * 55 + 2 * 49,99)

Ora la Test Suite è pronta.

Conclusioni

Un ottimo strumento. Vanno affinate solo le vostre conoscenze su esso su come usarlo. Studiare a fondo il

tutorial messi a disposizione in [1][2].

[1] http://www.soapui.org

[2] http://www.soapui.org/JMS/getting-started.html

APPENDICE

SCENARIO A

WSDL_PrepaidMobileNumberInformationQuery_Concrete-v1.wsdl

<?xml version="1.0" encoding="UTF-8"?> <wsdl:definitions xmlns:nsSchema="http://telecomitalia.it/SOA/PrepaidMobileNumberInformationQuery/2010-08-05" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:head="http://telecomitalia.it/SOA/SOAP/SOAPHeader" xmlns:tns="http://telecomitalia.it/SOA/PrepaidMobileNumberInformationQuery" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" targetNamespace="http://telecomitalia.it/SOA/PrepaidMobileNumberInformationQuery"> <wsdl:types> <xsd:schema targetNamespace="http://telecomitalia.it/SOA/PrepaidMobileNumberInformationQuery"> <xsd:import namespace="http://telecomitalia.it/SOA/PrepaidMobileNumberInformationQuery/2010-08-05" schemaLocation="PrepaidMobileNumberInformationQuery.xsd"/> <xsd:import namespace="http://telecomitalia.it/SOA/SOAP/SOAPHeader" schemaLocation="SOAPHeader_v1.1.xsd"/>  </xsd:schema> </wsdl:types> <wsdl:message name="getCreditInfoRequest"> <wsdl:part name="Header" element="head:Header"/>

http://www.soapui.org/

http://www.soapui.org/JMS/getting-started.html

8

<wsdl:part name="body" element="nsSchema:getCreditInfoRequest"/> </wsdl:message> <wsdl:message name="getCreditInfoResponse"> <wsdl:part name="Header" element="head:Header"/> <wsdl:part name="body" element="nsSchema:getCreditInfoResponse"/> </wsdl:message> <wsdl:portType name="PrepaidMobileNumberInformationQueryPortType"> <wsdl:operation name="getCreditInfo"> <wsdl:input message="tns:getCreditInfoRequest"/> <wsdl:output message="tns:getCreditInfoResponse"/> </wsdl:operation> </wsdl:portType> <wsdl:binding name="PrepaidMobileNumberInformationQueryBinding" type="tns:PrepaidMobileNumberInformationQueryPortType"> <soap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http"/> <wsdl:operation name="getCreditInfo"> <soap:operation soapAction="getCreditInfo" style="document"/> <wsdl:input> <soap:body parts="body" use="literal"/> <soap:header message="tns:getCreditInfoRequest" part="Header" use="literal"/> </wsdl:input> <wsdl:output> <soap:body parts="body" use="literal"/> <soap:header message="tns:getCreditInfoResponse" part="Header" use="literal"/> </wsdl:output> </wsdl:operation> </wsdl:binding> <wsdl:service name="PrepaidMobileNumberInformationQuery-v1"> <wsdl:port name="PrepaidMobileNumberInformationQuery" binding="tns:PrepaidMobileNumberInformationQueryBinding"> <soap:address location="http://10.184.67.27:12102/IB/services/PrepaidMobileNumberInformationQuery-v1"/> </wsdl:port> </wsdl:service> </wsdl:definitions>

PrepaidMobileNumberInformationQuery.xsd

<?xml version="1.0" encoding="UTF-8"?>  <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:sm="http://telecomitalia.it/SOA/PrepaidMobileNumberInformationQuery/2010-08-05" xmlns:cst="http://telecomitalia.it/SOA/PrepaidMobileNumberInformationQueryCustomTypes/2010-08-05" targetNamespace="http://telecomitalia.it/SOA/PrepaidMobileNumberInformationQuery/2010-08-05" elementFormDefault="qualified" version="1.0"> <xs:import namespace="http://telecomitalia.it/SOA/PrepaidMobileNumberInformationQueryCustomTypes/2010-08-05" schemaLocation="PrepaidMobileNumberInformationQueryEntities.xsd"/>  <xs:element name="getCreditInfoRequest"> <xs:complexType> <xs:sequence> <xs:element name="CustomerAccount" type="cst:CustomerAccountWithConnectivityCFS"/> </xs:sequence> </xs:complexType> </xs:element> <xs:element name="getCreditInfoResponse"> <xs:complexType> <xs:sequence> <xs:element name="ProcessData" type="sm:ProcessData"/> <xs:element name="CustomerAccount" type="cst:CustomerAccountWithCredit" minOccurs="0"/> </xs:sequence> </xs:complexType> </xs:element>

9

  <xs:complexType name="ProcessData"> <xs:sequence> <xs:element name="returnCode" type="sm:noEmptyFieldType"/> <xs:element name="returnDescription" type="sm:noEmptyFieldType" minOccurs="0"/> </xs:sequence> </xs:complexType>   <xs:simpleType name="noEmptyFieldType"> <xs:restriction base="xs:string"> <xs:minLength value="1"/> </xs:restriction> </xs:simpleType> <xs:simpleType name="dateType"> <xs:restriction base="xs:date"/> </xs:simpleType>  </xs:schema>

PrepaidMobileNumberInformationQueryEntities.xsd

<?xml version="1.0" encoding="UTF-8"?>  <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:bvi="http://telecomitalia.it/SOA/BVI" xmlns:cst="http://telecomitalia.it/SOA/PrepaidMobileNumberInformationQueryCustomTypes/2010-08-05" targetNamespace="http://telecomitalia.it/SOA/PrepaidMobileNumberInformationQueryCustomTypes/2010-08-05" elementFormDefault="qualified" version="1.0">   <xs:complexType name="MobileConnectivityCFS"> <xs:sequence> <xs:element name="number" type="cst:telephoneNumberType"/> </xs:sequence> </xs:complexType>   <xs:complexType name="CustomerAccountWithConnectivityCFS"> <xs:sequence> <xs:element name="MobileConnectivityCFS" type="cst:MobileConnectivityCFS"/> </xs:sequence> </xs:complexType> <xs:complexType name="CustomerAccountWithCredit"> <xs:sequence> <xs:element name="creditAmount" type="cst:decimalType"/> <xs:element name="creditDate" type="cst:dateTimeType" minOccurs="0"/> <xs:element name="lastTopUpDate" type="cst:dateTimeType" minOccurs="0"/> <xs:element name="creditValidFor" type="cst:TimePeriod" minOccurs="0"/> <xs:element name="Product" type="cst:Product" minOccurs="0"/> <xs:element name="MobileConnectivityCFS" type="cst:MobileConnectivityCFS"/> </xs:sequence> </xs:complexType>   <xs:complexType name="Product"> <xs:sequence> <xs:element name="ProductOffering" type="cst:ProductOffering"/> </xs:sequence> </xs:complexType> <xs:complexType name="ProductOffering"> <xs:sequence> <xs:element name="id" type="cst:noCommonConstraintsType"/> </xs:sequence>

10

</xs:complexType>   <xs:complexType name="TimePeriod"> <xs:sequence> <xs:element name="endDateTime" type="cst:dateTimeType"/> </xs:sequence> </xs:complexType>    <xs:simpleType name="telephoneNumber"> <xs:annotation> <xs:appinfo> <bvi:primitiveType> <bvi:className>TelephoneNumber</bvi:className> </bvi:primitiveType> </xs:appinfo> </xs:annotation> <xs:restriction base="xs:string"> <xs:pattern value="\+?\d{1,}"/> </xs:restriction> </xs:simpleType> <xs:simpleType name="decimal"> <xs:annotation> <xs:appinfo> <bvi:primitiveType> <bvi:className>Decimal</bvi:className> </bvi:primitiveType> </xs:appinfo> </xs:annotation> <xs:restriction base="xs:decimal"/> </xs:simpleType> <xs:simpleType name="dateTime"> <xs:annotation> <xs:appinfo> <bvi:primitiveType> <bvi:className>DateTime</bvi:className> </bvi:primitiveType> </xs:appinfo> </xs:annotation> <xs:restriction base="xs:dateTime"/> </xs:simpleType>   <xs:simpleType name="telephoneNumberType"> <xs:restriction base="cst:telephoneNumber"> <xs:pattern value="\d{1,}"/> </xs:restriction> </xs:simpleType> <xs:simpleType name="decimalType"> <xs:restriction base="cst:decimal"/> </xs:simpleType> <xs:simpleType name="dateTimeType"> <xs:restriction base="cst:dateTime"/> </xs:simpleType> <xs:simpleType name="noCommonConstraintsType" final="#all"> <xs:restriction base="xs:string"> <xs:minLength value="1"/> </xs:restriction> </xs:simpleType>  </xs:schema>

SOAPHeader_v1.1.xsd

<?xml version="1.0" encoding="UTF-8"?> <!-- // FILE-ID // Name: SOAPHeader_v1.1.xsd // Version: 1.1 // Type: XSD file // Analysis Version: // Kit Version:

11

// Created: 05/03/2009 // Modified 16/03/2010 // Developed by: Simone Avossa --> <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:h="http://telecomitalia.it/SOA/SOAP/SOAPHeader" targetNamespace="http://telecomitalia.it/SOA/SOAP/SOAPHeader" elementFormDefault="qualified" version="1.1">  <xs:complexType name="HeaderType"> <xs:annotation> <xs:documentation>Informazioni di contesto dell'invocazione del servizio</xs:documentation> </xs:annotation> <xs:sequence> <xs:element name="sourceSystem" type="h:sourceSystemType" minOccurs="0"> <xs:annotation> <xs:documentation>Sistema da cui proviene la richiesta</xs:documentation> </xs:annotation> </xs:element> <xs:element name="interactionDate" type="h:interactionDateType" minOccurs="0"> <xs:annotation> <xs:documentation>Data e Ora di invocazione del servizio</xs:documentation> </xs:annotation> </xs:element> <xs:element name="businessID" type="h:businessIDType" minOccurs="0"> <xs:annotation> <xs:documentation>Identifica univocamente il processo di business</xs:documentation> </xs:annotation> </xs:element> <xs:element name="messageID" type="h:messageIDType" minOccurs="0"> <xs:annotation> <xs:documentation>Identifica il messaggio in maniera univoca</xs:documentation> </xs:annotation> </xs:element> <xs:element name="transactionID" type="h:transactionIDType" minOccurs="0"> <xs:annotation> <xs:documentation>Identifica la transazione per gestire i ritorni sincroni</xs:documentation> </xs:annotation> </xs:element> </xs:sequence> </xs:complexType> <xs:simpleType name="dateType"> <xs:restriction base="xs:string"> <xs:pattern value="\d{4}-\d{2}-\d{2}"/> </xs:restriction> </xs:simpleType> <xs:simpleType name="timeType"> <xs:restriction base="xs:string"> <xs:pattern value="\d{2}:\d{2}:\d{2}((Z)|(\.\d{1,}Z?)|((\+|-)\d{2}:\d{2}))?"/> </xs:restriction> </xs:simpleType> <xs:simpleType name="businessIDType"> <xs:restriction base="xs:string"> <xs:minLength value="1"/> </xs:restriction> </xs:simpleType> <xs:simpleType name="messageIDType"> <xs:restriction base="xs:string"> <xs:minLength value="1"/> </xs:restriction> </xs:simpleType> <xs:simpleType name="sourceSystemType"> <xs:restriction base="xs:string"> <xs:minLength value="1"/> </xs:restriction> </xs:simpleType> <xs:simpleType name="transactionIDType"> <xs:restriction base="xs:string"> <xs:minLength value="1"/> </xs:restriction> </xs:simpleType> <xs:complexType name="interactionDateType"> <xs:sequence> <xs:element name="Date" type="h:dateType"> <xs:annotation>

12

<xs:documentation>Per compatibilità con i diversi prodotti o librerie software (es. Axis2 e BW) si è scelto di utilizzare il tipo string. La restizione applicata accetta il formato: CCYY-MM-DD. Non sono presenti restrizioni sul range dei valori.</xs:documentation> </xs:annotation> </xs:element> <xs:element name="Time" type="h:timeType"> <xs:annotation> <xs:documentation>Per compatibilità con i diversi prodotti o librerie software (es. Axis2 e BW) si è scelto di utilizzare il tipo string. La restizione applicata accetta il formato: hh:mm:ss.sss. Non sono presenti restrizioni sul range dei valori. Per gli ulteriori dettagli sul formato fare riferimento alla definizione di Time Data Type W3C, presente al link: http://www.w3schools.com/Schema/schema_dtypes_date.asp</xs:documentation> </xs:annotation> </xs:element> </xs:sequence> </xs:complexType>  <xs:element name="Header" type="h:HeaderType"/> </xs:schema>

SCENARIO B

TripPriceService.wsdl

<?xml version="1.0" encoding="UTF-8"?>  <wsdl:definitions xmlns:ns1="http://cxf.apache.org/bindings/xformat" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:tns="http://trip.price.service" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" name="TripPriceServiceFacadeService" targetNamespace="http://trip.price.service"> <wsdl:types> <xs:schema attributeFormDefault="unqualified" elementFormDefault="unqualified" targetNamespace="http://trip.price.service" xmlns:tns="http://trip.price.service" xmlns:xs="http://www.w3.org/2001/XMLSchema"> <xs:element name="getTripPrice" type="tns:getTripPrice"/> <xs:element name="getTripPriceResponse" type="tns:getTripPriceResponse"/> <xs:complexType name="getTripPrice"> <xs:sequence> <xs:element minOccurs="0" name="trip" type="tns:trip"/> </xs:sequence> </xs:complexType> <xs:complexType name="trip"> <xs:sequence> <xs:element name="adults" type="xs:int"/> <xs:element name="duration" type="xs:int"/> <xs:element minOccurs="0" name="from" type="xs:string"/> <xs:element name="rooms" type="xs:int"/> <xs:element minOccurs="0" name="to" type="xs:string"/> </xs:sequence> </xs:complexType> <xs:complexType name="getTripPriceResponse"> <xs:sequence> <xs:element name="return" type="xs:float"/> </xs:sequence> </xs:complexType> <xs:element name="TripPriceServiceException" type="tns:TripPriceServiceException"/> <xs:complexType name="TripPriceServiceException"> <xs:sequence/> </xs:complexType> </xs:schema> </wsdl:types> <wsdl:message name="TripPriceServiceException"> <wsdl:part name="TripPriceServiceException" element="tns:TripPriceServiceException"> </wsdl:part> </wsdl:message> <wsdl:message name="getTripPrice"> <wsdl:part name="parameters" element="tns:getTripPrice"> </wsdl:part> </wsdl:message> <wsdl:message name="getTripPriceResponse"> <wsdl:part name="parameters" element="tns:getTripPriceResponse"> </wsdl:part> </wsdl:message> <wsdl:portType name="ITripPriceServiceFacade"> <wsdl:operation name="getTripPrice"> <wsdl:input name="getTripPrice" message="tns:getTripPrice"> </wsdl:input> <wsdl:output name="getTripPriceResponse" message="tns:getTripPriceResponse"> </wsdl:output> <wsdl:fault name="TripPriceServiceException" message="tns:TripPriceServiceException"> </wsdl:fault>

13

</wsdl:operation> </wsdl:portType> <wsdl:binding name="TripPriceServiceFacadeServiceSoapBinding" type="tns:ITripPriceServiceFacade"> <soap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http"/> <wsdl:operation name="getTripPrice"> <soap:operation soapAction="" style="document"/> <wsdl:input name="getTripPrice"> <soap:body use="literal"/> </wsdl:input> <wsdl:output name="getTripPriceResponse"> <soap:body use="literal"/> </wsdl:output> <wsdl:fault name="TripPriceServiceException"> <soap:fault name="TripPriceServiceException" use="literal"/> </wsdl:fault> </wsdl:operation> </wsdl:binding> <wsdl:service name="TripPriceServiceFacadeService"> <wsdl:port name="TripPriceServiceFacadePort" binding="tns:TripPriceServiceFacadeServiceSoapBinding"> <soap:address location="http://localhost:8080/trip-price-0.0.1-SNAPSHOT/webservices/TripPriceService"/> </wsdl:port> </wsdl:service> </wsdl:definitions>

HotelProceService.wsdl

<?xml version="1.0" encoding="UTF-8"?>  <wsdl:definitions xmlns:ns1="http://cxf.apache.org/bindings/xformat" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:tns="http://external.services/hotel" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" name="HotelPriceServiceFacadeService" targetNamespace="http://external.services/hotel"> <wsdl:types> <xs:schema elementFormDefault="unqualified" targetNamespace="http://external.services/hotel" version="1.0" xmlns:tns="http://external.services/hotel" xmlns:xs="http://www.w3.org/2001/XMLSchema"> <xs:element name="getRoomPrice" type="tns:getRoomPrice"/> <xs:element name="getRoomPriceResponse" type="tns:getRoomPriceResponse"/> <xs:complexType name="getRoomPrice"> <xs:sequence/> </xs:complexType> <xs:complexType name="getRoomPriceResponse"> <xs:sequence> <xs:element name="return" type="xs:float"/> </xs:sequence> </xs:complexType> </xs:schema> </wsdl:types> <wsdl:message name="getRoomPrice"> <wsdl:part name="parameters" element="tns:getRoomPrice"> </wsdl:part> </wsdl:message> <wsdl:message name="getRoomPriceResponse"> <wsdl:part name="parameters" element="tns:getRoomPriceResponse"> </wsdl:part> </wsdl:message> <wsdl:portType name="IHotelPriceServiceFacade"> <wsdl:operation name="getRoomPrice"> <wsdl:input name="getRoomPrice" message="tns:getRoomPrice"> </wsdl:input> <wsdl:output name="getRoomPriceResponse" message="tns:getRoomPriceResponse"> </wsdl:output> </wsdl:operation> </wsdl:portType> <wsdl:binding name="HotelPriceServiceFacadeServiceSoapBinding" type="tns:IHotelPriceServiceFacade"> <soap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http"/> <wsdl:operation name="getRoomPrice"> <soap:operation soapAction="" style="document"/> <wsdl:input name="getRoomPrice"> <soap:body use="literal"/> </wsdl:input> <wsdl:output name="getRoomPriceResponse"> <soap:body use="literal"/> </wsdl:output> </wsdl:operation> </wsdl:binding> <wsdl:service name="HotelPriceServiceFacadeService"> <wsdl:port name="HotelPriceServiceFacadePort" binding="tns:HotelPriceServiceFacadeServiceSoapBinding">

14

<soap:address location="http://localhost:8088/external-services-0.0.1-SNAPSHOT/webservices/HotelPriceService"/> </wsdl:port> </wsdl:service> </wsdl:definitions>

FlightPriceService.wsdl

<?xml version="1.0" encoding="UTF-8"?>  <wsdl:definitions xmlns:ns1="http://cxf.apache.org/bindings/xformat" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:tns="http://external.services/flight" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" name="FlightPriceServiceFacadeService" targetNamespace="http://external.services/flight"> <wsdl:types> <xs:schema attributeFormDefault="unqualified" elementFormDefault="unqualified" targetNamespace="http://external.services/flight" xmlns:tns="http://external.services/flight" xmlns:xs="http://www.w3.org/2001/XMLSchema"> <xs:element name="getFlightPrice" type="tns:getFlightPrice"/> <xs:element name="getFlightPriceResponse" type="tns:getFlightPriceResponse"/> <xs:complexType name="getFlightPrice"> <xs:sequence> <xs:element minOccurs="0" name="from" type="xs:string"/> <xs:element minOccurs="0" name="to" type="xs:string"/> </xs:sequence> </xs:complexType> <xs:complexType name="getFlightPriceResponse"> <xs:sequence> <xs:element name="return" type="xs:float"/> </xs:sequence> </xs:complexType> <xs:element name="LocationNotFoundException" type="tns:LocationNotFoundException"/> <xs:complexType name="LocationNotFoundException"> <xs:sequence/> </xs:complexType> </xs:schema> </wsdl:types> <wsdl:message name="LocationNotFoundException"> <wsdl:part name="LocationNotFoundException" element="tns:LocationNotFoundException"> </wsdl:part> </wsdl:message> <wsdl:message name="getFlightPrice"> <wsdl:part name="parameters" element="tns:getFlightPrice"> </wsdl:part> </wsdl:message> <wsdl:message name="getFlightPriceResponse"> <wsdl:part name="parameters" element="tns:getFlightPriceResponse"> </wsdl:part> </wsdl:message> <wsdl:portType name="IFlightPriceServiceFacade"> <wsdl:operation name="getFlightPrice"> <wsdl:input name="getFlightPrice" message="tns:getFlightPrice"> </wsdl:input> <wsdl:output name="getFlightPriceResponse" message="tns:getFlightPriceResponse"> </wsdl:output> <wsdl:fault name="LocationNotFoundException" message="tns:LocationNotFoundException"> </wsdl:fault> </wsdl:operation> </wsdl:portType> <wsdl:binding name="FlightPriceServiceFacadeServiceSoapBinding" type="tns:IFlightPriceServiceFacade"> <soap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http"/> <wsdl:operation name="getFlightPrice"> <soap:operation soapAction="" style="document"/> <wsdl:input name="getFlightPrice"> <soap:body use="literal"/> </wsdl:input> <wsdl:output name="getFlightPriceResponse"> <soap:body use="literal"/> </wsdl:output> <wsdl:fault name="LocationNotFoundException"> <soap:fault name="LocationNotFoundException" use="literal"/> </wsdl:fault> </wsdl:operation> </wsdl:binding> <wsdl:service name="FlightPriceServiceFacadeService"> <wsdl:port name="FlightPriceServiceFacadePort" binding="tns:FlightPriceServiceFacadeServiceSoapBinding"> <soap:address location="http://localhost:8088/external-services-0.0.1-SNAPSHOT/webservices/FlightPriceService"/> </wsdl:port>

15

</wsdl:service> </wsdl:definitions>

realizzare un framework di test con soapui

Documents