Web Services

Creare webservices con Eclipse, AXIS2 e Tomcat  Rosario Turco

Se si hanno a disposizione IDE evoluti come Oracle WorkspaceStudio 1.1 o altri Oracle (OEPE), adatti a particolari application server come BEA WebLogic e a SOAP,

la realizzazione di un web services services è

realizzabile con pochissimi click, grazie soprattutto a componenti o palette selezionabili. I web services così ottenibili sono però orientati ad un particolare application server. Come fare nel caso che il nostro application server è Tomcat o JBoss o altro? In questo caso vi propongo di usare Eclipse Helios, Axis2 e Tomcat. Il procedimento se non lo sapete vi porterà a diversi naufragi naufragi e forse all’abbandono totale di tale scelta (ingiustamente). Ma non vi preoccupate che la guida vi propone tutte le

varie fasi, automatizzandole con Elicpse, anziché farle a mano. Fase 1 – Scaricate Tomcat 6.0

Scaricate e unzippate tomcat ad esempio sotto C. http://tomcat.apache.org/download-60.cgi Fase 2 - Scaricate AXis2 1.5.4

Scaricatelo e spacchettatelo in una directory sotto C http://axis.apache.org/axis2/java/core/download.cgi Fase 3 – Creiamo su Eclipse il Server Tomcat

File -> New -> Other -> Server -> Next -> Apache -> Tomcat 6.0 -> FInish Fase 4 - Creiamo un Dynamic Web Service

File -> New -> Other -> Web -> Dynamic Web Project -> Next Mettere un Project Name. Esempio HelloWorldWS Click su Modify -> check su Axis2 Web Services Click su Runtimes per controllare che sia selezionato il server Tomcat Next -> Next Lasciare il check su web.xml Finish->Yes->Selezionare in alto a destra Java e si apre a sinistra il Package Explore Fase 5 – Selezioniamo da Window le preferenze

Window->Preferences->Web Window->Preferences-> Web Services->Axis2 Preferences Selezionare Axis2 runtinme e mettere il path della AXIS2_HOME Selezionare Axis2 Preferences e selezionare “Generate an interface for the skeleton”

1

Fase 6 – Levare dai browser il proxy aziendale Anche se userete il browser interno potreste poi incappare sull’errore IWAB0135E An unexpected error has occurred. java.net.UnknownHostException Ora controlliamo dal menu Window->Web browser-> lasciamo quello internal, ma potreste impostare anche Mozilla o altro.

Fase 7 – Impostiamo le librerie per Eclipse

Selezioniamo la radice del progetto. Poi da menu Project->Properties->Java Build path->Add External Jar Qua dobbiamo aggiungere i jar delle librerie che ci possono servire e a cui fanno riferimento i sorgenti (ad esempio JDOM, etc.) Fase 8 - creiamo il software

Nella src del progetto aggiungiamo il pac kage Hello (New->Package) e il package services. Nel package Hello aggiungiamo il file HelloWS.java (New->File mettere HelloWA.java) e iniziamolo con package services: Semplice Sorgente HelloWS.java package services; import javax.jws.*; @SuppressWarnings ("deprecation" ) @WebService public class HelloWS { public String HelloWS(String name){ return ("Ciao " + name); } }

Ovviamente il metodo HelloWS poteva richiamare anche altri metodi.

Fase 9 – creiamo il Web Service

Selezioniamo il sorgente HelloWS.java col mouse e facciamo: New->Other->Web Services->Web Service->Next Adesso attenzione: cliccare su Web Service runtime: Apache Axis e selezionare Axis2 -> OK -> Next-> Lasciare selezionata la voce “Generate a default service.xml”->Next->Start server (se richiesto)->Finish

Se selezionate nella parte di sotto di Eclipse la linguetta Servers, vedrete aprendo Tomcat che è stato deployato (il server Tomcat è solo un clone di quello reale) HelloWorld. Fase 10 – Test sul Tomcat di Eclipse

Clicchiamo il triangolino verde di start del Server e da console vediamo che si è avviato ed è in attesa. Testiamo Axis2 ora (ricordate che per la console Axis2 username è admin e password è axis2, ma questo non vi servirà se seguite la guida attentamente). 2

Selezioniamo adesso la root del progetto sul Package Explorer. Tasto destro del mouse -> Run As -> Run on the server -> Next -> Osserviamo che già a destra è presente HelloWorld HelloWorld (altrimenti facciamo Add) -> Finish

Fate Validate per vedere che non da errori. Da Services vedremo due cose: i servizi deployati con l’endpoint e la porta e la WSDL se clicchiam o su

HelloWSService.

Catturate col mosue la parte http://localhost:8080/HelloWorld/services/HelloWSService Vi servirà dopo nel test.

3

Salviamo la WSDL su un file HelloWorldWS.wsdl. Serve per darla ai sistemi che chiameranno il servizio esposto o per i vostri test con SOAPUI. Fase 10 – Facciamo prima il test del Web service con Eclipse

Sempre selezionando la root del progetto, da menu scegliere Run -> Launch the Web Services Explorer Sul Web Services Explorer a destra scegliere WSDL page

Qui inserite i dati che avete nel buffer del mouse e ag goingete alla fine ?wsdl ovvero http://localhost:8080/HelloWorld/services/HelloWSService?wsdl Fate Go e a sinistra espandete tutte le info come in figura. 4

A sinistra per name inserite il vostro nome e fate Go. Nella parte dello Status dovreste ottenere “Ciao” e il

vostro nome. OK funziona. Fase 10 – Esportiamo il WAR

Da Eclipse File->Export->Web->WAR->N File->Export->Web->WAR->Next ext Scegliere il Web Project HelloWorld e col browser scegliere il desktop dove depositarlo oppure sotto la webapps di Tomcat direttamente e fare Finish. Fase 11 – Stop del server Tomcat su Eclipse

Tasto rosso. Fase 12 – configuriamo Tomcat

Andare nella bin sotto %CATALINA_HOME%/bin e a startup.cmd o a startup.sh aggiungere al CLASSPATH tutti i jar necessari. Consigliamo di aggiungere prima le variabili HOME ad esempio se ci serve JDOM, aggiungere a parte la JDOM_HOME e poi nel classpath far riferimento ai jar con %JDOM_HOME% Mettere il war nella webapps di Tomcat. Lanciate startup.cmd e aspettare che il war venga spacchettato. Fase 13 – Configuriamo AXIS2 sotto Tomcat

Se abbiamo usato altri jar, vanno tutti posti senza alcuna alberatura in: %CATALINA_HOME%\webapps\HelloWorld\WEB-INF\lib Occorre riavviare Tomcat.

5

Fase 14 – Test con SOAP UI

Con la WSDL che ci siamo salvati possiamo generare una suite di test con SOAP UI. Ok o ra avete tutte le info per proseguire da soli. Alla prox

6