WebServices in Domino...seconda parte

Nella seconda parte del nostro articolo impareremo a realizzare una WebServices in Domino ed a testare le sue funzionalità con "Web Service Explorer" del tools
WTP (Web Tools Platform) della Eclipse.org.
 
Il primo passo è quello di creare un semplicissimo Database che permette in qualche modo di dimostrare il tutto...
Pensiamo al Database Magazzino che abbia una vista di giacenze articoli decodificati.
Per semplicità di realizzazione il nostro DB avrà :

• Una Form che gestisce le giacenze con 4 campi (CODICE ARTICOLO, DESCRIZIONE ARTICOLO, PREZZO, GIACENZA)
• Una vista che visualizza le giacenze ordinate per CODICE ARTICOLO

A) Schema Elementi Designer

1. Elementi Presenti	2. Form Giacenza
IL DATABASE Può essere visualizzato al seguente questo LINK.	3. Vista Giacenze

A questo punto sarà possibile scrivere la nostra WEB Service sia importando il codice WSDL scritto nell'articolo precedente sia Generando a Mano lo script necessario
 (Io ho optato per la prima scelta per la generazione della macro-struttura...ho salvato il file come .wsdl e poi l'ho importato nel designer semplicemente premendo il bottone Import WSDL)
Qui di seguito riporto il codice  LS che ho scritto per lo stesso....



Come vedete ho dichiarato una variabile globale session che verrà utilizzata dalla mia funzione pubblica VerificaGiacenze...
La funzione è molto semplice poichè va ad interrogare la vista GIACENZE per vedere se il parametro passato come riferimento è presente in magazzino e restituisce la giacenza dello stesso....

COME  TESTARE LA WEBSERVICE?

Per testare il tutto, io utilizzo i Web Service Explorer di Eclipse davvero comodi per gestire gli I/O di una chiamata Web Service.
Come già detto nel precente articolo l'unico modo per far capire ad un client esterno quali siano i prototipi possibili è quello di interrogare
in qualche modo il documento WSDL.
Per interrogare tale documento in Domino basta utilizzare la chiave ?WSDL dopo l'url di connessione alla WebService...
Se provate a cliccare qui vi aprirà a video il documento WSDL direttamente nel vostro browser.

Aprendo la piattaforma Eclipse WTP scaricata e cliccando su:


Vi apparirà a video il "DEBUG" che permetterà di interrogare una WebService...
Cliccando sull'icona  apparirà una schermata dove potrete inserire il percorso del vostro documento WSDL


Una volta fatto questo vi appariranno a video i metodi che potrete invocare (per eseguire un metodo basta semplicemente cliccare sul nome allo stesso)




Cliccando su VerificaGiacenza ed inserendo il codice articolo viene eseguita la WEB service che controlla e restituisce la giacenza
se è presente il document...altrimenti restituisce un mex d'errore




Caso in cui viene generato un messaggio d'errore...



Con questa breve e rapida guida spero di aver tolto alcuni dubbi su questo argomento.
Ovviamente il tutto andrebbe approfondito ancora maggioramente su molti aspetti (per esempio i mex d'errore di un messaggio SOAP)
Ma comunque sia penso sia un buon inizio per comprendere e lavorare con questa funzionalità di Domino.

Buon Divertimento a tutti